fyre/server

A HTTP server request/response library.

v2.0.5 2024-04-30 06:26 UTC

Requires

• fyre/cookie: ^3.0
• fyre/filesystem: ^2.0
• fyre/negotiate: ^2.0
• fyre/request: ^3.0
• fyre/response: ^3.0
• fyre/useragent: ^2.0

Requires (Dev)

• fyre/datetime: ^2.0
• phpunit/phpunit: ^10

MIT

• elusivecodes

README

FyreServer is a free, open-source immutable HTTP server request/response library for PHP.

Table Of Contents

• Installation
• Server Requests
• Client Responses
• Download Responses
• Redirect Responses
• Uploaded Files

Installation

Using Composer

composer require fyre/server

In PHP:

use Fyre\Server\ClientResponse;
use Fyre\Server\DownloadResponse;
use Fyre\Server\RedirectResponse;
use Fyre\Server\ServerRequest;

Server Requests

This class extends the Request class.

• $options is an array containing configuration options.
  • baseUri is a string representing the base URI to use.
  • method is a string representing the request method, and will default to the server request method.
  • body is a string representing the request body, and will default to the value of php://input.
  • headers is an array containing headers to set, and will default to the server headers.
  • defaultLocale is a string representing the default locale, and will default to the system default.
  • supportedLocales is an array containing the supported locales.
  • protocolVersion is a string representing the protocol version, and will default to "1.1".

$request = new ServerRequest($options);

Get Cookie

Get a value from the $_COOKIE array.

• $key is a string representing the array key using "dot" notation.
• $filter is a number representing the filter to apply, and will default to FILTER_DEFAULT.
• $options is a number or array containing flags to use when filtering, and will default to 0.

$value = $request->getCookie($key, $filter, $options);

If the $key argument is omitted, this method will return an array containing all values.

$values = $request->getCookie();

Get Default Locale

Get the default locale.

$defaultLocale = $request->getDefaultLocale();

Get Environment

Get a value from the $_ENV array.

• $key is a string representing the array key.
• $filter is a number representing the filter to apply, and will default to FILTER_DEFAULT.
• $options is a number or array containing flags to use when filtering, and will default to 0.

$value = $request->getEnv($key, $filter, $options);

Get File

Get an UploadedFile or array of files from the $_FILE array.

• $key is a string representing the array key using "dot" notation.

$file = $request->getFile($key);

If the $key argument is omitted, this method will return an array containing all files.

$files = $request->getFile();

Get Get

Get a value from the $_GET array.

• $key is a string representing the array key using "dot" notation.
• $filter is a number representing the filter to apply, and will default to FILTER_DEFAULT.
• $options is a number or array containing flags to use when filtering, and will default to 0.

$value = $request->getGet($key, $filter, $options);

If the $key argument is omitted, this method will return an array containing all values.

$values = $request->getGet();

Get Locale

Get the current locale.

$locale = $request->getLocale();

Get Post

Get a value from the $_POST array.

• $key is a string representing the array key using "dot" notation.
• $filter is a number representing the filter to apply, and will default to FILTER_DEFAULT.
• $options is a number or array containing flags to use when filtering, and will default to 0.

$value = $request->getPost($key, $filter, $options);

If the $key argument is omitted, this method will return an array containing all values.

$values = $request->getPost();

Get Server

Get a value from the $_SERVER array.

• $key is a string representing the array key.
• $filter is a number representing the filter to apply, and will default to FILTER_DEFAULT.
• $options is a number or array containing flags to use when filtering, and will default to 0.

$value = $request->getServer($key, $filter, $options);

If the $key argument is omitted, this method will return an array containing all values.

$values = $request->getServer();

Get User Agent

Get the user agent.

$userAgent = $request->getUserAgent();

This method will return a UserAgent.

Is AJAX

Determine if the request was made using AJAX.

$isAjax = $request->isAjax();

Is CLI

Determine if the request was made from the CLI.

$isCli = $request->isCli();

Is Secure

Determine if the request is using HTTPS.

$isSecure = $request->isSecure();

Negotiate

Negotiate a value from HTTP headers.

• $type is a string representing the type of negotiation to perform, and must be one of either "content", "encoding" or "language".
• $supported is an array containing the supported values.
• $strict is a boolean indicating whether to not use a default fallback, and will default to false.

$value = $request->negotiate($type, $supported, $strict);

Set Locale

Set the current locale.

• $locale is a string representing the locale.

$newRequest = $request->setLocale($locale);

The locale must be present in the supportedLocales property of the ServerRequest $options parameter.

Client Responses

This class extends the Response class.

• $options is an array containing configuration options.
  • body is a string representing the message body, and will default to "".
  • headers is an array containing additional headers to set.
  • protocolVersion is a string representing the protocol version, and will default to "1.1".
  • statusCode is a number representing the status code, and will default to 200.

$response = new ClientResponse($options);

Delete Cookie

• $name is a string representing the cookie name.
• $options is an array containing cookie options.
  • domain is a string representing the cookie domain, and will default to "".
  • path is a string representing the cookie path, and will default to "/".
  • secure is a boolean indicating whether to set a secure cookie, and will default to false.
  • httpOnly is a boolean indicating whether to the cookie should be HTTP only, and will default to false.
  • sameSite is a string representing the cookie same site, and will default to "Lax".

$newResponse = $response->deleteCookie($name, $options);

Get Cookie

• $name is a string representing the cookie name.

$cookie = $response->getCookie($name);

This method will return a Cookie.

Has Cookie

Determine if a cookie has been set.

• $name is a string representing the cookie name.

$hasCookie = $response->hasCookie($name);

No Cache

Set headers to prevent browser caching.

$newResponse = $response->noCache();

Send

Send the response to the client.

$response->send();

Set Content Type

Set the content type header

• $mimeType is a string representing the MIME type.
• $charset is a string representing the character set, and will default to "UTF-8".

$newResponse = $response->setContentType($mimeType, $charset);

Set Cookie

Set a cookie value.

• $name is a string representing the cookie name.
• $value is a string representing the cookie value.
• $options is an array containing cookie options.
  • expires is a number representing the cookie lifetime, and will default to 0.
  • domain is a string representing the cookie domain, and will default to "".
  • path is a string representing the cookie path, and will default to "/".
  • secure is a boolean indicating whether to set a secure cookie, and will default to false.
  • httpOnly is a boolean indicating whether to the cookie should be HTTP only, and will default to false.
  • sameSite is a string representing the cookie same site, and will default to "Lax".

$newResponse = $response->setCookie($name, $value, $options);

Set Date

Set the date header.

• $date is a string, number or DateTime object representing the date.

$newResponse = $response->setDate($date);

Set JSON

Set a JSON response.

• $data is the data to send.

$newResponse = $response->setJson($data);

Set Last Modified

Set the last modified date header.

• $date is a string, number or DateTime object representing the date.

$newResponse = $response->setLastModified($date);

Set XML

Set an XML response.

• $data is a SimpleXMLElement containing the data to send.

$newResponse = $response->setXml($data);

Download Responses

This class extends the ClientResponse class.

• $path is a string representing the file path.
• $options is an array containing configuration options.
  • filename is a string representing the download filename, and will default to the file name.
  • mimeType is a string representing the MIME type, and will default to the file MIME type.
  • headers is an array containing additional headers to set.
  • protocolVersion is a string representing the protocol version, and will default to "1.1".
  • statusCode is a number representing the status code, and will default to 200.

$response = new DownloadResponse($path, $options);

From Binary

• $data is a string representing the file data.
• $options is an array containing configuration options.
  • filename is a string representing the download filename, and will default to the file name.
  • mimeType is a string representing the MIME type, and will default to the file MIME type.

$response = DownloadResponse::fromBinary($data, $options);

Get File

Get the download File.

$file = $response->getFile();

Redirect Responses

This class extends the ClientResponse class.

• $uri is a Uri or string representing the URI to redirect to.
• $code is a number representing the header status code, and will default to 302.
• $options is an array containing configuration options.

$response = new RedirectResponse($uri, $code $options);

Uploaded Files

This class extends the File class.

Client Extension

Get the client extension.

$extension = $uploadedFile->clientExtension();

Client MIME Type

Get the client MIME type.

$mimeType = $uploadedFile->clientMimeType();

Client Name

Get the client filename.

$name = $uploadedFile->clientName();

Error

Get the uploaded error code.

$error = $uploadedFile->error();

Has Moved

Determine if the uploaded file has been moved.

$hasMoved = $uploadedFile->hasMoved();

Is Valid

Determine if the uploaded file is valid.

$isValid = $uploadedFile->isValid();

Move To

Move the uploaded file.

• $destination is string representing the destination folder.
• $name is a string representing the new filename, and will default to the client name.

$file = $uploadedFile->moveTo($destination, $name);

This method will return a new File for the moved file.