gandung / http-message
PSR-7 HTTP Message Implementation in PHP
v1.0.0
2018-02-03 16:22 UTC
Requires
- psr/http-message: ^1.0
- squizlabs/php_codesniffer: ^3.1
Requires (Dev)
- phpunit/phpunit: ^5.7.16 || ^6.0.8
Provides
This package is auto-updated.
Last update: 2024-10-19 18:35:43 UTC
README
This is PSR-7 HTTP message implementation in PHP.
Response
Initiate a response
With string as body parameter
use Gandung\Psr7\Response;
$content = 'this is a text.';
$response = new Response($content, 200, ['Content-Type' => 'text/plain']);
echo sprintf("%s\n", $response);
With object which implements Psr\Http\Message\StreamInterface
use Gandung\Psr7\PhpTempStream;
use Gandung\Psr7\Response;
$content = 'this is a text.';
$stream = new PhpTempStream;
$stream->write($content);
$response = new Response($stream, 200, ['Content-Type' => 'text/plain']);
echo sprintf("%s\n", $response);
With local (fopen() like function) or remote (fsockopen() like function) stream resource
use Gandung\Psr7\Response;
$handler = fopen('php://temp', 'r+b');
fseek($handler, 0);
fwrite($handler, 'this is a text.');
$response = new Response($handler, 200, ['Content-Type' => 'text/plain']);
echo sprintf("%s\n", $response);
Redirect Response
Initiating HTTP redirect response
With URI string
use Gandung\Psr7\Response\RedirectResponse;
$response = new RedirectResponse('http://example.com/a/b/c?api_version=1.0');
With URI object
use Gandung\Psr7\Uri;
use Gandung\Psr7\Response\RedirectResponse;
$uri = (new Uri())
->withScheme('http')
->withHost('example.com')
->withPath('/a/b/c')
->withQuery('api_version=1.0');
$response = new RedirectResponse($uri);
Empty Response
Initiating HTTP empty response
use Gandung\Psr7\Response\EmptyResponse;
$response = new EmptyResponse;
Request
Initiating a request
With URI string
use Gandung\Psr7\Request;
$request = new Request('GET', 'http://example.com/a/b/c?api_version=1.0');
With URI object
use Gandung\Psr7\Request;
use Gandung\Psr7\Uri;
$uri = (new Uri())
->withScheme('http')
->withHost('example.com')
->withPath('/a/b/c')
->withQuery('api_version=1.0');
$request = new Request('GET', $uri);
Stream
File stream
use Gandung\Psr7\FileStream;
$stream = new FileStream('your-file', 'r');
php://input
stream
use Gandung\Psr7\PhpInputStream;
$stream = new PhpInputStream;
php://temp
stream
use Gandung\Psr7\PhpTempStream;
$stream = new PhpTempStream;
$stream->write('this is a text.');
echo sprintf("%s\n", (string)$stream);
Common Stream
use Gandung\Psr7\Stream;
$handler = fopen('your-file', 'r');
fseek($handler, 0);
fwrite($handler, 'this is a text.');
$stream = new Stream($handler);
echo sprintf("%s\n", (string)$stream);
URI
With whole constructed URI (RFC 3986)
use Gandung\Psr7\Uri;
$uri = new Uri('http://user:password@example.com:13123/a/b/c?foo=bar#fragment');
echo sprintf("%s\n", $uri);
With separated URI components immutably
use Gandung\Psr7\Uri;
$uri = (new Uri())
->withScheme('http')
->withUserInfo('user', 'password')
->withHost('example.com')
->withPort(13123)
->withPath('/a/b/c')
->withQuery('foo=bar')
->withFragment('fragment');
echo sprintf("%s\n", $uri);
File Upload
This works in SAPI and non-SAPI PHP environment
use Gandung\Psr7\UploadedFile;
$uploadedFile = new UploadedFile(
'source-file',
'destination-file',
\UPLOAD_ERR_OK
);
Server Request
Only with URI
use Gandung\Psr7\ServerRequest;
$uri = (new Uri())
->withScheme('http')
->withHost('example.com')
->withPath('/a/b/c')
->withQuery('foo=bar');
$request = new ServerRequest($uri);
From PHP superglobal variables
use Gandung\Psr7\ServerRequestFactory;
$request = ServerRequestFactory::createFromGlobals();