tuupola/http-factory

Lightweight autodiscovering PSR-17 HTTP factories

1.4.0 2021-09-14 12:46 UTC

Requires

• php: ^7.1|^8.0
• psr/http-factory: ^1.0

Requires (Dev)

• http-interop/http-factory-tests: ^0.9.0
• overtrue/phplint: ^3.0
• phpunit/phpunit: ^7.0|^8.0|^9.0
• squizlabs/php_codesniffer: ^3.0

Provides

• psr/http-factory-implementation: ^1.0

Conflicts

• nyholm/psr7: <1.0

MIT

• Mika Tuupola

• http
• psr-7
• psr-17

README

Install

Install the library using Composer.

$ composer require tuupola/http-factory

Usage

Let's assume you have Diactoros installed.

$ composer require zendframework/zend-diactoros

The factories will now automatically return Diactoros PSR-7 instances.

use Tuupola\Http\Factory\RequestFactory;

$request = (new RequestFactory)->createRequest("GET", "https://example.com/");
print get_class($request); /* Zend\Diactoros\Request */

On the other hand if you have Slim frameworks installed.

$ composer remove zendframework/zend-diactoros
$ composer require slim/slim

The factories will now return Slim PSR-7 instances.

use Tuupola\Http\Factory\RequestFactory;

$request = (new RequestFactory)->createRequest("GET", "https://example.com/");
print get_class($request); /* Slim\Http\Request */

This library currently automatically detects and supports laminas/laminas-diactoros, zendframework/zend-diactoros, slim/slim, slim/psr7, nyholm/psr7 and guzzle/psr7 PSR-7 implementations.

Testing

You can run tests either manually or automatically on every code change. Automatic tests require entr to work.

$ make test

$ brew install entr
$ make watch

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.