GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::HTTPS::ANY (3)

.ds Aq ’

NAME

Net::HTTPS::Any - Simple HTTPS class using whichever underlying SSL module is available

CONTENTS

SYNOPSIS



  use Net::HTTPS::Any qw(https_get https_post);
 
  ( $page, $response, %reply_headers )
      = https_get(
                   { host => www.fortify.net,
                     port => 443,
                     path => /sslcheck.html,
                   },
                 );

  ( $page, $response, %reply_headers )
      = https_post(
                    host => www.google.com,
                    port => 443,
                    path => /accounts/ServiceLoginAuth,
                    args => { field => value },
                    #args => [ field=>value ], #order preserved
                  );
 
  #...



DESCRIPTION

This is a simple wrapper around either of the two available SSL modules. It offers a unified API for sending GET and POST requests over HTTPS and receiving responses.

It depends on Net::SSLeay _or_ ( Crypt::SSLeay and LWP::UserAgent ).

WHY THIS MODULE

If you just want to write something that speaks HTTPS, you don’t need this module. Just go ahead and use whichever of the two modules is good for you. Don’t worry about it.

On the other hand, if you are a CPAN author or distribute a Perl application, especially if you aim to support multiple OSes/disributions, using this module for speaking HTTPS may make things easier on your users. It allows your code to be used with either SSL implementation.

FUNCTIONS

    https_get HASHREF | FIELD => VALUE, ...

Accepts parameters as either a hashref or a list of fields and values.

Parameters are:
host
port
path
headers (hashref) For example: { ’X-Header1’ => ’value’, ... }
args CGI arguments, eitehr as a hashref or a listref. In the latter case, ordering is preserved (see Tie::IxHash to do so when passing a hashref).
debug Set true to enable debugging.
Returns a list consisting of the page content as a string, the HTTP response code and message (i.e. 200 OK or 404 Not Found), and a list of key/value pairs representing the HTTP response headers.

    https_post HASHREF | FIELD => VALUE, ...

Accepts parameters as either a hashref or a list of fields and values.

Parameters are:
host
port
path
headers (hashref) For example: { ’X-Header1’ => ’value’, ... }
Content-Type Defaults to application/x-www-form-urlencoded if not specified.
args CGI arguments, eitehr as a hashref or a listref. In the latter case, ordering is preserved (see Tie::IxHash to do so when passing a hashref).
content Raw content (overrides args). A simple scalar containing the raw content.
debug Set true to enable debugging in the underlying SSL module.
Returns a list consisting of the page content as a string, the HTTP response code and message (i.e. 200 OK or 404 Not Found), and a list of key/value pairs representing the HTTP response headers.

AUTHOR

Ivan Kohler, <ivan-net-https-any at freeside.biz>

BUGS

Please report any bugs or feature requests to bug-net-https-any at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-HTTPS-Any>. I will be notified, and then you’ll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.



    perldoc Net::HTTPS::Any



You can also look for information at:
o RT: CPAN’s request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-HTTPS-Any>

o AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/Net-HTTPS-Any>

o CPAN Ratings

<http://cpanratings.perl.org/d/Net-HTTPS-Any>

o Search CPAN

<http://search.cpan.org/dist/Net-HTTPS-Any>

COPYRIGHT & LICENSE

Copyright 2008-2010 Freeside Internet Services, Inc. (http://freeside.biz/) All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::HTTPS::ANY (3) 2010-05-01

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.