HTTP параметры в PHP: как извлечь и обработать

// Получение параметра 'name' из GET запроса с санитизацией строки
$name = filter_input(INPUT_GET, 'name', FILTER_SANITIZE_STRING);

// Получение параметра 'age' из POST запроса с проверкой целого числа
$age = filter_input(INPUT_POST, 'age', FILTER_VALIDATE_INT);

// Если параметр не передан или не прошёл валидацию, возвращается false или null
if ($name === false || $name === null) {
    // обработка ошибки
}
  

$args = [
    'name' => FILTER_SANITIZE_STRING,
    'age'  => FILTER_VALIDATE_INT,
];
$inputs = filter_input_array(INPUT_GET, $args);
  

// GET параметры
$id = $_GET['id'] ?? null;

// POST параметры
$email = $_POST['email'] ?? '';

// Любой метод (GET, POST, Cookie)
$action = $_REQUEST['action'] ?? 'default';
  

// Получение сырых данных тела запроса
$rawBody = file_get_contents('php://input');

// Если данные в формате application/x-www-form-urlencoded
parse_str($rawBody, $params);
// $params теперь содержит массив параметров

// Если данные в JSON формате
$jsonData = json_decode($rawBody, true);
  

$url = 'http://example.com/page?foo=1&bar=2';
$query = parse_url($url, PHP_URL_QUERY);
parse_str($query, $result);
// $result = ['foo' => '1', 'bar' => '2']
  

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['avatar'])) {
    $file = $_FILES['avatar'];
    $name = $file['name'];         // исходное имя файла
    $type = $file['type'];         // MIME-тип
    $tmpName = $file['tmp_name'];  // временный путь
    $error = $file['error'];       // код ошибки
    $size = $file['size'];         // размер в байтах
}
  

Расширенные примеры работы с параметрами HTTP запроса в PHP

В этом разделе приведены неочевидные и продвинутые сценарии получения и анализа параметров.

1. Обработка множественных параметров с одинаковым именем (массивы)

Если клиент передаёт несколько значений с одним ключом, PHP автоматически преобразует их в массив, если в имени ключа используются квадратные скобки. Пример:

// URL: /page?colors[]=red&colors[]=green&colors[]=blue
$colors = $_GET['colors'];
// $colors = ['red', 'green', 'blue']

// Или через filter_input_array:
$filtered = filter_input_array(INPUT_GET, [
    'colors' => ['filter' => FILTER_SANITIZE_STRING, 'flags' => FILTER_REQUIRE_ARRAY]
]);
print_r($filtered);

Array
(
    [colors] => Array
        (
            [0] => red
            [1] => green
            [2] => blue
        )
)

2. Чтение JSON тела запроса с принудительной валидацией

Современные API часто передают данные в JSON. Ниже приведён полный пример с обработкой ошибок:

$raw = file_get_contents('php://input');
$data = json_decode($raw, true);

if (json_last_error() !== JSON_ERROR_NONE) {
    http_response_code(400);
    echo json_encode(['error' => 'Invalid JSON']);
    exit;
}

// Валидация обязательных полей
$required = ['username', 'email'];
foreach ($required as $field) {
    if (!isset($data[$field]) || empty(trim($data[$field]))) {
        http_response_code(422);
        echo json_encode(['error' => "Field '$field' is required"]);
        exit;
    }
}

echo json_encode(['status' => 'ok', 'user' => $data['username']]);

3. Извлечение параметров из multipart/form-data при ручном разборе

Когда требуется обработать загрузку файлов и полей в одном запросе без использования суперглобальных массивов (например, при создании прокси-скрипта).

$boundary = substr($_SERVER['CONTENT_TYPE'], strpos($_SERVER['CONTENT_TYPE'], 'boundary=') + 9);
$raw = file_get_contents('php://input');
$parts = explode('--' . $boundary, $raw);
array_pop($parts); // удаляем последнюю пустую часть

foreach ($parts as $part) {
    if (strpos($part, 'Content-Disposition: form-data; name="file"') !== false) {
        // Извлечение содержимого файла (упрощённо)
        preg_match('/Content-Type: (.+)\r\n\r\n(.*)/s', $part, $matches);
        $fileContent = $matches[2] ?? '';
        // обработка
    }
}

Результат не приводится, так как зависит от переданных данных. Этот метод применяется в библиотеках низкого уровня.

4. Параметры из строки запроса с использованием регулярных выражений

Иногда требуется разобрать параметры, закодированные нестандартным способом. Пример с парсингом вложенных массивов из строки:

$query = 'user[name]=John&user[age]=30&tags[]=php&tags[]=web';
$result = [];
parse_str($query, $result);
print_r($result);

Array
(
    [user] => Array
        (
            [name] => John
            [age] => 30
        )
    [tags] => Array
        (
            [0] => php
            [1] => web
        )
)

5. Получение параметров через объект Request из PSR-7 (с использованием библиотеки guzzlehttp/psr7)

Для проектов, где применяются современные стандарты, можно использовать PSR-7 RequestInterface. Пример:

use GuzzleHttp\Psr7\ServerRequest;

$request = ServerRequest::fromGlobals();
$getParams = $request->getQueryParams();
$postParams = $request->getParsedBody();
$uploadedFiles = $request->getUploadedFiles();

// Вывод всех GET параметров
print_r($getParams);

Array
(
    [page] => 1
    [limit] => 10
)

Примечание:

Для работы требуется установить библиотеку через Composer: composer require guzzlehttp/psr7.

6. Динамическое получение параметров через переменные переменные

Когда имя параметра неизвестно заранее, можно использовать суперглобальные массивы с динамическим ключом:

$paramName = 'sort';
$value = $_GET[$paramName] ?? 'default';
echo "Параметр $paramName = $value";

Параметр sort = asc

Такой подход полезен при построении универсальных обработчиков.