tornevall/tornelib-php-netcurl

Yet another Curl Library to handling web calls

Maintainers

Package info

github.com/Tornevall/tornelib-php-netcurl

pkg:composer/tornevall/tornelib-php-netcurl

Transparency log

Statistics

Installs: 66 681

Dependents: 6

Suggesters: 0

Stars: 0

Open Issues: 13

Security

Advisories: 0

Aikido package health analysis

6.1.10 2026-04-09 13:11 UTC

Requires

Apache-2.0 b253f303ed3e3b0d0f44c118587dd5f689f1adf2

Published on Packagist.org on 2026-04-09 13:30 UTC

This package is auto-updated.

Last update: 2026-08-20 16:48:05 UTC

README

NetCurl is a transport-flexible PHP communication library. Its core purpose is to let callers make a request without hard-coding whether cURL, PHP streams, SOAP, RSS/XML, or a registered custom driver must perform it.

Installation

Recommended standalone installation:

composer require tornevall/tornelib-php-netcurl:^6.1

If you also need the separate network/domain/address utility package:

composer require tornevall/tornelib-php-network:^6.1

Documentation

The maintained public documentation now lives in Tornevall Tools:

The guide contains practical examples for normal requests, JSON/XML, SOAP/WSDL, RSS/XML, raw/parsed responses, headers, authentication, proxies, timeouts, multi-request handling, custom drivers, and migration away from MODULE_CURL.

Implementation history, defects and version planning are tracked in GitHub:

Old Confluence documentation is no longer the maintained documentation target.

cURL, streams, SOAP and XML

cURL is the preferred general HTTP driver when available, but it is not supposed to be a hard requirement for generic requests. NetCurl is designed to select the best usable driver at runtime.

A typical installation may include:

apt-get install php-curl php-xml php-soap

Relevant runtime capabilities:

  • cURL: preferred general HTTP transport when available.
  • PHP streams / allow_url_fopen: fallback path for compatible HTTP requests when cURL is unavailable.
  • SOAP: SoapClient for WSDL/SOAP requests when available.
  • XML: used for XML/SOAP-related parsing and fallback paths.
  • RSS/XML: supported through the RSS wrapper and parsing layer.
  • External drivers: applications can register implementations of the wrapper interface and choose whether they run before or after built-in drivers.

See the Tools documentation for examples and exact behavior.

Compatibility

The old PHP 5.6 support claim is no longer valid for the current 6.1 source tree.

Runtime compatibility is verified by the maintained GitHub Actions compatibility matrix. Historical Bamboo and Bitbucket runs can still be useful when investigating old releases, but they must not be treated as the current compatibility reference.

Compatibility work and legacy probes are tracked in:

Current built-in driver support

  • cURL
  • PHP stream/file-get-contents transport
  • SoapClient
  • RSS/XML
  • externally registered custom drivers

Sockets are not currently a built-in NetCurl transport.

RSS dependencies

For richer RSS feed support, install Laminas Feed:

composer require laminas/laminas-feed

NetCurl keeps fallback behavior for RSS/XML so optional feed libraries do not automatically become hard requirements.

MODULE_CURL

MODULE_CURL is a legacy compatibility facade retained in 6.1 for older clients. New 6.1 code should prefer TorneLIB\Module\Network\NetWrapper.

MODULE_CURL is deprecated in 6.1 and planned for removal in 6.2. Compatibility work is deliberately preserving the useful request/driver/input/output behavior rather than preserving the old class forever.

See:

Changelog policy

From the current maintenance work onward, changelog entries for features, fixes and compatibility changes link to their GitHub issue/ticket. Historical changelog entries are kept as historical records and are not assigned guessed ticket references.

See CHANGELOG.md.