hamlet-framework / http-message-spec
Hamlet Framework / HTTP / Message / Spec
Installs: 8 428
Dependents: 2
Suggesters: 0
Security: 0
Stars: 5
Watchers: 2
Forks: 0
Open Issues: 1
Type:framework
Requires
- php: ^8.3
- psr/http-message: @stable
Requires (Dev)
- guzzlehttp/psr7: @stable
- hamlet-framework/http-message: @stable
- httpsoft/http-message: @stable
- laminas/laminas-diactoros: @stable
- nyholm/psr7: @stable
- phpbenchmark/phpbenchmark: @stable
- phpunit/phpunit: @stable
- ringcentral/psr7: @stable
README
Hamlet Framework / HTTP / Message / Specification
Test case collection for PSR-7.
How to use
"require-dev": {
...
"hamlet-framework/http-message-spec": "@stable",
...
}
If you'd like to test your implementation of Psr\Http\Message\RequestInterface
create a test case and import the following three traits:
class MyRequestTest extends TestCase
{
use DataProviderTrait;
use MessageTestTrait;
use RequestTestTrait;
...
}
After that you'll have to implement 4 abstract factory methods returning your implementations of PSR-7 interfaces:
class MyRequestTest extends TestCase
{
...
protected function request(): RequestInterface
{
return new MyRequest('GET', new Uri());
}
protected function message(): MessageInterface
{
return $this->request();
}
protected function stream(): StreamInterface
{
return MyStream();
}
protected function uri(string $value): UriInterface
{
return new MyUri($value);
}
You can now run your tests.
Benchmark results (PHP 8.3):
Comprehensive test
+----------------------+--------------------+-------------------+--------------+
| Function description | Execution time (s) | Memory usage (mb) | Times faster |
+----------------------+--------------------+-------------------+--------------+
| ring-central | 1.1089 | 0.1770 | 13% |
| nyholm | 1.2584 | 0.0870 | 20% |
| http-soft | 1.5183 | 0.1210 | 5% |
| guzzle | 1.6034 | 0.2050 | 18% |
| hamlet-framework | 1.8983 | 0.1700 | 51% |
| zend-diactoros | 2.8708 | 0.1730 | 8% |
| wind-walker | 3.1030 | 0.5210 | 0 |
+----------------------+--------------------+-------------------+--------------+
Fetching test
+----------------------+--------------------+-------------------+--------------+
| Function description | Execution time (s) | Memory usage (mb) | Times faster |
+----------------------+--------------------+-------------------+--------------+
| hamlet-framework | 0.5370 | 0.0000 | 13% |
| ring-central | 0.6111 | 0.0010 | 12% |
| guzzle | 0.6852 | 0.0000 | 8% |
| nyholm | 0.7433 | 0.0000 | 18% |
| http-soft | 0.8771 | 0.0000 | 33% |
| zend-diactoros | 1.1698 | 0.0000 | 32% |
| wind-walker | 1.5468 | 0.0000 | 0 |
+----------------------+--------------------+-------------------+--------------+
Total number of test failures (PHP 8.3):
+-----------------+-------+
| Hamlet | 0 |
| Nyholm | 108 |
| RingCentral | 109 |
| Guzzle | 111 |
| HttpSoft | 124 |
| LaminasDiactoros | 140 |
+-----------------+-------+
Todo
- Add generic test for immutability trait
- Add more tests to URI from other projects
- Add tests from https://mathiasbynens.be/demo/url-regex
- Add tests from https://url.spec.whatwg.org/#parsing
- Add test for withUploadedFiles (the test cases are a bit thin at the moment)