HTTP Factories (PSR-17)

Phalcon\Http\Message\RequestFactory, , Phalcon\Http\Message\ServerRequestFactory, , Phalcon\Http\Message\UploadedFileFactory, are the factories implemented of the PSR-17 HTTP messaging interface factories as defined by .

These components aid in creating HTTP objects as defined by the PSR-7 standard.

RequestFactory

The Phalcon\Http\Message\RequestFactory can be used to create objects.

The Phalcon\Http\Message\ResponseFactory can be used to create objects.

<?php
use Phalcon\Http\Message\ResponseFactory;
$factory = new ResponseFactory();
$stream = $factory->createResponse(200, 'OK');

The createResponse() method accepts an integer which is the response status as well as a string, representing the reason phrase. If no reason is specified, the component will use the default ones as suggested by the HTTP RFCs.

ServerRequestFactory

The can be used to create Phalcon\Http\Message\ServerRequest objects.

The createServerRequest() creates the new object using a method (GET, POST etc.), a URI and optionally an array of SAPI parameters with which to seed the generated request instance.

<?php
$factory = new ServerRequestFactory();
$request = $factory->load(
    $_SERVER,
    $_GET,
    $_POST,
    $_COOKIE,
    $_FILES
);

If If any argument is not supplied, the corresponding superglobal will be used.

The can be used to create Phalcon\Http\Message\Stream objects.

UploadedFileFactory

The Phalcon\Http\Message\UploadedFileFactory can be used to create objects.

<?php
use Phalcon\Http\Message\StreamFactory;
use Phalcon\Http\Message\UploadedFileFactory;
$factory = new UploadedFileFactory();
$streamFactory = new StreamFactory();
$stream = $streamFactory->createStream('stream contents');
$size            = 12345;
$error           = 0;
$clientFilename  = null;
$clientMediaType = null;
$file = $factory->createUploadedFile(
    $stream,
    $size,
    $error,
    $clientFilename,
);

If a size is not provided it will be determined by checking the size of the stream. The $error is the PHP file upload error, It defaults to 0. If provided by the client, you can use the clientFilename and . Otherwise they can be set to null.