Easily handle data from incoming HTTP requests.
This project is open source and available under the MIT License.
- PHP
^8.0
composer require bayfrontmedia/php-http-request
Request methods
Data types
- getFile
- hasFile
- getQuery
- hasQuery
- getPost
- hasPost
- getServer
- hasServer
- getCookie
- hasCookie
- getHeader
- hasHeader
- getBody
- hasBody
Specific values
Description:
Returns valid request method with a fallback to GET.
Valid request methods include:
CONNECTDELETEGETHEADOPTIONSPATCHPOSTPUTTRACE
Parameters:
$method(string)
Returns:
- (string)
Example:
use Bayfront\HttpRequest\Request;
echo Request::validateMethod('GET');
Description:
Returns current request method.
Parameters:
- None
Returns:
- (string)
Example:
use Bayfront\HttpRequest\Request;
echo Request::getMethod();
Description:
Is current request method CONNECT.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isConnect()) {
// Do something
}
Description:
Is current request method DELETE.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isDelete()) {
// Do something
}
Description:
Is current request method GET.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isGet()) {
// Do something
}
Description:
Is current request method HEAD.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isHead()) {
// Do something
}
Description:
Is current request method OPTIONS.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isOptions()) {
// Do something
}
Description:
Is current request method PATCH.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isPatch()) {
// Do something
}
Description:
Is current request method POST.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isPost()) {
// Do something
}
Description:
Is current request method PUT.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isPut()) {
// Do something
}
Description:
Is current request method TRACE.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isTrace()) {
// Do something
}
Description:
Returns value of single $_FILES array key in dot notation or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if array key is not found
Returns:
- (mixed)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getFile('profile_photo'));
Description:
Checks if $_FILES array key exists in dot notation.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasFile('profile_photo')) {
// Do something
}
Description:
Returns value of single $_GET array key in dot notation or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if array key is not found
Returns:
- (mixed)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getQuery());
Description:
Checks if $_GET array key exists in dot notation.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasQuery('page')) {
// Do something
}
Description:
Returns value of single $_POST array key in dot notation or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if array key is not found
Returns:
- (mixed)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getPost());
Description:
Checks if $_POST array key exists in dot notation.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasPost('username')) {
// Do something
}
Description:
Returns value of single $_SERVER array key in dot notation or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if array key is not found
Returns:
- (mixed)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getServer());
Description:
Checks if $_SERVER array key exists in dot notation.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasServer('SERVER_NAME')) {
// Do something
}
Description:
Returns value of single $_COOKIE array key in dot notation or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if array key is not found
Returns:
- (mixed)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getCookie());
Description:
Checks if $_COOKIE array key exists in dot notation.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasCookie('cart_id')) {
// Do something
}
Description:
Returns value of single header array key in dot notation or entire array, with optional default value.
Parameters:
$key = NULL(string|null)$default = NULL(mixed): Default value to return if array key is not found
Returns:
- (mixed)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getHeader());
Description:
Checks if header array key exists in dot notation.
Parameters:
$key(string)
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasHeader('Content-Type')) {
// Do something
}
Description:
Returns content body of a request.
Parameters:
- None
Returns:
- (string)
Example:
use Bayfront\HttpRequest\Request;
print_r(Request::getBody());
Description:
Checks if content body of a request exists.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::hasBody()) {
// Do something
}
Description:
Returns client's user agent.
Parameters:
- None
Returns:
- (mixed): string|null
Example:
use Bayfront\HttpRequest\Request;
echo Request::getUserAgent();
Description:
Returns client's referring URL.
Parameters:
- None
Returns:
- (mixed): string|null
Example:
use Bayfront\HttpRequest\Request;
echo Request::getReferer();
Description:
Returns the most probable IP of client with optional default value.
Parameters:
$default = ''(string): Default IP address to return if none detected
Returns:
- (string)
Example:
use Bayfront\HttpRequest\Request;
echo Request::getIp();
Description:
Is the request originating from the command line.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isCli()) {
// Do something
}
Description:
Is the Content-Type header for this request JSON.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isJson()) {
// Do something
}
Description:
Does the Accept header for this request expect JSON.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::wantsJson()) {
// Do something
}
Description:
Is connection HTTPS.
Parameters:
- None
Returns:
- (bool)
Example:
use Bayfront\HttpRequest\Request;
if (Request::isHttps()) {
// Do something
}
Description:
Returns array containing details of the client's request, or string of a specific part of the request.
Parameters:
$part = ''(string): Which part of the request to return. Leaving this blank will return the entire array.
Valid $part values include any of the PART_* constants:
Requst::PART_METHODRequest::PART_PROTOCOLRequest::PART_HOSTRequest::PART_PATHRequest::PART_QUERYRequest::PART_QUERY_STRINGRequest::PART_URLRequest::PART_FULL_URL
Returns:
- (mixed): array|string
Example:
use Bayfront\HttpRequest\Request;
echo Request::getRequest(Request::PART_URL);
Description:
Returns current URL.
Parameters:
$include_query = false(bool): Include the query string, if existing
Returns:
- (string)
Example:
use Bayfront\HttpRequest\Request;
echo Request::getUrl();