Recommended installation method: composer install/require. See below.
require tornevall/tornevall/tornelib-php-netcurl:^6.1
require tornevall/tornevall/tornelib-php-network:^6.1
Depending on your needs, you can start with nothing in your hands. Curl is the primary handle that has many more features than the other drivers. It is however actually not required. A proper installation in Ubuntu however may look like this:
apt-get install php-curl php-xml php-json php-soap
- XML is not required unless you want SOAP and so on.
- SSL: OpenSSL or similar (if doing https requests).
- SOAP: SoapClient and XML-drivers (if doing https requests).
- CURL (if you prefer curl before streams).
- allow_url_fopen (if you have no access to curl, this has to be enabled).
Source code can be found at bitbucket repository, to make upgrading more stable. It is mirrored to github but new releases and tags are submitted (when ready) to github to maintain maximum stability (do we trust bitbucket? yes - our own server).
Documentation for v6.1 is located here. There's a Mailinglist put up for everything concerning netcurl. That's also where you can find release information (for now). You can subscribe to the list here. Feel free to join the project from JIRA. And don't be afraid of leaving feedback!
Installing the network module instead will make features such as getGitTagsByUrl fully available.
This library do support PHP 5.6 (not lower). However, you should check here to ensure your compatiblity yourself).
NetCURL is tested within a few different suites. Due to the lack of "test time", tests are not entirely fulfilled in the Bitbucket cloud, which is why tests also are executed from other places on commits. Below is a list of those instances.
The Bamboo-server has a history which makes many older PHP versions available. But as of mid-summer 2020, all tests with old versions have been removed. This is also a work that continues. Github tests are only running with non-outdated versions (exception for 5.6) and so are bitbucked targeted. Since bamboo is the flagship of tests, old versions are currently not removed there.
In its initial state, there are basically no requirements as this module tries to pick the best available driver in runtime.
When using composer to install netcurl, also add the following to composer by for example this:
composer require laminas/laminas-feed
If you prefer to use laminas http driver, you should also install it with laminas/laminas-http:
composer require laminas/laminas-http
It is however not necessary with that driver, since netcurl will fall back to its own drivers if laminas is missing that driver. You should also know that if you use laminas-http it runs on pretty much defaults and therefore probably also uses Laminas\Http\Client as User-Agent. You can request RSS feeds without laminas, however you're kind of on your own by doing this. In that case, you'll get the entries in SimpleXML formatting.
- curl
- The simplest form of streamdriver and the binary safe file_get_contents (instead of the fopen-drivers that is based on the same system).
- SoapClient
- RSS feeds
Not yet. This driver requires more, so this is put on hold.
No. Version 6.1 is written to reach compatibility with v6.0, but with modernized code and PSR-4. However, do not use MODULE_CURL. Make sure you check out https://docs.tornevall.net/x/DoBPAw before deciding to run anything as older PHP-releases could be incompatible. However, if they are, so are probably you.