PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

$headers = apache_request_headers();
$contentType = null;
foreach ($headers as $name => $value) {
    if (strcasecmp($name, 'Content-Type') === 0) {
        $contentType = $value;
        break;
    }
}
echo $contentType ?? 'Content-Type отсутствует';

application/json

HTTP-условие: клиент прислал Content-Type: application/json. Заголовок может отсутствовать: это обработано явно. Значение ещё не доказывает, что тело действительно корректный JSON.

<?php
declare(strict_types=1);

$headers = array_change_key_case(apache_request_headers(), CASE_LOWER);
$contentType = $headers['content-type'] ?? '';
$mediaType = strtolower(trim(explode(';', $contentType, 2)[0]));
if ($mediaType !== 'application/json') {
    http_response_code(415);
    echo 'Для этого endpoint нужен application/json';
    return;
}
echo 'Можно переходить к чтению и проверке JSON';

Можно переходить к чтению и проверке JSON

Для Content-Type: application/json; charset=UTF-8. Это политика конкретного endpoint: другие форматы, включая application/problem+json, не приняты автоматически. Следующий шаг — лимит тела и json_decode с обработкой ошибки.

<?php
declare(strict_types=1);

$headers = array_change_key_case(getallheaders(), CASE_LOWER);
echo isset($headers['x-demo-client']) ? "Метка присутствует\n" : "Метки нет\n";

Метка присутствует

Тестовый HTTP-запрос содержит X-Demo-Client: mobile. Наличие метки не аутентифицирует клиента: любой отправитель может её поставить.

<?php
declare(strict_types=1);

if (!function_exists('getallheaders')) {
    echo "В этом SAPI getallheaders недоступна\n";
} else {
    echo "HTTP-функция доступна\n";
}

В этом SAPI getallheaders недоступна

Ожидается обычный CLI PHP8.5.11. При запуске через php -S результат другой. Для тестов бизнес-логики передайте подготовленный массив заголовков параметром, вместо имитации веб-сервера глобальной функцией.

<?php
declare(strict_types=1);

header('Content-Type: text/plain; charset=UTF-8');
$headers = array_change_key_case(apache_response_headers(), CASE_LOWER);
echo $headers['content-type'] ?? 'Тип ещё не виден';

text/plain; charset=UTF-8

На встроенном HTTP-сервере PHP8.5.11 эти подготовленные заголовки видны до тела. В Apache момент заполнения headers_out определяется серверным циклом. Код не доказывает, что proxy сохранит тот же заголовок.

<?php
declare(strict_types=1);

header('X-Demo-Tag: first', false);
header('X-Demo-Tag: second', false);
$headers = apache_response_headers();
$list = array_values(array_filter(headers_list(),
    static fn(string $line): bool => str_starts_with(strtolower($line), 'x-demo-tag:')));
echo $headers['X-Demo-Tag'], "\n";
echo count($list), "\n";

second
2

Результат для PHP8.5.11 cli-server: одинаковый ключ массива оставляет последнее значение, а headers_list содержит обе строки. Не используйте такую карту для точного копирования Set-Cookie. Это демонстрационный X-заголовок, не правило объединения любых HTTP-полей.

<?php
declare(strict_types=1);

$modules = apache_get_modules();
echo in_array('mod_rewrite', $modules, true)
    ? "Модуль загружен\n" : "Модуль не найден\n";

Модуль загружен

Ожидание относится к Apache, в котором реально включён mod_rewrite. Это ещё не доказательство, что правила RewriteRule конкретного сайта разрешены и верны.

<?php
declare(strict_types=1);

$loaded = apache_get_modules();
foreach (['mod_rewrite', 'mod_headers'] as $required) {
    echo $required, ': ', in_array($required, $loaded, true) ? 'есть' : 'нет', "\n";
}

mod_rewrite: есть
mod_headers: есть

Список зависит от сборки Apache. Имена берутся из Apache-модулей; get_loaded_extensions, напротив, отвечает про расширения PHP. Не публикуйте подробный служебный отчёт на общедоступной странице.

<?php
declare(strict_types=1);

$version = apache_get_version();
echo $version === false ? "Banner недоступен\n" : "Banner получен\n";

Banner получен

Фактический текст зависит от сборки и ServerTokens. Здесь не зашита придуманная версия сервера.

<?php
declare(strict_types=1);

$diagnostic = [
    'php' => PHP_VERSION,
    'sapi' => PHP_SAPI,
    'apache_banner' => apache_get_version(),
];
echo $diagnostic['sapi'] === 'apache2handler' ? "PHP встроен в Apache\n" : "Другой SAPI\n";

PHP встроен в Apache

Сам массив остаётся внутри закрытой диагностики. Banner не является машиночитаемой гарантией всех security-патчей: дистрибутив может backport-ить исправления.

<?php
declare(strict_types=1);

$previous = apache_note('manual-route', 'checkout');
$current = apache_note('manual-route');
echo $current, "\n";

checkout

В новом запросе previous может быть false: это отсутствие прежнего значения, а не неудачная запись. Apache_note возвращает старое значение при записи.

<?php
declare(strict_types=1);

apache_note('manual-result', 'started');
$old = apache_note('manual-result', 'saved');
$now = apache_note('manual-result', null);
echo $old, ' -> ', $now, "\n";

started -> saved

Переданный null читает текущее значение, как пропущенный второй аргумент. Это не удаление заметки. Пустая строка, напротив, записывается как значение.

LogFormat "%h %>s %{manual-route}n" manual_route
CustomLog logs/manual-route.log manual_route

Фрагмент конфигурации Apache для администратора собственного тестового virtual host. Суффикс n читает note; e читает environment, i — входной заголовок. Здесь нет session ID, cookie или токенов.

<?php
declare(strict_types=1);

$region = apache_getenv('APP_REGION');
echo $region === false ? "Регион не задан\n" : $region . "\n";

Регион не задан

Для запроса, где APP_REGION не установлен. Если администратор задал переменную, будет её строковое значение. Проверка === false не путает отсутствие с "0" или пустой строкой.

<?php
declare(strict_types=1);

$before = $_SERVER['MANUAL_REGION'] ?? null;
apache_setenv('MANUAL_REGION', 'north');
echo apache_getenv('MANUAL_REGION'), "\n";
echo ($_SERVER['MANUAL_REGION'] ?? null) === $before ? "SERVER не изменён\n" : "SERVER изменён\n";

north
SERVER не изменён

Apache subprocess_env и уже сформированный PHP-массив $_SERVER — не одна ссылка на один объект. Изменение первого не обновляет второй автоматически.

<?php
declare(strict_types=1);

$saved = apache_setenv('MANUAL_SECTION', 'catalog');
echo $saved ? "Метка установлена\n" : "Метка не установлена\n";

Метка установлена

В пределах текущего Apache-запроса. Следующий отдельный HTTP-запрос не обязан видеть эту отметку.

<?php
declare(strict_types=1);

apache_setenv('MANUAL_LABEL', 'Catalog');
if (!virtual('/manual-fragments/label.shtml')) {
    echo 'Фрагмент недоступен';
}

Catalog

Контекст: Apache разрешает SSI для фиксированного label.shtml, содержащего . Реальное окружение/наследование subrequest надо согласовать на стенде. В данном примере значение фиксировано; пользовательский HTML туда не передаётся.

<?php
declare(strict_types=1);

$info = apache_lookup_uri('/manual-fragments/menu.shtml');
if ($info === false) {
    echo "URI не разрешён\n";
    return;
}
echo $info->uri ?? 'URI не указан';

/manual-fragments/menu.shtml

Условие: ресурс существует и разрешается Apache со статусом HTTP200. false проверяется до доступа к свойствам; прямое $info->filename без этой проверки ломается на ошибке.

<?php
declare(strict_types=1);

$info = apache_lookup_uri('/manual-fragments/menu.shtml');
if ($info !== false) {
    $publicInfo = [
        'uri' => $info->uri ?? null,
        'type' => $info->content_type ?? null,
    ];
    echo json_encode($publicInfo, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES);
} else {
    echo 'Не найдено';
}

{"uri":"/manual-fragments/menu.shtml","type":"text/html"}

Примерный результат для собственного SSI-ресурса с text/html. Точный content_type/handler зависит от конфигурации. Полный объект может раскрыть путь сервера и внутренние аргументы, поэтому его не возвращают посетителю целиком.

<?php
declare(strict_types=1);

header('Content-Type: text/html; charset=UTF-8');
echo '<main>';
if (!virtual('/manual-fragments/menu.shtml')) {
    echo '<p>Меню временно недоступно</p>';
}
echo '</main>';

<main><nav>Каталог</nav></main>

Ожидание для тестового menu.shtml, выдающего ровно

<?php
declare(strict_types=1);

$requested = $_GET['part'] ?? 'menu';
$allowed = ['menu' => '/manual-fragments/menu.shtml'];
if (!is_string($requested) || !array_key_exists($requested, $allowed)) {
    http_response_code(400);
    echo 'Неизвестная часть страницы';
    return;
}
header('Content-Type: text/html; charset=UTF-8');
if (!virtual($allowed[$requested])) echo '<p>Раздел недоступен</p>';

<nav>Каталог</nav>

Условие: part=menu и настроенный фрагмент. Посетитель выбирает ключ, но не путь. Если ошибка virtual наступила после сброса заголовков, нельзя рассчитывать поменять основной HTTP-статус; обработка такого сбоя проектируется заранее.

<?php
declare(strict_types=1);

echo function_exists('apache_child_terminate')
    ? "API есть: требуется проверить режим сервера\n"
    : "API в этом SAPI отсутствует\n";

API в этом SAPI отсутствует

Ожидание для CLI PHP8.5.11. Наличие функции в другом SAPI ещё не означает, что сервер исполняет нужный жизненный цикл.

<?php
declare(strict_types=1);

// Только согласованный Unix CGI/FastCGI-стенд с этим API.
if (function_exists('apache_child_terminate')) {
    apache_child_terminate();
}
echo "Текущий код продолжает выполняться\n";

Текущий код продолжает выполняться

Контекстный пример: функция не делает exit и не возвращает признак успеха. В PHP8.5.11 реализация CGI вызывает fcgi_terminate только при настоящем FastCGI-режиме. На этом стенде такой lifecycle не запускался.