Perl in a Nutshell, 2nd Edition

Name

OpenRequest

Synopsis

$http->OpenRequest(requestobject, [path, method, version, 
referer, accept, flags, context])
$http->OpenRequest($requestobject, hashref)

Opens an HTTP request and saves it as $ requestobject. Returns undef on error, or a number if the connection was successful. You can then use one of the AddHeader, SendRequest, QueryInfo, QueryDataAvailable, and ReadFile methods on the newly created requestobject. The optional parameters and their values are:

path

The object to request. This is generally a filename, an executable module, etc. The default is /.

method

The method to use, which can be GET, POST, HEAD, or PUT. Default is GET.

version

The HTTP version. Default is HTTP/1.0.

referer

The URL of the document from which the URL in the request was obtained.

accept

The content types accepted. They must be separated by a \0 (ASCII zero). Default types are text/* image/gif image/jpeg.

flags

Additional flags affecting the behavior of the function.

context

A number to identify this operation if it is asynchronous. See SetStatusCallback and GetStatusCallback for more information on asynchronous operations.

A reference to a hash containing the previous list of parameters can also be supplied to this method:

%hash=(
  "path"        => "path",
  "method"      => "method",
  "version"     => "version",
  "referer"     => "referer",
  "accept"      => "accept",
  "flags"       => flags,
  "context"     => context,
);