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

<?php
declare(strict_types=1);

$encoded = base64_encode('PHP');
echo $encoded, "\n";
echo base64_decode($encoded, true), "\n";

UEhQ
PHP

Упаковка видима, но не секретна. Любой получатель строки UEhQ может восстановить исходный текст.

<?php
declare(strict_types=1);

$bytes = "A\0B";
$encoded = base64_encode($bytes);
echo $encoded, "\n";
echo bin2hex(base64_decode($encoded, true)), "\n";
echo http_build_query(['data' => $encoded], '', '&', PHP_QUERY_RFC3986), "\n";

QQBC
410042
data=QQBC

bin2hex делает бинарный результат наблюдаемым. В URL Base64 всё равно помещают через построитель query: другие данные могут дать +, / и =.

<?php
declare(strict_types=1);

$encoded = base64_encode(hex2bin('fbff'));
echo $encoded, "\n";
$query = http_build_query(['blob' => $encoded], '', '&', PHP_QUERY_RFC3986);
echo $query, "\n";
parse_str($query, $received);
var_dump($received['blob'] === $encoded);

+/8=
blob=%2B%2F8%3D
bool(true)

hex2bin превращает известную шестнадцатеричную запись в байты. parse_str здесь моделирует декодирование query PHP. Base64url использует - и _ вместо + и /, а правило padding задаётся протоколом; это отдельный вариант.

<?php
declare(strict_types=1);

$decoded = base64_decode('UEhQ', true);
if ($decoded === false) { throw new RuntimeException('Invalid Base64'); }
echo $decoded, "\n";
var_dump(base64_decode('', true));

PHP
string(0) ""

Пустой корректный конверт возвращает пустую строку. Проверка if (!$decoded) спутала бы её с отказом.

<?php
declare(strict_types=1);

var_dump(base64_decode('UE!hQ'));
var_dump(base64_decode('UE!hQ', true));

string(3) "PHP"
bool(false)

Без strict восклицательный знак исчез. В интеграции такие потери могут скрыть повреждение сообщения; сначала согласуйте допустимый формат.

<?php
declare(strict_types=1);

foreach (['QQ==', 'QR==', 'QQ'] as $text) {
    $bytes = base64_decode($text, true);
    $canonical = $bytes !== false && base64_encode($bytes) === $text;
    echo $text, ': ', $canonical ? 'canonical' : 'different representation', "\n";
}

QQ==: canonical
QR==: different representation
QQ: different representation

В PHP 8.5 strict ещё принимает эти неканонические варианты. Сравнение обратного кодирования дополнительно требует стандартный алфавит, padding и точную запись. Для протокола без padding/с разрешёнными пробелами нужна именно его политика, а не этот критерий.

<?php
declare(strict_types=1);

echo urlencode('tea + cake'), "\n";
echo urldecode(urlencode('tea + cake')), "\n";

tea+%2B+cake
tea + cake

Разница между пробелом и знаком + сохраняется. Это не замена пробелов дефисами для красивого slug.

<?php
declare(strict_types=1);

$query = 'C++ tea';
$url = '/search?q=' . urlencode($query);
echo $url, "\n";
echo htmlspecialchars($url, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";

/search?q=C%2B%2B+tea
/search?q=C%2B%2B+tea

Для нескольких параметров предпочтительнее http_build_query. Перед вставкой готового адреса в HTML выполняется отдельное HTML-экранирование; оно не заменяет кодирование параметра.

<?php
declare(strict_types=1);

$once = urlencode('A/B');
echo $once, "\n";
echo urlencode($once), "\n";

A%2FB
A%252FB

Вторая строка описывает буквальный текст A%2FB. Повторное кодирование не «усиливает защиту», а меняет значение.

<?php
declare(strict_types=1);

echo rawurlencode('tea + cake'), "\n";
echo rawurldecode(rawurlencode('tea + cake')), "\n";

tea%20%2B%20cake
tea + cake

Разница между пробелом и знаком + сохраняется. Это не замена пробелов дефисами для красивого slug.

<?php
declare(strict_types=1);

$category = rawurlencode('tea sets');
$product = rawurlencode('A/B');
echo '/catalog/' . $category . '/' . $product, "\n";

/catalog/tea%20sets/A%2FB

Слеш внутри A/B закодирован как часть одного сегмента. Но веб-сервер/роутер могут отдельно обрабатывать %2F: допустимость таких идентификаторов задаётся маршрутом. Не кодируйте всю строку https://… одной функцией.

<?php
declare(strict_types=1);

$once = rawurlencode('A/B');
echo $once, "\n";
echo rawurlencode($once), "\n";

A%2FB
A%252FB

Вторая строка описывает буквальный текст A%2FB. Повторное кодирование не «усиливает защиту», а меняет значение.

<?php
declare(strict_types=1);

echo urldecode('tea+cake%20%2B%20milk'), "\n";

tea cake + milk

Декодер выбирают по формату отправителя. Query формы и сегмент пути могут использовать разные правила.

<?php
declare(strict_types=1);

$once = urldecode('A%252FB');
echo $once, "\n";
echo urldecode($once), "\n";
echo urldecode('%ZZ%2'), "\n";

A%2FB
A/B
%ZZ%2

После второго вызова появляется новый разделитель /. Нельзя сначала проверять путь, а затем раскодировать его ещё раз и использовать уже изменившееся значение.

<?php
declare(strict_types=1);

echo bin2hex(urldecode('A%00B')), "\n";

410042

Декодирование — преобразование, не очистка. Для файловых путей нулевой байт недопустим; для HTML всё равно требуется htmlspecialchars.

<?php
declare(strict_types=1);

echo rawurldecode('tea+cake%20%2B%20milk'), "\n";

tea+cake + milk

Декодер выбирают по формату отправителя. Query формы и сегмент пути могут использовать разные правила.

<?php
declare(strict_types=1);

$once = rawurldecode('A%252FB');
echo $once, "\n";
echo rawurldecode($once), "\n";
echo rawurldecode('%ZZ%2'), "\n";

A%2FB
A/B
%ZZ%2

После второго вызова появляется новый разделитель /. Нельзя сначала проверять путь, а затем раскодировать его ещё раз и использовать уже изменившееся значение.

<?php
declare(strict_types=1);

echo bin2hex(rawurldecode('A%00B')), "\n";

410042

Декодирование — преобразование, не очистка. Для файловых путей нулевой байт недопустим; для HTML всё равно требуется htmlspecialchars.

<?php
declare(strict_types=1);

$parameters = ['q' => 'C++ tea', 'page' => 2];
$query = http_build_query($parameters, '', '&', PHP_QUERY_RFC3986);
echo $query, "\n";
echo '/search?' . $query, "\n";

q=C%2B%2B%20tea&page=2
/search?q=C%2B%2B%20tea&page=2

Символ ? добавляет ваше приложение между известным путём и query. Амперсанд отделяет параметры, а не является частью q.

<?php
declare(strict_types=1);

$parameters = ['filter' => ['stock' => true], 'tags' => ['tea', 'gift'], 0 => 'preview'];
echo http_build_query($parameters, 'flag_', '&', PHP_QUERY_RFC3986), "\n";

filter%5Bstock%5D=1&tags%5B0%5D=tea&tags%5B1%5D=gift&flag_0=preview

Квадратные скобки — соглашение PHP о вложенных query-параметрах. Другой API может требовать tags=tea&tags=gift или строку CSV: формат надо согласовать, а не считать универсальным.

<?php
declare(strict_types=1);

$parameters = ['missing' => null, 'list' => [], 'text' => '', 'enabled' => false, 'count' => 0];
$query = http_build_query($parameters, '', '&');
echo $query, "\n";
parse_str($query, $restored);
var_dump($restored['count']);

text=&enabled=0&count=0
string(1) "0"

Это не обратимый перенос PHP-массива: null/[] пропали, число стало текстом. Если API требует сохранить типы и пустые массивы, согласуйте JSON вместо query.

<?php
declare(strict_types=1);

class SearchLabel
{
    public string $label = 'gift';
    private string $internal = 'hidden';
    public function __toString(): string { return 'Gift selection'; }
}
$label = new SearchLabel();
echo http_build_query(['item' => $label], '', '&'), "\n";
echo http_build_query(['item' => (string) $label], '', '&'), "\n";

item%5Blabel%5D=gift
item=Gift+selection

Сначала передаётся публичное свойство. Явное (string) вызывает __toString, и тогда строится обычное строковое значение. Private не попадает в query, но это не повод передавать произвольный объект с потенциально секретными public-полями.

<?php
declare(strict_types=1);

enum ViewMode: string { case Compact = 'compact'; }
echo http_build_query(['view' => ViewMode::Compact], '', '&'), "\n";

view=compact

В более старом PHP поведение отличалось. Для совместимой явной записи используйте ViewMode::Compact->value. Сам enum объясняется в разделе перечислений.

<?php
declare(strict_types=1);

$url = 'https://shop.example:8443/products?q=tea#details';
echo parse_url($url, PHP_URL_HOST), "\n";
echo parse_url($url, PHP_URL_PATH), "\n";
echo parse_url($url, PHP_URL_QUERY), "\n";
var_dump(parse_url($url, PHP_URL_PORT));

shop.example
/products
q=tea
int(8443)

Домен .example в этом опыте — только строка: сетевой запрос не выполняется. Фрагмент после # браузер обычно использует локально; он не входит в HTTP request target.

<?php
declare(strict_types=1);

var_dump(parse_url('https://shop.example/catalog', PHP_URL_QUERY));
var_dump(parse_url('https://shop.example/catalog?', PHP_URL_QUERY));
echo parse_url('/catalog/tea%20sets?q=A%2BB', PHP_URL_PATH), "\n";

NULL
string(0) ""
/catalog/tea%20sets

%20 остался в path. Не раскодируйте весь адрес до разделения: %2F, %3F и %23 могут стать новыми разделителями.

<?php
declare(strict_types=1);

$parts = parse_url('just some text');
echo $parts['path'], "\n";
var_dump(parse_url('https://shop.example:99999/'));
try { parse_url('https://shop.example/', 999); }
catch (ValueError $error) { echo "Unknown component\n"; }

just some text
bool(false)
Unknown component

Обычный текст принят как path. Это наглядная причина не считать parse_url проверкой разрешённой ссылки или безопасного назначения HTTP-запроса.

<?php
declare(strict_types=1);

echo parse_url('//shop.example/catalog', PHP_URL_HOST), "\n";
var_dump(parse_url('shop.example/catalog', PHP_URL_HOST));
echo parse_url('file:///tmp/report.txt', PHP_URL_SCHEME), "\n";

shop.example
NULL
file

file:// имеет историческое специальное поведение. Пример только разбирает текст и не открывает файл. Относительные URL требуют корректного разрешения относительно базового адреса; ручная склейка не заменяет стандартный URL API.

<?php
declare(strict_types=1);

$tags = get_meta_tags(__DIR__ . '/page.html');
if ($tags === false) { throw new RuntimeException('Cannot read HTML'); }
echo $tags['description'] ?? 'No description', "\n";

Tea catalog

Оператор ?? выбирает запасной текст, если ключ отсутствует. Существование файла ещё не означает наличие meta description.

<?php
declare(strict_types=1);

$tags = get_meta_tags(__DIR__ . '/page.html');
echo $tags['description'], "\n", $tags['geo_position'], "\n";
var_dump(isset($tags['og:title']), isset($tags['late']));

Second
10;20
bool(false)
bool(false)

DESCRIPTION преобразован в description, второй тег перезаписал первый. geo.position стал geo_position. property не учитывается, как и тег после head.

<?php
declare(strict_types=1);

$old = get_include_path();
try {
    set_include_path(__DIR__ . '/templates');
    $tags = get_meta_tags('page.html', true);
    if ($tags === false) { throw new RuntimeException('Cannot read template'); }
    echo $tags['author'], "\n";
} finally { set_include_path($old); }

Editorial team

Поиск разрешённого шаблона и восстановление настройки показаны явно. Не используйте include_path как механизм открытия произвольного файла по имени пользователя.

<?php
declare(strict_types=1);

$warned = false;
set_error_handler(static function (int $level) use (&$warned): bool {
    if ($level !== E_WARNING) { return false; }
    $warned = true; return true;
});
try { $tags = get_meta_tags(__DIR__ . '/missing.html'); }
finally { restore_error_handler(); }
var_dump($tags === false, $warned);

bool(true)
bool(true)

Обработчик отмечает ожидаемое предупреждение только в этом опыте. Пустой успешный массив и false — разные результаты. В приложении диагностику сохраняют без раскрытия внутренних путей посетителю.

<?php
declare(strict_types=1);

$base = getenv('PHP_MANUAL_HTTP_BASE');
if ($base === false || $base === '') { throw new RuntimeException('Start the local lesson HTTP fixture'); }
$context = stream_context_create(['http' => [
    'method' => 'HEAD', 'timeout' => 2, 'follow_location' => 0, 'ignore_errors' => true
]]);
$headers = get_headers($base . '/ok', false, $context);
if ($headers === false) { throw new RuntimeException('HTTP request failed'); }
echo $headers[0], "\n";

HTTP/1.1 200 OK

Статус фиксирован в нашем fixture. Внешний сервер может ответить другой версией HTTP или статусом. При выключенном follow_location первая status line относится именно к этому ответу.

<?php
declare(strict_types=1);

$base = getenv('PHP_MANUAL_HTTP_BASE');
if ($base === false || $base === '') { throw new RuntimeException('Start the local lesson HTTP fixture'); }
$context = stream_context_create(['http' => [
    'method' => 'HEAD', 'timeout' => 2, 'follow_location' => 0
]]);
$headers = get_headers($base . '/repeat', true, $context);
if ($headers === false) { throw new RuntimeException('HTTP request failed'); }
$values = [];
foreach ($headers as $name => $value) {
    if (is_string($name) && strcasecmp($name, 'X-Lesson') === 0) {
        foreach ((array) $value as $item) { $values[] = $item; }
    }
}
echo implode(' | ', $values), "\n";

first | second

Имена HTTP-заголовков нечувствительны к регистру. Фиксированное обращение к headers["Content-Type"] не является универсальным регистронезависимым поиском. Для Set-Cookie повторения особенно существенны; их нельзя слепо склеивать в одно значение.

<?php
declare(strict_types=1);

$base = getenv('PHP_MANUAL_HTTP_BASE');
if ($base === false || $base === '') { throw new RuntimeException('Start the local lesson HTTP fixture'); }
$context = stream_context_create(['http' => [
    'method' => 'HEAD', 'timeout' => 2, 'follow_location' => 0, 'ignore_errors' => true
]]);
$headers = get_headers($base . '/redirect', false, $context);
if ($headers === false) { throw new RuntimeException('HTTP request failed'); }
echo $headers[0], "\n";
echo in_array('Location: /ok', $headers, true) ? "Redirect observed\n" : "No location\n";

HTTP/1.1 302 Found
Redirect observed

Location в тесте имеет известный регистр. В общем случае ищут имена без учёта регистра, затем разрешают относительный адрес по стандарту и заново проверяют допустимость назначения. Нельзя считать первый 301/302 окончательным статусом после всей цепочки.

<?php
declare(strict_types=1);

$base = getenv('PHP_MANUAL_HTTP_BASE');
if ($base === false || $base === '') { throw new RuntimeException('Start the local lesson HTTP fixture'); }
$context = stream_context_create(['http' => [
    'method' => 'HEAD', 'timeout' => 2, 'follow_location' => 0, 'ignore_errors' => true
]]);
$headers = get_headers($base . '/missing', false, $context);
if ($headers === false) { throw new RuntimeException('Transport failure'); }
echo $headers[0], "\n";

HTTP/1.1 404 Not Found

Транспорт вернул ответ, но нужного ресурса нет. Не называйте любой непустой массив подтверждением доступности/исправности сайта.