Recommend this page to a friend! |
Classes of Subin Siby | Lobby | includes/src/vendor/rmccue/requests/README.md | Download |
|
DownloadRequests for PHPRequests is a HTTP library written in PHP, for human beings. It is roughly based on the API from the excellent Requests Python library. Requests is ISC Licensed (similar to the new BSD license) and has no dependencies, except for PHP 5.2+. Despite PHP's use as a language for the web, its tools for sending HTTP requests are severely lacking. cURL has an interesting API, to say the least, and you can't always rely on it being available. Sockets provide only low level access, and require you to build most of the HTTP response parsing yourself. We all have better things to do. That's why Requests was born.
Requests allows you to send HEAD, GET, POST, PUT, DELETE, and PATCH HTTP requests. You can add headers, form data, multipart files, and parameters with simple arrays, and access the response data in the same way. Requests uses cURL and fsockopen, depending on what your system has available, but abstracts all the nasty stuff out of your way, providing a consistent API. Features
InstallationInstall with ComposerIf you're using Composer to manage dependencies, you can add Requests with it.
or
Install source from GitHubTo install the source code:
And include it in your scripts:
You'll probably also want to register an autoloader:
Install source from zip/tarballAlternatively, you can fetch a [tarball][] or [zipball][]:
[tarball]: https://github.com/rmccue/Requests/tarball/master [zipball]: https://github.com/rmccue/Requests/zipball/master Using a Class LoaderIf you're using a class loader (e.g., [Symfony Class Loader][]) for [PSR-0][]-style class loading:
[Symfony Class Loader]: https://github.com/symfony/ClassLoader [PSR-0]: https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md DocumentationThe best place to start is our [prose-based documentation][], which will guide you through using Requests. After that, take a look at [the documentation for
Requests is 100% documented with PHPDoc. If you find any problems with it, create a new issue! [prose-based documentation]: https://github.com/rmccue/Requests/blob/master/docs/README.md [request_method]: http://requests.ryanmccue.info/api/class-Requests.html#_request TestingRequests strives to have 100% code-coverage of the library with an extensive set of tests. We're not quite there yet, but [we're getting close][codecov]. [codecov]: http://codecov.io/github/rmccue/Requests To run the test suite, first check that you have the PHP JSON extension enabled. Then simply:
If you'd like to run a single set of tests, specify just the name:
Contribute
[the repository]: https://github.com/rmccue/Requests |