.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" ======================================================================== .\" .IX Title "Net::HTTPS::Any 3pm" .TH Net::HTTPS::Any 3pm "2016-09-30" "perl v5.24.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Net::HTTPS::Any \- Simple HTTPS client .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& use Net::HTTPS::Any qw(https_get https_post); \& \& ( $page, $response, %reply_headers ) \& = https_get( \& { \*(Aqhost\*(Aq => \*(Aqwww.fortify.net\*(Aq, \& \*(Aqport\*(Aq => 443, \& \*(Aqpath\*(Aq => \*(Aq/sslcheck.html\*(Aq, \& \*(Aqargs\*(Aq => { \*(Aqfield\*(Aq => \*(Aqvalue\*(Aq }, \& #\*(Aqargs\*(Aq => [ \*(Aqfield\*(Aq=>\*(Aqvalue\*(Aq ], #order preserved \& }, \& ); \& \& ( $page, $response, %reply_headers ) \& = https_post( \& \*(Aqhost\*(Aq => \*(Aqwww.google.com\*(Aq, \& \*(Aqport\*(Aq => 443, \& \*(Aqpath\*(Aq => \*(Aq/accounts/ServiceLoginAuth\*(Aq, \& \*(Aqargs\*(Aq => { \*(Aqfield\*(Aq => \*(Aqvalue\*(Aq }, \& #\*(Aqargs\*(Aq => [ \*(Aqfield\*(Aq=>\*(Aqvalue\*(Aq ], #order preserved \& ); \& \& #... .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This is a wrapper around Net::SSLeay providing a simple interface for the use of Business::OnlinePayment. .PP It used to allow switching between Net::SSLeay and Crypt::SSLeay implementations, but that was obsoleted. If you need to do that, use \s-1LWP\s0 instead. You can set \f(CW$Net::HTTPS::SSL_SOCKET_CLASS\fR = \*(L"Net::SSL\*(R" for Crypt::SSLeay instead of the default Net::SSLeay (since 6.02). .SH "FUNCTIONS" .IX Header "FUNCTIONS" .SS "https_get \s-1HASHREF\s0 | \s-1FIELD\s0 => \s-1VALUE, ...\s0" .IX Subsection "https_get HASHREF | FIELD => VALUE, ..." Accepts parameters as either a hashref or a list of fields and values. .PP Parameters are: .IP "host" 4 .IX Item "host" .PD 0 .IP "port" 4 .IX Item "port" .IP "path" 4 .IX Item "path" .IP "headers (hashref)" 4 .IX Item "headers (hashref)" .PD For example: { 'X\-Header1' => 'value', ... } .IP "args" 4 .IX Item "args" \&\s-1CGI\s0 arguments, either as a hashref or a listref. In the latter case, ordering is preserved (see Tie::IxHash to do so when passing a hashref). .IP "debug" 4 .IX Item "debug" Set true to enable debugging. .PP Returns a list consisting of the page content as a string, the \s-1HTTP\s0 response code and message (i.e. \*(L"200 \s-1OK\*(R"\s0 or \*(L"404 Not Found\*(R"), and a list of key/value pairs representing the \s-1HTTP\s0 response headers. .SS "https_post \s-1HASHREF\s0 | \s-1FIELD\s0 => \s-1VALUE, ...\s0" .IX Subsection "https_post HASHREF | FIELD => VALUE, ..." Accepts parameters as either a hashref or a list of fields and values. .PP Parameters are: .IP "host" 4 .IX Item "host" .PD 0 .IP "port" 4 .IX Item "port" .IP "path" 4 .IX Item "path" .IP "headers (hashref)" 4 .IX Item "headers (hashref)" .PD For example: { 'X\-Header1' => 'value', ... } .IP "Content-Type" 4 .IX Item "Content-Type" Defaults to \*(L"application/x\-www\-form\-urlencoded\*(R" if not specified. .IP "args" 4 .IX Item "args" \&\s-1CGI\s0 arguments, either as a hashref or a listref. In the latter case, ordering is preserved (see Tie::IxHash to do so when passing a hashref). .IP "content" 4 .IX Item "content" Raw content (overrides args). A simple scalar containing the raw content. .IP "debug" 4 .IX Item "debug" Set true to enable debugging in the underlying \s-1SSL\s0 module. .PP Returns a list consisting of the page content as a string, the \s-1HTTP\s0 response code and message (i.e. \*(L"200 \s-1OK\*(R"\s0 or \*(L"404 Not Found\*(R"), and a list of key/value pairs representing the \s-1HTTP\s0 response headers. .SH "AUTHOR" .IX Header "AUTHOR" Ivan Kohler, \f(CW\*(C`\*(C'\fR .SH "BUGS" .IX Header "BUGS" Please report any bugs or feature requests to \f(CW\*(C`bug\-net\-https\-any at rt.cpan.org\*(C'\fR, or through the web interface at . I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. .SH "SUPPORT" .IX Header "SUPPORT" You can find documentation for this module with the perldoc command. .PP .Vb 1 \& perldoc Net::HTTPS::Any .Ve .PP You can also look for information at: .IP "\(bu" 4 \&\s-1RT: CPAN\s0's request tracker .Sp .IP "\(bu" 4 AnnoCPAN: Annotated \s-1CPAN\s0 documentation .Sp .IP "\(bu" 4 \&\s-1CPAN\s0 Ratings .Sp .IP "\(bu" 4 Search \s-1CPAN\s0 .Sp .SH "COPYRIGHT & LICENSE" .IX Header "COPYRIGHT & LICENSE" Copyright 2008\-2016 Freeside Internet Services, Inc. (http://freeside.biz/) All rights reserved. .PP This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.