Класс Request

Класс request — это объектно-ориентированное представление HTTP-запроса. Он предназначен для работы как с входящими запросами (например, от браузера к приложению), так и с исходящими запросами (например, от приложения к стороннему приложению). Этот класс предоставляет общую функциональность для обоих случаев, но в каждом случае существуют пользовательские классы, расширяющие класс Request, чтобы добавить специфическую функциональность.

Дополнительные сведения о использовании см. в документации по классу IncomingRequest и CURLRequest.

Справочник по классу

CodeIgniter\HTTP\Request

getIPAddress()

Возвращает:	IP-адрес пользователя, если он может быть обнаружен, или null. Если IP-адрес не является корректным IP-адресом, то возвращается 0.0.0.0
Тип возвращаемого значения:	строка

Возвращает IP-адрес текущего пользователя. Если IP-адрес недействителен, метод вернёт «0.0.0.0»:

echo $request->getIPAddress();

Важно

Этот метод учитывает параметр App->proxyIPs, и вернёт указанный HTTP_X_FORWARDED_FOR, HTTP_CLIENT_IP, HTTP_X_CLIENT_IP или HTTP_X_CLUSTER_CLIENT_IP адрес, если IP-адрес разрешён.

isValidIP($ip[, $which = ''])

Важно

Этот метод устарел.

Параметры:	$ip (строка) – IP-адрес $which (строка) – Протокол IP (‘ipv4’ или ‘ipv6’)
Возвращает:	true, если адрес корректен, false — если нет
Тип возвращаемого значения:	bool

Принимает IP-адрес в качестве входных данных и возвращает true или false (булево значение) в зависимости от того, является ли он действительным.

Примечание

Метод $request->getIPAddress() выше автоматически проверяет корректность IP-адреса.

if ( ! $request->isValidIP($ip)) {
    echo 'Not Valid';
} else {
    echo 'Valid';
}

Принимает необязательный второй строковый параметр ‘ipv4’ или ‘ipv6’ для указания формата IP. По умолчанию проверяются оба формата.

getMethod([$upper = false])

Важно

Использование параметра $upper устарело.

Параметры:	$upper (bool) – Требуется ли вернуть имя метода запроса в верхнем или нижнем регистре
Возвращает:	Метод HTTP-запроса
Тип возвращаемого значения:	строка

Возвращает $_SERVER['REQUEST_METHOD'], с возможностью установить его в верхнем или нижнем регистре.

echo $request->getMethod(true); // Outputs: POST
echo $request->getMethod(false); // Outputs: post
echo $request->getMethod(); // Outputs: post

setMethod($method)

Параметры:	$upper (строка) – Устанавливает метод запроса. Используется при подмене запроса.
Возвращает:	Метод HTTP-запроса
Тип возвращаемого значения:	Request

getServer([$index = null[, $filter = null[, $flags = null]]])

Параметры:	$index (смешанный тип) – Название значения $filter (целое число) – Тип применяемого фильтра. Список фильтров можно найти здесь. $flags (целое число/массив) – Флаги для применения. Список флагов можно найти здесь.
Возвращает:	Значение элемента $_SERVER, если найден, null — если нет
Тип возвращаемого значения:	смешанный тип

Этот метод идентичен методам post(), get() и cookie() из класса IncomingRequest, только он извлекает данные getServer ($_SERVER):

$request->getServer('some_data');

Чтобы вернуть массив нескольких $_SERVER значений, передайте все необходимые ключи в виде массива.

$require->getServer(['SERVER_PROTOCOL', 'REQUEST_URI']);

getEnv([$index = null[, $filter = null[, $flags = null]]])

Параметры:	$index (смешанный тип) – Название значения $filter (целое число) – Тип применяемого фильтра. Список фильтров можно найти здесь. $flags (целое число/массив) – Флаги для применения. Список флагов можно найти здесь.
Возвращает:	Значение элемента $_ENV, если найден, null — если нет
Тип возвращаемого значения:	смешанный тип

Этот метод идентичен методам post(), get() и cookie() из класса IncomingRequest, только он извлекает данные getEnv ($_ENV):

$request->getEnv('some_data');

Чтобы вернуть массив нескольких $_ENV значений, передайте все необходимые ключи в виде массива.

$require->getEnv(['CI_ENVIRONMENT', 'S3_BUCKET']);

setGlobal($method, $value)

Параметры:	$method (строка) – Имя метода $value (смешанный тип) – Данные для добавления
Возвращает:	Метод HTTP-запроса
Тип возвращаемого значения:	Request

Позволяет вручную установить значение PHP глобальной переменной, например $_GET, $_POST и т. д.

fetchGlobal($method[, $index = null[, $filter = null[, $flags = null]]])

Параметры:	$method (строка) – Константа входного фильтра $index (смешанный тип) – Название значения $filter (целое число) – Тип применяемого фильтра. Список фильтров можно найти здесь. $flags (целое число/массив) – Флаги для применения. Список флагов можно найти здесь.
Тип возвращаемого значения:	смешанный тип

Извлекает одно или несколько элементов из глобальной переменной, например, cookies, get, post и т. д. При необходимости, может отфильтровать входные данные при извлечении, передав фильтр.