SendCustomRequest Method
Sends a custom request to the server.
Object Oriented Interface
public function doSendCustomRequest($httpmethod, $objectname, $requestbody);
Procedural Interface
ipworkscloud_googlestorage_do_sendcustomrequest($res, $httpmethod, $objectname, $requestbody);
Remarks
This method can be used to send arbitrary requests to the server.
Valid values for HttpMethod are:
- GET (default if empty)
- HEAD
- POST
- PUT
- DELETE
The ObjectName and RequestBody parameters may be empty if not needed.
Usage
When this method is called, the class does the following:
- Builds a request URL, including query parameters, based on the following:
- UseSSL, Region, and UseVirtualHosting for the base URL.
- Alternatively, if a custom URL has been specified using the URL configuration setting, it is used directly, and these properties are ignored.
- Bucket (if non-empty)
- ObjectName (if non-empty)
- VersionId (if both it and ObjectName are non-empty)
- QueryParam*
- UseSSL, Region, and UseVirtualHosting for the base URL.
- Adds request headers from:
- Signs the request (unless the SignCustomRequest configuration setting is disabled).
- Sends the request, including RequestBody if non-empty.
- Stores the response headers in the ParsedHeader* properties; and the response body in the specified LocalFile, or ObjectData (using the same logic as GetObject).
If the response body is XML data, the XPath, XText, and other X* configuration settings can then be used to navigate and extract information from it.