Download the PHP package casivaagustin/phrequests without Composer
On this page you can find all versions of the php package casivaagustin/phrequests. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download casivaagustin/phrequests
More information about casivaagustin/phrequests
Files in casivaagustin/phrequests
Package phrequests
Short Description Curl Wrapper to make Http request easily
License MIT
Homepage https://github.com/casivaagustin/PHRequests
Informations about the package phrequests
PHRequests
PHRequests is an API to make HTTP requests using Curl.
Is pronounced Free-Quests (original Idea by @mgi1982)
Why use PHRequests ?
- Its built on Curl.
- Simplifies your live by making CURL actually usable.
- Inspired by the Requests API for Python, this pretends to be a port for PHP https://github.com/kennethreitz/requests/
Usage
If you need to make a Request to get the content of some Url using Curl a clasic code will look like this.
PHRequests wraps all this awful code to make our lives easier.
In order to make a GET Request you should do this
Yes, only that. Looks nice, take a look to a POST Request.
To make a POST you can do this
and that's all folks!
The Response object will hold the result of the request. Also it has a lot of important data of the request.
- $response->content : The Content of the Request
- $response->headers : The Response Headers
- $response->status_code : The Response Code
And more.
PHRequests uses the PSR-0 standard for class autoloading so you will need a compatible defined autoload function to start using by itself (versus inside a compatible framework like Symfony). You can find one such a function in the Tests\bootstrap.php file.
To see more samples, check the tests (until I write more documentation).
Proxy Support
If your are behind a proxy you need to define the Url of the proxy in order to make the Request. Here is an example.
If your proxy uses auth, try with this
HTTPS support
In order to make HTTPs Requests against a valid HTTPs Server. You need download and save the Certificate of the site, save it into a reachable folder. After, you need to define the option ssl_ca with the full path to the certificate in order to setup PHRequest. Here is an example.
If you don't set the PEM certificate, the HTTPs request will be made anyway but without a proper certificate validation, the connection will be still an SSL connection but can be a security issue accept any certificate without validation.
IMPORTANT : The certificate must be a PEM certificate.
Here you have more detailed explanation about HTTPs with curl.
http://unitstep.net/blog/2009/05/05/using-curl-in-php-to-access-https-ssltls-protected-sites/
Save Remote Files Locally
To get a remote file and save it locally you can do the following.
The file located in $urlSource, will be saved in $pathDest, using $options.
The request will be made with GET method.
IMPORTANT : The BAD usage of this feature can create security problems, please keep that in mind and be careful.
Supported methods.
- GET
- POST
- PUT
- DELETE
- HEAD
- OPTIONS
Todo
- Session Supports
- Cookies Supports
- Auth Mecanism
How to run the tests
First install phpunit, i'm using PHPUnit 4.7.3 and I have installed using the phar file.
Go to the test folder, and just run
That will run all the tests.
I'm having troubles to write a good public tests to test the proxies functionality, need an open and public proxy to validate that works, that's why that test is disabled.
If you are going to work in the proxy features, please, set a proxy, enable the test and test it before commit.
Support
If you want a special feature or if you find a bug, please, let me know.
If you want to contribute to the project, also, please let me know :).