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

PHP 5.1+ · standard

inet_pton(string $ip): string|false

<?php
declare(strict_types=1);

$text = '2001:0db8:0:0:0:0:0:1';
$bytes = inet_pton($text);
if ($bytes === false) { throw new InvalidArgumentException('Неверный IP'); }
$path = __DIR__ . '/address.bin';
if (file_put_contents($path, $bytes) !== strlen($bytes)) { throw new RuntimeException('Адрес не записан полностью'); }
$stored = file_get_contents($path);
if ($stored === false) { throw new RuntimeException('Адрес не прочитан'); }
$display = inet_ntop($stored);
if ($display === false) { throw new RuntimeException('Повреждены байты адреса'); }
echo 'Узел учебного каталога: ', $display, "\n";

Узел учебного каталога: 2001:db8::1

Перевести текстовый IPv4/IPv6 в компактные байты, например для точного сравнения или хранения.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. strlen считает байты, bin2hex делает их печатными. Сам packed не предназначен для обычного HTML-вывода.

<?php
declare(strict_types=1);

$packed = inet_pton('127.0.0.1');
if ($packed === false) { throw new RuntimeException('Invalid address'); }
echo strlen($packed), "\n";
echo bin2hex($packed), "\n";

4
7f000001

Этот вариант. Оба отказа false тоже были бы равны друг другу, поэтому проверка результатов стоит до сравнения. IPv4 и IPv4-mapped IPv6 не становятся автоматически одним семейством.

<?php
declare(strict_types=1);

$first = inet_pton('2001:db8::1');
$second = inet_pton('2001:0db8:0:0:0:0:0:1');
if ($first === false || $second === false) { throw new RuntimeException('Invalid address'); }
var_dump($first === $second);
echo strlen($first), "\n";

bool(true)
16

Этот вариант. CIDR требует разбора адреса и длины префикса. Скобки в URL отделяют IPv6 от порта; они не входят в сам IP. Не срезайте части неизвестного ввода наугад.

<?php
declare(strict_types=1);

foreach (['[::1]', '127.0.0.1:8080', '2001:db8::/32', '127.1'] as $text) {
    var_dump(inet_pton($text));
}

bool(false)
bool(false)
bool(false)
bool(false)

Дальше: inet_ntop; ip2long; gethostbyname.

• PHP: inet_pton

PHP 5.1+ · standard

inet_ntop(string $ip): string|false

<?php
declare(strict_types=1);

$text = '2001:0db8:0:0:0:0:0:1';
$bytes = inet_pton($text);
if ($bytes === false) { throw new InvalidArgumentException('Неверный IP'); }
$path = __DIR__ . '/address.bin';
if (file_put_contents($path, $bytes) !== strlen($bytes)) { throw new RuntimeException('Адрес не записан полностью'); }
$stored = file_get_contents($path);
if ($stored === false) { throw new RuntimeException('Адрес не прочитан'); }
$display = inet_ntop($stored);
if ($display === false) { throw new RuntimeException('Повреждены байты адреса'); }
echo 'Узел учебного каталога: ', $display, "\n";

Узел учебного каталога: 2001:db8::1

Показать человеку адрес, сохранённый в четырёх или шестнадцати бинарных байтах.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. hex2bin здесь нужен только для видимой учебной записи. В базе/файле могут храниться уже готовые бинарные байты без промежуточного hex.

<?php
declare(strict_types=1);

$packed = hex2bin('7f000001');
if ($packed === false) { throw new RuntimeException('Bad hex fixture'); }
echo inet_ntop($packed), "\n";

127.0.0.1

Этот вариант. Байты сохраняют смысл адреса; исходные ведущие нули не обязаны сохраняться. Адрес документационный, соединения с ним нет.

<?php
declare(strict_types=1);

$original = '2001:0db8:0000:0000:0000:0000:0000:0001';
$packed = inet_pton($original);
if ($packed === false) { throw new RuntimeException('Invalid address'); }
$display = inet_ntop($packed);
echo $display, "\n";
var_dump(inet_pton($display) === $packed);

2001:db8::1
bool(true)

Этот вариант. Для смешанных IPv4/IPv6 выбирайте хранилище переменной длины 4/16 либо явно храните семейство. Безусловное дополнение IPv4 нулями до 16 байт меняет интерпретацию на IPv6.

<?php
declare(strict_types=1);

foreach (['', 'abc', 'abcde'] as $packed) { var_dump(inet_ntop($packed)); }

bool(false)
bool(false)
bool(false)

Дальше: inet_pton; long2ip.

• PHP: inet_ntop

PHP 4+ · standard

ip2long(string $ip): int|false

<?php
declare(strict_types=1);

$ip = '192.0.2.10';
$number = ip2long($ip);
if ($number === false) { throw new InvalidArgumentException('Неверный IPv4'); }
$record = sprintf('%u', $number);
$path = __DIR__ . '/inventory-address.txt';
if (file_put_contents($path, $record) === false) { throw new RuntimeException('Не удалось сохранить адрес'); }
$stored = file_get_contents($path);
if ($stored === false) { throw new RuntimeException('Не удалось прочитать адрес'); }
echo 'Числовая запись: ', $stored, "\n";
echo 'Адрес узла: ', long2ip((int)$stored), "\n";

Числовая запись: 3221225994
Адрес узла: 192.0.2.10

Представить IPv4 целым числом для старого формата данных, учитывая разрядность PHP.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это преобразование, не проверка доступности узла. Для IPv6 и независимого от int хранения удобнее inet_pton.

<?php
declare(strict_types=1);

$number = ip2long('127.0.0.1');
if ($number === false) { throw new RuntimeException('Invalid IPv4'); }
echo $number, "\n";
echo long2ip($number), "\n";

2130706433
127.0.0.1

Этот вариант. %u даёт беззнаковую текстовую запись. Не переносите такую строку бездумно в int 32-битной системы: верхняя половина диапазона там не помещается.

<?php
declare(strict_types=1);

$zero = ip2long('0.0.0.0');
var_dump($zero, $zero === false);
$all = ip2long('255.255.255.255');
echo sprintf('%u', $all), "\n";

int(0)
bool(false)
4294967295

Этот вариант. Эти исходы проверены PHP 8.5.11. Историческое обещание неполных адресов не превращается в допустимый формат новой интеграции.

<?php
declare(strict_types=1);

foreach (['127.1', '010.0.0.1', '::1', '300.1.1.1'] as $text) {
    var_dump(ip2long($text));
}

bool(false)
bool(false)
bool(false)
bool(false)

Дальше: long2ip; inet_pton.

• PHP: ip2long

PHP 4+ · standard

long2ip(int $ip): string

<?php
declare(strict_types=1);

$ip = '192.0.2.10';
$number = ip2long($ip);
if ($number === false) { throw new InvalidArgumentException('Неверный IPv4'); }
$record = sprintf('%u', $number);
$path = __DIR__ . '/inventory-address.txt';
if (file_put_contents($path, $record) === false) { throw new RuntimeException('Не удалось сохранить адрес'); }
$stored = file_get_contents($path);
if ($stored === false) { throw new RuntimeException('Не удалось прочитать адрес'); }
echo 'Числовая запись: ', $stored, "\n";
echo 'Адрес узла: ', long2ip((int)$stored), "\n";

Числовая запись: 3221225994
Адрес узла: 192.0.2.10

Восстановить текст IPv4 из числового представления старого хранилища.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Ноль не означает отсутствие записи. Для отсутствующего IP храните отдельный null/статус, а не подменяйте его специальным адресом.

<?php
declare(strict_types=1);

echo long2ip(2130706433), "\n";
echo long2ip(0), "\n";

127.0.0.1
0.0.0.0

Этот вариант. Проверенный 64-битный PHP отбрасывает старшие биты. Это не разрешение принимать такие значения в вашей базе: сначала проверяют договор 0…4294967295 либо историческое signed-представление.

<?php
declare(strict_types=1);

echo long2ip(-1), "\n";
if (PHP_INT_SIZE >= 8) {
    echo long2ip(4294967296), "\n";
    echo long2ip(4294967297), "\n";
}

255.255.255.255
0.0.0.0
0.0.0.1

При миграции 32-битного хранилища не превращайте беззнаковую строку в int до проверки: значение может измениться. Для нового смешанного IPv4/IPv6 хранилища используйте бинарное представление с явной длиной.

Дальше: ip2long; inet_ntop; inet_pton.

• PHP: long2ip

PHP 4+ · standard

getprotobyname(string $protocol): int|false

<?php
declare(strict_types=1);

require __DIR__ . '/local-net.php';
$protocol = getprotobyname('tcp');
if ($protocol === false) { throw new RuntimeException('TCP отсутствует в справочнике ОС'); }
$name = getprotobynumber($protocol);
if ($name === false) { throw new RuntimeException('Нет имени протокола'); }
echo 'Выбран протокол: ', $name, "\n";
[$listener, $client, $peer] = localTcp();
writeBytes($client, "product:1\n");
serveProduct($peer);
showProduct(readCatalogLine($client));
socket_close($peer);
socket_close($client);
socket_close($listener);

Выбран протокол: tcp
Молоток — 8 шт.

Узнать номер сетевого протокола из локального справочника ОС.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это фактическое соответствие проверенного окружения. Оно не доказывает, что сервер принимает соединения по TCP.

<?php
declare(strict_types=1);

$value = getprotobyname('tcp');
if ($value === false) { throw new RuntimeException('Protocol not in local database'); }
echo $value, "\n";

6

Этот вариант. Проверка false обязательна даже при справочном API: содержимое/доступность системной базы может отличаться.

<?php
declare(strict_types=1);

echo getprotobyname('udp'), "\n";
var_dump(getprotobyname('phpmanual_missing'));

17
bool(false)

Дальше: getprotobynumber; getservbyname; getservbyport.

• PHP: getprotobyname

PHP 4+ · standard

getprotobynumber(int $protocol): string|false

<?php
declare(strict_types=1);

require __DIR__ . '/local-net.php';
$protocol = getprotobyname('tcp');
if ($protocol === false) { throw new RuntimeException('TCP отсутствует в справочнике ОС'); }
$name = getprotobynumber($protocol);
if ($name === false) { throw new RuntimeException('Нет имени протокола'); }
echo 'Выбран протокол: ', $name, "\n";
[$listener, $client, $peer] = localTcp();
writeBytes($client, "product:1\n");
serveProduct($peer);
showProduct(readCatalogLine($client));
socket_close($peer);
socket_close($client);
socket_close($listener);

Выбран протокол: tcp
Молоток — 8 шт.

Подписать известный номер протокола именем из базы ОС.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это фактическое соответствие проверенного окружения. Оно не доказывает, что сервер принимает соединения по TCP.

<?php
declare(strict_types=1);

$value = getprotobynumber(6);
if ($value === false) { throw new RuntimeException('Protocol not in local database'); }
echo $value, "\n";

tcp

Этот вариант. Проверка false обязательна даже при справочном API: содержимое/доступность системной базы может отличаться.

<?php
declare(strict_types=1);

echo getprotobynumber(17), "\n";
var_dump(getprotobynumber(999));

udp
bool(false)

Дальше: getprotobyname; getservbyname; getservbyport.

• PHP: getprotobynumber

PHP 4+ · standard

getservbyname(string $service, string $protocol): int|false

<?php
declare(strict_types=1);

$port = getservbyname('http', 'tcp');
if ($port === false) { throw new RuntimeException('Укажите порт явно: справочник не содержит http/tcp'); }
$name = getservbyport($port, 'tcp');
echo 'Стандартная служба: ', $name === false ? 'неизвестна' : $name, "\n";
echo 'Стандартный порт TCP: ', $port, "\n";
echo "Порт собственного учебного сервера: 8791\n";

Стандартная служба: http
Стандартный порт TCP: 80
Порт собственного учебного сервера: 8791

Узнать стандартный порт службы по имени и транспортному протоколу.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Эти значения помогают показать стандартный порт в настройках. Реальный сервис может использовать другой порт из конфигурации.

<?php
declare(strict_types=1);

echo getservbyname('http', 'tcp'), "\n";
echo getservbyname('https', 'tcp'), "\n";

80
443

Этот вариант. Не подставляйте 0 автоматически после false: это меняет смысл конфигурации. Запросите явный допустимый порт или сообщите об ошибке настройки.

<?php
declare(strict_types=1);

$port = getservbyname('phpmanual_missing', 'tcp');
if ($port === false) { echo "No local service mapping\n"; }

No local service mapping

Дальше: getservbyport; getprotobyname; fsockopen.

• PHP: getservbyname

PHP 4+ · standard

getservbyport(int $port, string $protocol): string|false

<?php
declare(strict_types=1);

$port = getservbyname('http', 'tcp');
if ($port === false) { throw new RuntimeException('Укажите порт явно: справочник не содержит http/tcp'); }
$name = getservbyport($port, 'tcp');
echo 'Стандартная служба: ', $name === false ? 'неизвестна' : $name, "\n";
echo 'Стандартный порт TCP: ', $port, "\n";
echo "Порт собственного учебного сервера: 8791\n";

Стандартная служба: http
Стандартный порт TCP: 80
Порт собственного учебного сервера: 8791

Подписать номер порта справочным именем службы, не утверждая, что именно она работает.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это содержимое системной базы проверенного окружения, не сетевой запрос.

<?php
declare(strict_types=1);

echo getservbyport(80, 'tcp'), "\n";
echo getservbyport(443, 'tcp'), "\n";

http
https

Этот вариант. Отсутствие записи не означает непременно ошибку вызова. Неизвестный порт можно показать числом, а допустимость подключения решить отдельно.

<?php
declare(strict_types=1);

$port = 0;
$name = getservbyport($port, 'tcp');
echo $name === false ? 'port ' . $port : $name, "\n";

port 0

Дальше: getservbyname; getprotobynumber; fsockopen.

• PHP: getservbyport

PHP 7.3+ · standard

net_get_interfaces(): array|false

<?php
declare(strict_types=1);

$interfaces = net_get_interfaces();
if ($interfaces === false) { throw new RuntimeException('Не удалось прочитать сетевые интерфейсы'); }
$loopback = false;
foreach ($interfaces as $interface) {
    foreach ($interface['unicast'] ?? [] as $address) {
        if (($address['address'] ?? '') === '127.0.0.1') { $loopback = true; }
    }
}
if (!$loopback) { throw new RuntimeException('Для этого стенда нужен IPv4 loopback'); }
$json = json_encode($interfaces, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR);
if (file_put_contents(__DIR__ . '/interfaces.json', $json) === false) { throw new RuntimeException('Не удалось записать диагностику'); }
echo "Учебный стенд использует 127.0.0.1\nПодробности интерфейсов: interfaces.json\n";

Учебный стенд использует 127.0.0.1
Подробности интерфейсов: interfaces.json

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

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Точный список зависит от машины, поэтому пример не утверждает фиксированное количество сетевых карт и не печатает внутренние данные.

<?php
declare(strict_types=1);

$interfaces = net_get_interfaces();
if ($interfaces === false) { throw new RuntimeException('Cannot read interfaces'); }
var_dump(is_array($interfaces));

bool(true)

Этот вариант. Этот опыт проверяет форму результата текущей ОС. Для вывода отдельных адресов нужно обработать отсутствующие optional-поля и повторить вложенный цикл; up не заменяет проверку конкретного маршрута/сервиса.

<?php
declare(strict_types=1);

$interfaces = net_get_interfaces();
if ($interfaces === false) { throw new RuntimeException('Cannot read interfaces'); }
$valid = true;
foreach ($interfaces as $name => $data) {
    if (!is_string($name) || !is_array($data)) { $valid = false; break; }
    if (isset($data['unicast']) && !is_array($data['unicast'])) { $valid = false; break; }
}
var_dump($valid);

bool(true)

Дальше: gethostname; inet_pton; inet_ntop.

• PHP: net_get_interfaces

PHP 4+ · standard

gethostbyname(string $hostname): string

<?php
declare(strict_types=1);

$ip = gethostbyname('127.0.0.1');
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) === false || $ip !== '127.0.0.1') { throw new RuntimeException('Ожидался учебный loopback'); }
require __DIR__ . '/base.php';
$client = curl_init($base . '/product?id=1');
if ($client === false) { throw new RuntimeException('cURL не создал клиент'); }
curl_setopt_array($client, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 2, CURLOPT_CONNECTTIMEOUT => 1]);
$body = curl_exec($client);
if ($body === false) { throw new RuntimeException('Нет ответа: '.curl_error($client)); }
if (curl_getinfo($client, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException('Сервис отклонил запрос'); }
echo $body;

Молоток — 8 шт.

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

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Здесь не нужен внешний DNS-сервер. Числовой адрес и имя — разные виды входа; localhost не означает имя сайта посетителя.

<?php
declare(strict_types=1);

$ip = gethostbyname('127.0.0.1');
echo $ip, "\n";
var_dump(filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) !== false);

127.0.0.1
bool(true)

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа.

<?php
declare(strict_types=1);

$host = 'example.com';
$ip = gethostbyname($host);
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) === false) {
    echo "IPv4 unavailable\n";
} else {
    echo "IPv4 available\n";
}

IPv4 available

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

Если проверяете адрес перед исходящим HTTP-запросом, помните про повторный DNS lookup: между проверкой и подключением ответ может измениться. Одна проверка gethostbyname не защищает от SSRF/DNS rebinding; правила доступа и привязку соединения реализуют в HTTP-клиенте и сетевой политике.

Дальше: gethostbynamel; dns_get_record; inet_pton.

• PHP: gethostbyname

PHP 4+ · standard

gethostbynamel(string $hostname): array|false

<?php
declare(strict_types=1);

$addresses = gethostbynamel('127.0.0.1');
if ($addresses === false) { throw new RuntimeException('Нет адресов'); }
$ip = $addresses[0];
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) === false || $ip !== '127.0.0.1') { throw new RuntimeException('Ожидался учебный loopback'); }
require __DIR__ . '/base.php';
$client = curl_init($base . '/product?id=1');
if ($client === false) { throw new RuntimeException('cURL не создал клиент'); }
curl_setopt_array($client, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 2, CURLOPT_CONNECTTIMEOUT => 1]);
$body = curl_exec($client);
if ($body === false) { throw new RuntimeException('Нет ответа: '.curl_error($client)); }
if (curl_getinfo($client, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException('Сервис отклонил запрос'); }
echo $body;

Молоток — 8 шт.

Получить список IPv4 одного имени, например для диагностической панели с несколькими A-записями.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Даже один результат находится в массиве. foreach берёт значение каждой ячейки; это не преобразование JSON.

<?php
declare(strict_types=1);

$addresses = gethostbynamel('127.0.0.1');
if ($addresses === false) { throw new RuntimeException('Address unavailable'); }
foreach ($addresses as $ip) { echo $ip, "\n"; }

127.0.0.1

Этот вариант. Это явная fixture ответа, не реальное DNS-разрешение. array_unique убирает одинаковые строки, array_values восстанавливает последовательные ключи, sort задаёт стабильное текстовое оформление отчёта. Порядок для балансировки нагрузки так не выбирают.

<?php
declare(strict_types=1);

$addresses = ['192.0.2.20', '192.0.2.10', '192.0.2.20'];
$unique = array_values(array_unique($addresses));
sort($unique, SORT_STRING);
echo implode(', ', $unique), "\n";

192.0.2.10, 192.0.2.20

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

Дальше: gethostbyname; dns_get_record.

• PHP: gethostbynamel

PHP 4+ · standard

gethostbyaddr(string $ip): string|false

<?php
declare(strict_types=1);

if (getenv('PHP_MANUAL_DNS_LAB') !== 'isolated') { throw new RuntimeException('Сначала настройте изолированный DNS-стенд по README'); }
$name = gethostbyaddr('127.0.0.1');
if ($name === false || $name === '127.0.0.1') { throw new RuntimeException('PTR не получен'); }
echo 'Узел отчёта: ', $name, "\n";

Узел отчёта: catalog.phpmanual.test

Найти обратное имя по IP, чтобы дополнить технический журнал понятным обозначением узла.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это контролируемая проверка известного предупреждения. Анонимная функция служит обработчиком; use (&$warnings) даёт ей доступ к внешнему счётчику по ссылке. В рабочем коде сперва проверяют вход, не скрывают произвольные ошибки.

<?php
declare(strict_types=1);

$warnings = 0;
set_error_handler(function (int $level, string $message) use (&$warnings): bool {
    if ($level !== E_WARNING) { return false; }
    $warnings++;
    return true;
});
try { $name = gethostbyaddr('not an IP'); }
finally { restore_error_handler(); }
var_dump($name);
echo $warnings, "\n";

bool(false)
1

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа. Учебный диапазон не представляет реальный сервер.

<?php
declare(strict_types=1);

$ip = '192.0.2.10';
if (filter_var($ip, FILTER_VALIDATE_IP) === false) {
    throw new InvalidArgumentException('Invalid IP');
}
$name = gethostbyaddr($ip);
if ($name === false) { echo "Lookup failed\n"; }
elseif ($name === $ip) { echo "No reverse name\n"; }
else { echo "Reverse name found\n"; }

No reverse name

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

Дальше: gethostbyname; inet_pton.

• PHP: gethostbyaddr

PHP 5.3+ · standard

gethostname(): string|false

<?php
declare(strict_types=1);

$host = gethostname();
if ($host === false || $host === '') { throw new RuntimeException('Имя машины неизвестно'); }
$report = ['worker'=>$host, 'product'=>['name'=>'Молоток','stock'=>8]];
$json = json_encode($report, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR);
if (file_put_contents(__DIR__ . '/worker-report.json', $json) === false) { throw new RuntimeException('Отчёт не записан'); }
echo "Молоток — 8 шт.\nМашина-исполнитель указана в worker-report.json\n";

Молоток — 8 шт.
Машина-исполнитель указана в worker-report.json

Узнать имя машины, выполняющей PHP, например для внутренней диагностики нескольких обработчиков очереди.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. На проверенной машине имя непустое. Значение у вас будет своим; в тесте проверяется договор, а не конкретная конфигурация компьютера.

<?php
declare(strict_types=1);

$name = gethostname();
var_dump(is_string($name) && $name !== '');

bool(true)

Этот вариант. false задан как fixture отказа gethostname. Условное выражение condition ? yes : no выбирает запасную подпись; оно не исправляет саму системную ошибку.

<?php
declare(strict_types=1);

$systemName = false;
$workerLabel = $systemName === false ? 'worker-unknown' : $systemName;
echo $workerLabel, "\n";

worker-unknown

Дальше: gethostbyname; net_get_interfaces.

• PHP: gethostname

PHP 4+ · standard

checkdnsrr(string $hostname, string $type = "MX"): bool

<?php
declare(strict_types=1);

if (getenv('PHP_MANUAL_DNS_LAB') !== 'isolated') { throw new RuntimeException('Сначала настройте изолированный DNS-стенд по README'); }
if (checkdnsrr('catalog.phpmanual.test.', 'AAAA')) { echo "В учебной зоне есть IPv6-адрес каталога\n"; } else { echo "Запись не найдена или resolver недоступен\n"; }

В учебной зоне есть IPv6-адрес каталога

Проверить наличие DNS-записей указанного типа, не загружая их содержимое в приложение.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа.

<?php
declare(strict_types=1);

$found = checkdnsrr('example.com', 'A');
echo $found ? "Record found\n" : "No record or lookup error\n";

Record found

Этот вариант. try/catch ловит ошибку аргумента. Эти неверные значения отклоняются до внешнего DNS-вопроса.

<?php
declare(strict_types=1);

try { checkdnsrr('', 'A'); }
catch (ValueError $error) { echo "Empty hostname rejected\n"; }
try { checkdnsrr('example.com', 'NOT_A_TYPE'); }
catch (ValueError $error) { echo "Unknown type rejected\n"; }

Empty hostname rejected
Unknown type rejected

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

Для регистрации пользователя DNS может быть дополнительным диагностическим сигналом. Доставляемость и владение ящиком подтверждают письмом с одноразовым действием. Наличие MX не доказывает существование конкретного адресата, а отсутствие MX само по себе не исчерпывает правила SMTP.

Дальше: dns_get_record; getmxrr.

• PHP: checkdnsrr

PHP 5+ · standard

dns_check_record(string $hostname, string $type = "MX"): bool

<?php
declare(strict_types=1);

if (getenv('PHP_MANUAL_DNS_LAB') !== 'isolated') { throw new RuntimeException('Сначала настройте изолированный DNS-стенд по README'); }
if (checkdnsrr('catalog.phpmanual.test.', 'AAAA')) { echo "В учебной зоне есть IPv6-адрес каталога\n"; } else { echo "Запись не найдена или resolver недоступен\n"; }

В учебной зоне есть IPv6-адрес каталога

Проверить наличие DNS-записей указанного типа, не загружая их содержимое в приложение.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

dns_check_record — другое имя той же функции checkdnsrr. Семантика, ограничения и результат совпадают; смена имени не делает проверку строже.

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа.

<?php
declare(strict_types=1);

$found = dns_check_record('example.com', 'A');
echo $found ? "Record found\n" : "No record or lookup error\n";

Record found

Этот вариант. try/catch ловит ошибку аргумента. Эти неверные значения отклоняются до внешнего DNS-вопроса.

<?php
declare(strict_types=1);

try { dns_check_record('', 'A'); }
catch (ValueError $error) { echo "Empty hostname rejected\n"; }
try { dns_check_record('example.com', 'NOT_A_TYPE'); }
catch (ValueError $error) { echo "Unknown type rejected\n"; }

Empty hostname rejected
Unknown type rejected

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

Для регистрации пользователя DNS может быть дополнительным диагностическим сигналом. Доставляемость и владение ящиком подтверждают письмом с одноразовым действием. Наличие MX не доказывает существование конкретного адресата, а отсутствие MX само по себе не исчерпывает правила SMTP.

Дальше: dns_get_record; getmxrr.

• PHP: dns_check_record

PHP 4+ · standard

getmxrr(string $hostname, array &$hosts, array &$weights = null): bool

<?php
declare(strict_types=1);

if (getenv('PHP_MANUAL_DNS_LAB') !== 'isolated') { throw new RuntimeException('Сначала настройте изолированный DNS-стенд по README'); }
if (!getmxrr('phpmanual.test.', $hosts, $weights)) { throw new RuntimeException('MX не получены'); }
foreach ($hosts as $index=>$host) { echo 'Почтовый узел: ', $host, '; приоритет ', $weights[$index], "\n"; }

Почтовый узел: mail.phpmanual.test; приоритет 10

Получить имена почтовых обменников и их приоритеты для диагностики домена.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа. Конкретный MX-набор домена может меняться, включая специальную Null MX-запись.

<?php
declare(strict_types=1);

$hosts = [];
$preferences = [];
$ok = getmxrr('example.com', $hosts, $preferences);
if (!$ok) { echo "No MX or lookup error\n"; }
else { echo "MX query returned data\n"; }

No MX or lookup error

Этот вариант. Это fixture пары выходных массивов. Стрелочная функция сравнивает preference через <=>, возвращая отрицательное число, ноль или положительное. Независимая сортировка двух массивов потеряла бы связь. При одинаковом предпочтении нужны правила SMTP-клиента, а не случайная бизнес-сортировка.

<?php
declare(strict_types=1);

$hosts = ['backup.example.com', 'primary.example.com'];
$preferences = [20, 10];
$records = [];
foreach ($hosts as $index => $host) {
    $records[] = ['host' => $host, 'preference' => $preferences[$index]];
}
usort($records, fn(array $a, array $b): int => $a['preference'] <=> $b['preference']);
foreach ($records as $record) {
    echo $record['preference'], ': ', $record['host'], "\n";
}

10: primary.example.com
20: backup.example.com

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

MX-диагностика не заменяет отправку письма. Правила SMTP допускают fallback при отсутствии MX; специальная Null MX, напротив, явно сообщает, что домен не принимает почту. Их должен учитывать почтовый транспорт. Не пишите собственную валидацию ящика как «MX false → адрес запрещён».

Дальше: dns_get_record; checkdnsrr.

• PHP: getmxrr

PHP 5+ · standard

dns_get_mx(string $hostname, array &$hosts, array &$weights = null): bool

<?php
declare(strict_types=1);

if (getenv('PHP_MANUAL_DNS_LAB') !== 'isolated') { throw new RuntimeException('Сначала настройте изолированный DNS-стенд по README'); }
if (!getmxrr('phpmanual.test.', $hosts, $weights)) { throw new RuntimeException('MX не получены'); }
foreach ($hosts as $index=>$host) { echo 'Почтовый узел: ', $host, '; приоритет ', $weights[$index], "\n"; }

Почтовый узел: mail.phpmanual.test; приоритет 10

Получить имена почтовых обменников и их приоритеты для диагностики домена.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

dns_get_mx — псевдоним getmxrr: те же выходные массивы и тот же результат. Отдельного DNS-механизма за этим именем нет.

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа. Конкретный MX-набор домена может меняться, включая специальную Null MX-запись.

<?php
declare(strict_types=1);

$hosts = [];
$preferences = [];
$ok = dns_get_mx('example.com', $hosts, $preferences);
if (!$ok) { echo "No MX or lookup error\n"; }
else { echo "MX query returned data\n"; }

No MX or lookup error

Этот вариант. Это fixture пары выходных массивов. Стрелочная функция сравнивает preference через <=>, возвращая отрицательное число, ноль или положительное. Независимая сортировка двух массивов потеряла бы связь. При одинаковом предпочтении нужны правила SMTP-клиента, а не случайная бизнес-сортировка.

<?php
declare(strict_types=1);

$hosts = ['backup.example.com', 'primary.example.com'];
$preferences = [20, 10];
$records = [];
foreach ($hosts as $index => $host) {
    $records[] = ['host' => $host, 'preference' => $preferences[$index]];
}
usort($records, fn(array $a, array $b): int => $a['preference'] <=> $b['preference']);
foreach ($records as $record) {
    echo $record['preference'], ': ', $record['host'], "\n";
}

10: primary.example.com
20: backup.example.com

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

MX-диагностика не заменяет отправку письма. Правила SMTP допускают fallback при отсутствии MX; специальная Null MX, напротив, явно сообщает, что домен не принимает почту. Их должен учитывать почтовый транспорт. Не пишите собственную валидацию ящика как «MX false → адрес запрещён».

Дальше: dns_get_record; checkdnsrr.

• PHP: dns_get_mx

PHP 5+ · standard

dns_get_record(string $hostname, int $type = DNS_ANY, array &$authoritative_name_servers = null, array &$additional_records = null, bool $raw = false): array|false

<?php
declare(strict_types=1);

if (getenv('PHP_MANUAL_DNS_LAB') !== 'isolated') { throw new RuntimeException('Сначала настройте изолированный DNS-стенд по README'); }
$records = dns_get_record('catalog.phpmanual.test.', DNS_A | DNS_AAAA);
if ($records === false) { throw new RuntimeException('Ответ DNS недоступен'); }
$lines = [];
foreach ($records as $record) {
    $address = $record['type'] === 'A' ? $record['ip'] : ($record['ipv6'] ?? null);
    if ($address !== null) { $lines[] = $record['type'].': '.$address; }
}
sort($lines, SORT_STRING);
echo implode("\n", $lines), "\n";

A: 127.0.0.1
AAAA: ::1

Получить структурированные DNS-записи: адреса, почтовые серверы, TXT и другие данные для технического инструмента.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Это законченный пример обращения к resolver, но адреса, порядок и наличие ответа зависят от среды. В сборке проверен синтаксис; внешняя DNS-сеть не считается проверенной. Показан исход для указанного условного ответа.

<?php
declare(strict_types=1);

$authority = [];
$additional = [];
$records = dns_get_record('example.com', DNS_A | DNS_AAAA, $authority, $additional);
if ($records === false) { echo "Lookup failed\n"; }
else { echo "Records received\n"; }

Records received

Этот вариант. Здесь явная fixture, чтобы результат не зависел от сети. Массив records хранит записи, record — одну запись, квадратные скобки выбирают подписанное поле. Ключ ip есть не у каждого типа, поэтому перед чтением выбирается ветка.

<?php
declare(strict_types=1);

$records = [
    ['host' => 'api.example.com', 'class' => 'IN', 'type' => 'A', 'ttl' => 60, 'ip' => '192.0.2.10'],
    ['host' => 'api.example.com', 'class' => 'IN', 'type' => 'AAAA', 'ttl' => 60, 'ipv6' => '2001:db8::10'],
];
foreach ($records as $record) {
    if ($record['type'] === 'A') { echo $record['ip'], "\n"; }
    elseif ($record['type'] === 'AAAA') { echo $record['ipv6'], "\n"; }
}

192.0.2.10
2001:db8::10

Этот вариант. A случайно совпадает с номером 1, но AAAA-константа не равна номеру типа 28. Для raw AAAA передавали бы 28; для обычного разобранного ответа — DNS_AAAA.

<?php
declare(strict_types=1);

try { dns_get_record('example.com', 0, $authority, $additional, true); }
catch (ValueError $error) { echo "Raw type must be 1..65535\n"; }
echo DNS_A === 1 ? "A happens to match\n" : "Different value\n";
var_dump(DNS_AAAA === 28);

Raw type must be 1..65535
A happens to match
bool(false)

Этот вариант. Fixture иллюстрирует два независимых правила: срок отрицательного кэша по SOA ограничен минимумом этих TTL; критический флаг CAA проверяется маской 128. Полноценная политика выдачи сертификатов гораздо шире этой проверки.

<?php
declare(strict_types=1);

$soa = ['ttl' => 600, 'minimum-ttl' => 300];
echo min($soa['ttl'], $soa['minimum-ttl']), "\n";
$caa = ['flags' => 128, 'tag' => 'issue', 'value' => 'ca.example'];
var_dump(($caa['flags'] & 128) !== 0);

300
bool(true)

TTL ответа может быть оставшимся временем в кэше resolver; это не обязательно исходный TTL зоны. Адрес rname SOA использует DNS-экранирование: нельзя без разбора заменить все точки на @. Несколько TXT-частей одного record и несколько отдельных TXT-record — разные структуры.

DNS — распределённый справочник. Запрос может ждать системный resolver и зависеть от сети, кэша, hosts-файла, DNS-настроек и платформы. У этих функций нет отдельного параметра timeout; таймаут HTTP-клиента не задаёт автоматически срок их выполнения. Для массовой проверки используют очередь, ограничение параллельности и кэш с подходящим сроком. Публичный DNS не заменяет проверку права пользователя на ресурс.

Уточнения форматов: RFC 2308, отрицательный кэш; RFC 3403, NAPTR; RFC 8659, CAA; RFC 8482, ограниченные ANY-ответы. Здесь исправлены неточные краткие аналогии в таблице PHP.net, а не повторены как правила протокола.

Дальше: gethostbynamel; getmxrr; checkdnsrr.

• PHP: dns_get_record

PHP 5+ · standard

headers_list(): array

<?php
declare(strict_types=1);

header('Content-Type: text/plain; charset=UTF-8');
header('X-Catalog: workshop');
foreach (headers_list() as $line) {
    if (str_starts_with($line, 'X-Catalog:')) { echo $line, "\n"; }
}
echo "Молоток — 8 шт.\n";

X-Catalog: workshop
Молоток — 8 шт.

Посмотреть исходящие заголовки текущего PHP-ответа при диагностике обработчика.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Эти примеры ответа запускаются через HTTP-сервер. Код PHP CLI не отправляет ответ браузеру: успешный вызов там не доказывает правильность HTTP-заголовков. Заголовки — метаданные ответа, echo — его тело. Сначала формируют статус и метаданные, затем тело. Пробел до <?php, UTF-8 BOM, вывод подключённого файла и сообщение об ошибке тоже могут начать тело.

Этот вариант. Не сравниваем весь список с жёстко заданным массивом: PHP/SAPI может добавить Content-Type или X-Powered-By.

<?php
declare(strict_types=1);

header('X-Report: inventory');
$found = false;
foreach (headers_list() as $line) {
    if ($line === 'X-Report: inventory') { $found = true; }
}
var_dump($found);

bool(true)

Этот вариант. Этот пример предназначен именно для CLI. Пустой список здесь не доказывает, что такой же код не работает при HTTP-запросе. Не используйте CLI-тест как проверку отправленного Set-Cookie.

<?php
declare(strict_types=1);

header('X-Report: inventory');
var_dump(headers_list());

array(0) {
}

Дальше: header; headers_sent; http_get_last_response_headers.

• PHP: headers_list

PHP 5.3+ · standard

header_remove(?string $name = null): void

<?php
declare(strict_types=1);

header('X-Debug-Token: temporary');
header('X-Catalog: workshop');
header_remove('X-Debug-Token');
header('Content-Type: text/plain; charset=UTF-8');
echo "Молоток — 8 шт.\n";

Молоток — 8 шт.

Удалить ошибочно подготовленный заголовок до отправки ответа клиенту.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Эти примеры ответа запускаются через HTTP-сервер. Код PHP CLI не отправляет ответ браузеру: успешный вызов там не доказывает правильность HTTP-заголовков. Заголовки — метаданные ответа, echo — его тело. Сначала формируют статус и метаданные, затем тело. Пробел до <?php, UTF-8 BOM, вывод подключённого файла и сообщение об ошибке тоже могут начать тело.

Этот вариант. Проверка работает с expose_php=0: иначе серверная конфигурация может добавить X-Powered-By. В рабочем приложении выбирают собственные диагностируемые имена.

<?php
declare(strict_types=1);

header('X-Lesson: temporary');
header('X-Keep: retained');
header_remove('x-lesson');
foreach (headers_list() as $line) {
    if (str_starts_with($line, 'X-')) { echo $line, "\n"; }
}

X-Keep: retained

Этот вариант. Cookie была поставлена в ответ, но удаление всех заголовков отменило эту отправку. Уже сохранённые браузером cookies так не удаляются: для них нужен истёкший Set-Cookie.

<?php
declare(strict_types=1);

header('X-Lesson: temporary');
setcookie('lesson', 'ready', ['path' => '/']);
header_remove();
$hasCookie = false;
foreach (headers_list() as $line) {
    if (str_starts_with($line, 'Set-Cookie:')) { $hasCookie = true; }
}
var_dump($hasCookie);

bool(false)

Дальше: header; headers_list; setcookie.

• PHP: header_remove

PHP 5.4+ · standard

header_register_callback(callable $callback): bool

<?php
declare(strict_types=1);

header_register_callback(function (): void {
    header('X-Report-State: prepared');
});
header('Content-Type: text/plain; charset=UTF-8');
echo "Молоток — 8 шт.\n";

Молоток — 8 шт.

Выполнить завершающую настройку заголовков непосредственно перед их отправкой.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Эти примеры ответа запускаются через HTTP-сервер. Код PHP CLI не отправляет ответ браузеру: успешный вызов там не доказывает правильность HTTP-заголовков. Заголовки — метаданные ответа, echo — его тело. Сначала формируют статус и метаданные, затем тело. Пробел до <?php, UTF-8 BOM, вывод подключённого файла и сообщение об ошибке тоже могут начать тело.

Этот вариант. function (): void объявляет анонимную функцию без аргументов и без возвращаемого значения. PHP вызовет её позже; тело ответа ready, а наличие X-Lesson-Final проверяют в HTTP-заголовках.

<?php
declare(strict_types=1);

header_register_callback(function (): void {
    header('X-Lesson-Final: ready');
});
echo "ready\n";

ready

Этот вариант. В ответе будет X-Lesson-Second и не будет X-Lesson-First. В приложении с несколькими библиотеками согласуйте владельца этого единственного callback.

<?php
declare(strict_types=1);

header_register_callback(function (): void { header('X-Lesson-First: yes'); });
header_register_callback(function (): void { header('X-Lesson-Second: yes'); });
echo "ready\n";

ready

Не печатайте echo/var_dump внутри callback: это может нарушить формирование ответа. Не путайте его с обработчиком ob_start: тот получает содержимое буфера и возвращает преобразованный текст.

Дальше: headers_list; header; header_remove.

• PHP: header_register_callback

PHP 8.4+ · standard

http_get_last_response_headers(): ?array

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
http_clear_last_response_headers();
$context = stream_context_create(['http'=>['timeout'=>2]]);
$body = file_get_contents($base . '/product?id=1', false, $context);
if ($body === false) { throw new RuntimeException('Каталог недоступен'); }
$headers = http_get_last_response_headers();
foreach ($headers ?? [] as $line) {
    if (str_starts_with(strtolower($line), 'x-catalog:')) { echo $line, "\n"; }
}
echo $body;
http_clear_last_response_headers();
if (http_get_last_response_headers() !== null) { throw new RuntimeException('Старый ответ остался'); }
echo "Состояние очищено для следующего запроса\n";

X-Catalog: workshop
Молоток — 8 шт.
Состояние очищено для следующего запроса

Прочитать заголовки последнего ответа, полученного PHP HTTP-wrapper при исходящем запросе.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Сброс не удаляет какие-либо файлы или данные сайта: очищается только это сохранённое состояние wrapper в текущем PHP-выполнении.

<?php
declare(strict_types=1);

http_clear_last_response_headers();
var_dump(http_get_last_response_headers());

NULL

Этот вариант. PHP_MANUAL_HTTP_BASE задаётся запускающим тестом и указывает только на собственную loopback-fixture. Этот пример действительно проверяется HTTP-запросом отдельно; обычная проверка карточки проверяет синтаксис.

<?php
declare(strict_types=1);

$base = getenv('PHP_MANUAL_HTTP_BASE');
if (!is_string($base) || $base === '') { throw new RuntimeException('Start the local HTTP fixture'); }
http_clear_last_response_headers();
$context = stream_context_create(['http' => ['timeout' => 2]]);
$body = file_get_contents($base . '/ok', false, $context);
if ($body === false) { throw new RuntimeException('Request failed'); }
$headers = http_get_last_response_headers();
var_dump(is_array($headers));
http_clear_last_response_headers();
var_dump(http_get_last_response_headers());

bool(true)
NULL

Если сервер вернул 4xx/5xx, наличие заголовков не превращает ответ в успех. Для чтения тела ошибки у wrapper учитывают ignore_errors, затем отдельно анализируют фактический статус. Состояние удобно сбрасывать перед операцией и сохранять после неё в собственной переменной.

Дальше: http_clear_last_response_headers; headers_list.

• PHP: http_get_last_response_headers

PHP 8.4+ · standard

http_clear_last_response_headers(): void

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
http_clear_last_response_headers();
$context = stream_context_create(['http'=>['timeout'=>2]]);
$body = file_get_contents($base . '/product?id=1', false, $context);
if ($body === false) { throw new RuntimeException('Каталог недоступен'); }
$headers = http_get_last_response_headers();
foreach ($headers ?? [] as $line) {
    if (str_starts_with(strtolower($line), 'x-catalog:')) { echo $line, "\n"; }
}
echo $body;
http_clear_last_response_headers();
if (http_get_last_response_headers() !== null) { throw new RuntimeException('Старый ответ остался'); }
echo "Состояние очищено для следующего запроса\n";

X-Catalog: workshop
Молоток — 8 шт.
Состояние очищено для следующего запроса

Очистить сохранённые заголовки исходящего HTTP-wrapper, чтобы не принять старый ответ за новый.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Этот вариант. Сброс не удаляет какие-либо файлы или данные сайта: очищается только это сохранённое состояние wrapper в текущем PHP-выполнении.

<?php
declare(strict_types=1);

http_clear_last_response_headers();
var_dump(http_get_last_response_headers());

NULL

Этот вариант. PHP_MANUAL_HTTP_BASE задаётся запускающим тестом и указывает только на собственную loopback-fixture. Этот пример действительно проверяется HTTP-запросом отдельно; обычная проверка карточки проверяет синтаксис.

<?php
declare(strict_types=1);

$base = getenv('PHP_MANUAL_HTTP_BASE');
if (!is_string($base) || $base === '') { throw new RuntimeException('Start the local HTTP fixture'); }
http_clear_last_response_headers();
$context = stream_context_create(['http' => ['timeout' => 2]]);
$body = file_get_contents($base . '/ok', false, $context);
if ($body === false) { throw new RuntimeException('Request failed'); }
$headers = http_get_last_response_headers();
var_dump(is_array($headers));
http_clear_last_response_headers();
var_dump(http_get_last_response_headers());

bool(true)
NULL

Если сервер вернул 4xx/5xx, наличие заголовков не превращает ответ в успех. Для чтения тела ошибки у wrapper учитывают ignore_errors, затем отдельно анализируют фактический статус. Состояние удобно сбрасывать перед операцией и сохранять после неё в собственной переменной.

Дальше: http_get_last_response_headers; headers_list.

• PHP: http_clear_last_response_headers

PHP 5+ · standard

setrawcookie(string $name, string $value = "", int|array $expires_or_options = 0, string $path = "", string $domain = "", bool $secure = false, bool $httponly = false): bool

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$client = curl_init($base . '/product?id=1');
if ($client === false) { throw new RuntimeException('cURL не создал клиент'); }
curl_setopt_array($client, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 2, CURLOPT_CONNECTTIMEOUT => 1]);
curl_setopt($client, CURLOPT_COOKIEFILE, '');
curl_setopt($client, CURLOPT_URL, $base . '/cookie/raw');
$body = curl_exec($client);
if ($body === false) { throw new RuntimeException('Нет ответа: '.curl_error($client)); }
if (curl_getinfo($client, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException('Сервис отклонил запрос'); }
echo $body;
curl_setopt($client, CURLOPT_URL, $base . '/cookie/read');
$body = curl_exec($client);
if ($body === false) { throw new RuntimeException('Нет ответа: '.curl_error($client)); }
if (curl_getinfo($client, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException('Сервис отклонил запрос'); }
echo $body;

Тема входящего запроса: не выбрана
Тема следующего запроса: blue sky

Отправить заранее допустимое значение cookie без дополнительного URL-кодирования, если формат задаёт внешний протокол.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сначала браузер отправляет запрос с уже имеющимися cookies; PHP заполняет $_COOKIE. Затем setcookie добавляет Set-Cookie в ответ. Если браузер принял его, значение вернётся в следующем подходящем запросе. Поэтому новый вызов сам по себе не переписывает текущий $_COOKIE. Для текущего вычисления используйте свою переменную.

Этот вариант. Здесь намеренно показан percent-encoded фрагмент: setcookie кодирует символ % ещё раз, setrawcookie сохраняет его. Выбор зависит от согласованного формата клиента; при входе PHP декодирует проценты.

<?php
declare(strict_types=1);

setcookie('lesson_encoded', 'a%2Fb', ['path' => '/']);
setrawcookie('lesson_raw', 'a%2Fb', ['path' => '/']);
foreach (headers_list() as $line) {
    if (str_starts_with($line, 'Set-Cookie: lesson_')) { echo $line, "\n"; }
}

Set-Cookie: lesson_encoded=a%252Fb; path=/
Set-Cookie: lesson_raw=a%2Fb; path=/

Этот вариант. Тест ловит ожидаемые ошибки аргументов и выводит результат после цикла. Для обычной пользовательской настройки выбирают setcookie, а не самодельное удаление запрещённых символов.

<?php
declare(strict_types=1);

$rejected = 0;
foreach (['two words', 'a;b', "a\nb"] as $value) {
    try { setrawcookie('lesson_raw', $value); }
    catch (ValueError $error) { $rejected++; }
}
echo $rejected, "\n";

3

Дальше: setcookie; header.

• PHP: setrawcookie

PHP 8.4+ · standard

request_parse_body(?array $options = null): array

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$client = curl_init($base . '/product?id=1');
if ($client === false) { throw new RuntimeException('cURL не создал клиент'); }
curl_setopt_array($client, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 2, CURLOPT_CONNECTTIMEOUT => 1]);
curl_setopt_array($client, [CURLOPT_URL=>$base . '/parse-body', CURLOPT_CUSTOMREQUEST=>'PUT', CURLOPT_HTTPHEADER=>['Content-Type: application/x-www-form-urlencoded'], CURLOPT_POSTFIELDS=>http_build_query(['name'=>'Молоток', 'stock'=>'8'], '', '&')]);
$body = curl_exec($client);
if ($body === false) { throw new RuntimeException('Нет ответа: '.curl_error($client)); }
if (curl_getinfo($client, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException('Сервис отклонил запрос'); }
$data = json_decode($body, true, 8, JSON_THROW_ON_ERROR);
echo $data['fields']['name'], ' — ', $data['fields']['stock'], " шт.\n";

Молоток — 8 шт.

Разобрать поля и файлы multipart/URL-encoded запроса PUT/PATCH, для которого PHP не заполняет $_POST автоматически.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сначала нужна связь HTML name → поле запроса. Здесь клиентом может быть JavaScript fetch или другой сервис. POST, PUT и PATCH — методы HTTP; их имена сами по себе не проверяют права пользователя. Поля формы после разбора остаются строками/массивами, а не готовыми числами или доверенными файлами.

Этот вариант. HTTP-fixture отправляет PUT с Content-Type application/x-www-form-urlencoded и телом title=Lamp&quantity=2. Данные показаны text/plain; для HTML нужен htmlspecialchars. Перед сохранением дополнительно проверяют авторизацию, CSRF для cookie-сессии и бизнес-ограничения.

<?php
declare(strict_types=1);

if ($_SERVER['REQUEST_METHOD'] !== 'PUT') { http_response_code(405); exit; }
try { [$fields, $files] = request_parse_body(['post_max_size' => '16K', 'max_input_vars' => 10]); }
catch (RequestParseBodyException $error) { http_response_code(400); echo "Invalid body\n"; exit; }
$title = $fields['title'] ?? null;
$quantity = $fields['quantity'] ?? null;
if (!is_string($title) || !is_string($quantity)) { http_response_code(422); exit; }
$count = filter_var($quantity, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1, 'max_range' => 99]]);
if ($count === false) { http_response_code(422); exit; }
header('Content-Type: text/plain; charset=UTF-8');
echo $title, ': ', $count, "\n";
echo count($files), " files\n";

Lamp: 2
0 files

Этот вариант. Собственная HTTP-fixture отправляет multipart PUT: поле title=Sample и document с содержимым hello плюс перевод строки. Клиентские filename/type не считаются безопасным путём/доказательством MIME; для сохранения следуют правилам загрузки файлов, а не доверяют этим полям.

<?php
declare(strict_types=1);

try { [$fields, $files] = request_parse_body(['post_max_size' => '32K', 'upload_max_filesize' => '16K', 'max_file_uploads' => 1]); }
catch (RequestParseBodyException $error) { http_response_code(400); echo "Invalid upload\n"; exit; }
$file = $files['document'] ?? null;
if (!is_array($file) || ($file['error'] ?? null) !== UPLOAD_ERR_OK) { http_response_code(422); exit; }
if (!is_string($file['tmp_name']) || !is_uploaded_file($file['tmp_name'])) { http_response_code(422); exit; }
echo $fields['title'] === 'Sample' ? "Title received\n" : "Other title\n";
echo filesize($file['tmp_name']), " bytes\n";

Title received
6 bytes

Этот вариант. Fixture отправляет PUT с application/json. Для JSON endpoint отдельно ограничивает размер, читает php://input и вызывает json_decode с обработкой ошибок; повторно читать то же тело другим способом не планируют.

<?php
declare(strict_types=1);

try { request_parse_body(); echo "Parsed\n"; }
catch (RequestParseBodyException $error) { http_response_code(415); echo "Unsupported body format\n"; }

Unsupported body format

Этот вариант. Неверный ключ — ошибка программиста в настройке. Не маскируйте её одним общим catch как «пользователь неправильно заполнил форму».

<?php
declare(strict_types=1);

try { request_parse_body(['unexpected_limit' => 10]); }
catch (ValueError $error) { echo "Invalid parser option\n"; }

Invalid parser option

Для max_input_vars/max_file_uploads задают количество, для post_max_size/upload_max_filesize допустимы размеры вроде 16K. max_multipart_body_parts ограничивает части multipart независимо от отдельных количеств полей/файлов. Новые лимиты парсера не отменяют ограничения веб-сервера, reverse proxy и приложения. Безопасное сохранение загруженного файла продолжает пример.

Дальше: header; http_response_code.

• PHP: request_parse_body

PHP 4+ · standard

fsockopen(string $hostname, int $port = -1, int &$error_code = null, string &$error_message = null, ?float $timeout = null): resource|false

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$url = parse_url($base);
$stream = fsockopen('127.0.0.1', $url['port'], $errorCode, $errorMessage, 1);
if ($stream === false) { throw new RuntimeException('Локальный сервер недоступен: '.$errorMessage); }
if (!stream_set_timeout($stream, 2)) { throw new RuntimeException('Не установлен timeout чтения'); }
$request = "GET /product?id=1 HTTP/1.1\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n";
$offset = 0;
while ($offset < strlen($request)) {
    $sent = fwrite($stream, substr($request, $offset));
    if ($sent === false || $sent === 0) { throw new RuntimeException('Запрос не записан целиком'); }
    $offset += $sent;
}
$response = '';
while (!feof($stream)) {
    $chunk = fread($stream, 1024);
    $state = socket_get_status($stream);
    if ($chunk === false || $state['timed_out']) { throw new RuntimeException('Ответ не дочитан за срок'); }
    $response .= $chunk;
    if (strlen($response) > 8192) { throw new RuntimeException('Учебный предел ответа превышен'); }
}
fclose($stream);
[$headers, $body] = explode("\r\n\r\n", $response, 2);
if (!str_starts_with($headers, 'HTTP/1.1 200')) { throw new RuntimeException('Неожиданный статус'); }
echo $body;

Молоток — 8 шт.

Открыть канал к сервису по TCP/UDP или поддерживаемому Unix-транспорту, когда нужен протокол на уровне потоков.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сокет — канал обмена байтами с другой программой. Подключение ещё не знает смысла сообщения: формат задаёт протокол. Поток PHP — дескриптор, через который читают/пишут эти байты; его передают в fwrite/fgets/fclose. Эти функции возвращают stream resource, а не объект Socket расширения sockets. Что такое поток и указатель объясняет основу.

Этот вариант. Нужен ваш заранее запущенный сервис на локальном порту 9000. Этот вводный вариант проверен синтаксически, а полноценный обмен ниже запускает собственный listener без зависимости от занятого порта.

<?php
declare(strict_types=1);

$socket = fsockopen('127.0.0.1', 9000, $errorCode, $errorMessage, 2.0);
if ($socket === false) { throw new RuntimeException('Service unavailable'); }
echo "Connected\n";
fclose($socket);

Connected

Чтобы пример выполнялся без чужого сервиса, ниже создаётся собственный TCP-listener на 127.0.0.1:0. Ноль просит ОС выбрать свободный порт. stream_socket_get_name получает адрес, strrpos/substr выделяют порт, затем fsockopen подключает клиент, stream_socket_accept получает вторую сторону. Эти строки — инфраструктура учебной проверки; рабочий клиент обычно получает уже известные host/port из конфигурации. Все дескрипторы закрываются в finally.

Этот вариант. while повторяет запись оставшегося хвоста: offset хранит число отправленных байтов. В отличие от предположения «fwrite всегда отправил всё», здесь учитывается короткая запись. Реальный протокол ограничивает размер строки и проверяет false/timeout при чтении.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
try {
    stream_set_timeout($peer, 1);
    stream_set_timeout($client, 1);
    $message = "PING\n";
    $offset = 0;
    while ($offset < strlen($message)) {
        $written = fwrite($client, substr($message, $offset));
        if ($written === false || $written === 0) { throw new RuntimeException('Write failed'); }
        $offset += $written;
    }
    echo fgets($peer);
} finally {
fclose($peer);
fclose($client);
fclose($listener);
}

PING

Этот вариант. UDP не выполняет TCP-handshake: успешный fsockopen сам по себе не доказывает, что на другом конце кто-то слушает. В fixture подтверждена реально полученная датаграмма. UDP не гарантирует доставку/порядок.

<?php
declare(strict_types=1);

$server = stream_socket_server('udp://127.0.0.1:0', $errno, $error, STREAM_SERVER_BIND);
if ($server === false) { throw new RuntimeException('UDP fixture unavailable'); }
$address = stream_socket_get_name($server, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('udp://127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { fclose($server); throw new RuntimeException('UDP stream unavailable'); }
try {
    stream_set_timeout($server, 1);
    $written = fwrite($client, 'ping');
    if ($written !== 4) { throw new RuntimeException('Datagram not sent'); }
    $message = stream_socket_recvfrom($server, 16);
    if ($message === false) { throw new RuntimeException('Datagram unavailable'); }
    echo $message, "\n";
} finally { fclose($client); fclose($server); }

ping

Для TLS нужен OpenSSL и корректная проверка сертификата/имени. Когда требуется контекст TLS, неблокирующее подключение или дополнительные опции, используют stream_socket_client. Для обычного HTTP-запроса cURL/Guzzle избавляют от ручного разбора chunked, редиректов, TLS и заголовков. Не копируйте исторический fgetss из старых примеров: он удалён из PHP 8.

Дальше: pfsockopen; socket_set_timeout; socket_set_blocking; stream_socket_client — потоки.

• PHP: fsockopen

PHP 4+ · standard

pfsockopen(string $hostname, int $port = -1, int &$error_code = null, string &$error_message = null, ?float $timeout = null): resource|false

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$url = parse_url($base);
$stream = pfsockopen('127.0.0.1', $url['port'], $errorCode, $errorMessage, 1);
if ($stream === false) { throw new RuntimeException('Локальный сервер недоступен: '.$errorMessage); }
if (!stream_set_timeout($stream, 2)) { throw new RuntimeException('Не установлен timeout чтения'); }
$request = "GET /product?id=1 HTTP/1.1\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n";
$offset = 0;
while ($offset < strlen($request)) {
    $sent = fwrite($stream, substr($request, $offset));
    if ($sent === false || $sent === 0) { throw new RuntimeException('Запрос не записан целиком'); }
    $offset += $sent;
}
$response = '';
while (!feof($stream)) {
    $chunk = fread($stream, 1024);
    $state = socket_get_status($stream);
    if ($chunk === false || $state['timed_out']) { throw new RuntimeException('Ответ не дочитан за срок'); }
    $response .= $chunk;
    if (strlen($response) > 8192) { throw new RuntimeException('Учебный предел ответа превышен'); }
}
fclose($stream);
[$headers, $body] = explode("\r\n\r\n", $response, 2);
if (!str_starts_with($headers, 'HTTP/1.1 200')) { throw new RuntimeException('Неожиданный статус'); }
echo $body;

Молоток — 8 шт.

Попросить PHP сохранить соединение между запросами одного рабочего процесса, если протокол допускает безопасное повторное использование.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сокет — канал обмена байтами с другой программой. Подключение ещё не знает смысла сообщения: формат задаёт протокол. Поток PHP — дескриптор, через который читают/пишут эти байты; его передают в fwrite/fgets/fclose. Эти функции возвращают stream resource, а не объект Socket расширения sockets. Что такое поток и указатель объясняет основу.

Этот вариант. Нужен собственный сервис, допускающий persistence. fclose освобождает ссылку текущего кода; этот короткий пример не доказывает переиспользование между HTTP-запросами или наличие живого сервера.

<?php
declare(strict_types=1);

$socket = pfsockopen('127.0.0.1', 9000, $errorCode, $errorMessage, 2.0);
if ($socket === false) { throw new RuntimeException('Persistent connection unavailable'); }
echo "Stream acquired\n";
fclose($socket);

Stream acquired

Чтобы пример выполнялся без чужого сервиса, ниже создаётся собственный TCP-listener на 127.0.0.1:0. Ноль просит ОС выбрать свободный порт. stream_socket_get_name получает адрес, strrpos/substr выделяют порт, затем fsockopen подключает клиент, stream_socket_accept получает вторую сторону. Эти строки — инфраструктура учебной проверки; рабочий клиент обычно получает уже известные host/port из конфигурации. Все дескрипторы закрываются в finally.

Этот вариант. Исполняемая проверка доказывает локальное создание/обмен, а не межзапросный жизненный цикл FPM. Долговечность соединения зависит от SAPI, worker и сервиса; это отдельный интеграционный тест.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = pfsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
try {
    stream_set_timeout($peer, 1);
    $written = fwrite($client, "OK\n");
    if ($written !== 3) { throw new RuntimeException('Short fixture write'); }
    $received = fgets($peer);
    if ($received === false) { throw new RuntimeException('No fixture response'); }
    echo $received;
} finally {
fclose($peer);
fclose($client);
fclose($listener);
}

OK

Скорость выигрывается на повторном установлении соединения, но появляется стоимость управления состоянием. При редких запросах или неподходящем протоколе обычное соединение проще. В CLI завершение процесса завершит и его соединения.

Дальше: fsockopen; socket_get_status; socket_set_timeout.

• PHP: pfsockopen

PHP 4+ · standard

socket_get_status(resource $stream): array

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$url = parse_url($base);
$stream = fsockopen('127.0.0.1', $url['port'], $errorCode, $errorMessage, 1);
if ($stream === false) { throw new RuntimeException('Локальный сервер недоступен: '.$errorMessage); }
if (!stream_set_timeout($stream, 2)) { throw new RuntimeException('Не установлен timeout чтения'); }
$request = "GET /product?id=1 HTTP/1.1\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n";
$offset = 0;
while ($offset < strlen($request)) {
    $sent = fwrite($stream, substr($request, $offset));
    if ($sent === false || $sent === 0) { throw new RuntimeException('Запрос не записан целиком'); }
    $offset += $sent;
}
$response = '';
while (!feof($stream)) {
    $chunk = fread($stream, 1024);
    $state = socket_get_status($stream);
    if ($chunk === false || $state['timed_out']) { throw new RuntimeException('Ответ не дочитан за срок'); }
    $response .= $chunk;
    if (strlen($response) > 8192) { throw new RuntimeException('Учебный предел ответа превышен'); }
}
fclose($stream);
[$headers, $body] = explode("\r\n\r\n", $response, 2);
if (!str_starts_with($headers, 'HTTP/1.1 200')) { throw new RuntimeException('Неожиданный статус'); }
echo $body;

Молоток — 8 шт.

Прочитать метаданные stream-сокета: например, отличить таймаут ожидания от завершения потока.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сокет — канал обмена байтами с другой программой. Подключение ещё не знает смысла сообщения: формат задаёт протокол. Поток PHP — дескриптор, через который читают/пишут эти байты; его передают в fwrite/fgets/fclose. Эти функции возвращают stream resource, а не объект Socket расширения sockets. Что такое поток и указатель объясняет основу.

Этот вариант. Алиас работает с потоками, не только с сетью. php://temp позволяет сменить позицию; сетевой канал обычно не позволяет вернуться к уже прочитанным байтам.

<?php
declare(strict_types=1);

$stream = fopen('php://temp', 'w+');
if ($stream === false) { throw new RuntimeException('Stream unavailable'); }
try {
    $meta = socket_get_status($stream);
    var_dump($meta['seekable']);
    echo $meta['uri'], "\n";
} finally { fclose($stream); }

bool(true)
php://temp

Чтобы пример выполнялся без чужого сервиса, ниже создаётся собственный TCP-listener на 127.0.0.1:0. Ноль просит ОС выбрать свободный порт. stream_socket_get_name получает адрес, strrpos/substr выделяют порт, затем fsockopen подключает клиент, stream_socket_accept получает вторую сторону. Эти строки — инфраструктура учебной проверки; рабочий клиент обычно получает уже известные host/port из конфигурации. Все дескрипторы закрываются в finally.

Этот вариант. Peer намеренно ничего не отправляет. 50 000 микросекунд задают короткое ожидание; точное физическое время тест не обещает. timed_out объясняет причину, но повтор без лимита всё равно может навсегда занять worker.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
try {
    stream_set_timeout($client, 0, 50000);
    $line = fgets($client);
    $meta = socket_get_status($client);
    var_dump($line === false, $meta['timed_out']);
} finally {
fclose($peer);
fclose($client);
fclose($listener);
}

bool(true)
bool(true)

Дальше: socket_set_timeout; stream_get_meta_data — потоки; fsockopen.

• PHP: socket_get_status

PHP 4+ · standard

socket_set_blocking(resource $stream, bool $enable): bool

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$url = parse_url($base);
$stream = fsockopen('127.0.0.1', $url['port'], $errorCode, $errorMessage, 1);
if ($stream === false) { throw new RuntimeException('Локальный сервер недоступен: '.$errorMessage); }
if (!socket_set_blocking($stream, true)) { throw new RuntimeException('Не установлен блокирующий режим'); }
if (!stream_set_timeout($stream, 2)) { throw new RuntimeException('Не установлен timeout чтения'); }
$request = "GET /product?id=1 HTTP/1.1\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n";
$offset = 0;
while ($offset < strlen($request)) {
    $sent = fwrite($stream, substr($request, $offset));
    if ($sent === false || $sent === 0) { throw new RuntimeException('Запрос не записан целиком'); }
    $offset += $sent;
}
$response = '';
while (!feof($stream)) {
    $chunk = fread($stream, 1024);
    $state = socket_get_status($stream);
    if ($chunk === false || $state['timed_out']) { throw new RuntimeException('Ответ не дочитан за срок'); }
    $response .= $chunk;
    if (strlen($response) > 8192) { throw new RuntimeException('Учебный предел ответа превышен'); }
}
fclose($stream);
[$headers, $body] = explode("\r\n\r\n", $response, 2);
if (!str_starts_with($headers, 'HTTP/1.1 200')) { throw new RuntimeException('Неожиданный статус'); }
echo $body;

Молоток — 8 шт.

Переключить ожидание I/O stream-сокета: ждать данные либо вернуться сразу и управлять готовностью отдельно.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сокет — канал обмена байтами с другой программой. Подключение ещё не знает смысла сообщения: формат задаёт протокол. Поток PHP — дескриптор, через который читают/пишут эти байты; его передают в fwrite/fgets/fclose. Эти функции возвращают stream resource, а не объект Socket расширения sockets. Что такое поток и указатель объясняет основу.

Чтобы пример выполнялся без чужого сервиса, ниже создаётся собственный TCP-listener на 127.0.0.1:0. Ноль просит ОС выбрать свободный порт. stream_socket_get_name получает адрес, strrpos/substr выделяют порт, затем fsockopen подключает клиент, stream_socket_accept получает вторую сторону. Эти строки — инфраструктура учебной проверки; рабочий клиент обычно получает уже известные host/port из конфигурации. Все дескрипторы закрываются в finally.

Этот вариант. Настройка меняет режим операций этого потока, а не превращает весь PHP-скрипт в параллельный.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
try {
    var_dump(socket_set_blocking($client, false));
    var_dump(socket_get_status($client)['blocked']);
    var_dump(socket_set_blocking($client, true));
    var_dump(socket_get_status($client)['blocked']);
} finally {
fclose($peer);
fclose($client);
fclose($listener);
}

bool(true)
bool(false)
bool(true)
bool(true)

Этот вариант. Другая сторона ещё открыта и ничего не прислала. Нельзя крутить такое чтение в бесконечном while без ожидания: это загружает CPU. Нужны readiness и deadline.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
try {
    socket_set_blocking($client, false);
    $chunk = fread($client, 8);
    var_dump($chunk === '', feof($client));
} finally {
fclose($peer);
fclose($client);
fclose($listener);
}

bool(true)
bool(false)

Дальше: socket_get_status; fsockopen; stream_set_blocking — потоки.

• PHP: socket_set_blocking

PHP 4+ · standard

socket_set_timeout(resource $stream, int $seconds, int $microseconds = 0): bool

<?php
declare(strict_types=1);

require __DIR__ . '/base.php';
$url = parse_url($base);
$stream = fsockopen('127.0.0.1', $url['port'], $errorCode, $errorMessage, 1);
if ($stream === false) { throw new RuntimeException('Локальный сервер недоступен: '.$errorMessage); }
if (!stream_set_timeout($stream, 2)) { throw new RuntimeException('Не установлен timeout чтения'); }
$request = "GET /product?id=1 HTTP/1.1\r\nHost: 127.0.0.1\r\nConnection: close\r\n\r\n";
$offset = 0;
while ($offset < strlen($request)) {
    $sent = fwrite($stream, substr($request, $offset));
    if ($sent === false || $sent === 0) { throw new RuntimeException('Запрос не записан целиком'); }
    $offset += $sent;
}
$response = '';
while (!feof($stream)) {
    $chunk = fread($stream, 1024);
    $state = socket_get_status($stream);
    if ($chunk === false || $state['timed_out']) { throw new RuntimeException('Ответ не дочитан за срок'); }
    $response .= $chunk;
    if (strlen($response) > 8192) { throw new RuntimeException('Учебный предел ответа превышен'); }
}
fclose($stream);
[$headers, $body] = explode("\r\n\r\n", $response, 2);
if (!str_starts_with($headers, 'HTTP/1.1 200')) { throw new RuntimeException('Неожиданный статус'); }
echo $body;

Молоток — 8 шт.

Понять старое имя настройки timeout stream и перейти на stream_set_timeout в новом коде.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Сокет — канал обмена байтами с другой программой. Подключение ещё не знает смысла сообщения: формат задаёт протокол. Поток PHP — дескриптор, через который читают/пишут эти байты; его передают в fwrite/fgets/fclose. Эти функции возвращают stream resource, а не объект Socket расширения sockets. Что такое поток и указатель объясняет основу.

Чтобы пример выполнялся без чужого сервиса, ниже создаётся собственный TCP-listener на 127.0.0.1:0. Ноль просит ОС выбрать свободный порт. stream_socket_get_name получает адрес, strrpos/substr выделяют порт, затем fsockopen подключает клиент, stream_socket_accept получает вторую сторону. Эти строки — инфраструктура учебной проверки; рабочий клиент обычно получает уже известные host/port из конфигурации. Все дескрипторы закрываются в finally.

Этот вариант. Современный вызов даёт нужную настройку без сообщения о deprecated-алиасе.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
try {
    var_dump(stream_set_timeout($client, 0, 50000));
    $line = fgets($client);
    var_dump($line === false, stream_get_meta_data($client)['timed_out']);
} finally {
fclose($peer);
fclose($client);
fclose($listener);
}

bool(true)
bool(true)
bool(true)

Этот вариант. Проверка специально считает E_DEPRECATED на PHP 8.5.11. В рабочем приложении исправляют вызов; обработчик здесь нужен для воспроизводимого урока, а не для отключения предупреждений.

<?php
declare(strict_types=1);

$listener = stream_socket_server('tcp://127.0.0.1:0', $errno, $error);
if ($listener === false) { throw new RuntimeException('Cannot create local fixture'); }
$address = stream_socket_get_name($listener, false);
$port = (int) substr($address, strrpos($address, ':') + 1);
$client = fsockopen('127.0.0.1', $port, $errno, $error, 1.0);
if ($client === false) { throw new RuntimeException('Local connection failed'); }
$peer = stream_socket_accept($listener, 1.0);
if ($peer === false) { throw new RuntimeException('Local accept failed'); }
$deprecated = 0;
set_error_handler(function (int $level, string $message) use (&$deprecated): bool {
    if ($level !== E_DEPRECATED) { return false; }
    $deprecated++;
    return true;
});
try { $configured = socket_set_timeout($client, 1); }
finally { restore_error_handler();
fclose($peer);
fclose($client);
fclose($listener);
}
var_dump($configured);
echo $deprecated, "\n";

bool(true)
1

Дальше: stream_set_timeout — потоки; socket_get_status; fsockopen.

• PHP: socket_set_timeout

PHP 4+ · standard

openlog(string $prefix, int $flags, int $facility): true

<?php
declare(strict_types=1);

$text = "Молоток — 8 шт.\n";
if (file_put_contents(__DIR__ . '/inventory-report.txt', $text) === false) { throw new RuntimeException('Отчёт не создан'); }
if (!openlog('phpcatalog', LOG_PID, LOG_USER)) { throw new RuntimeException('Logger недоступен'); }
try {
    if (!syslog(LOG_NOTICE, 'inventory report created: product=1 stock=8')) { throw new RuntimeException('Событие не принято logger'); }
} finally { closelog(); }
echo $text, "Событие передано системному logger; проверьте его настроенный журнал\n";

Молоток — 8 шт.
Событие передано системному logger; проверьте его настроенный журнал

Задать имя приложения и параметры для последующих записей в системный журнал.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Системный журнал собирает сообщения разных программ, а администратор настраивает хранение, фильтры и доставку. PHP не выбирает здесь имя файла на диске. На Unix сообщения обслуживает системный logging-механизм; на Windows используется Event Log. Для JSON-файла приложения или контейнерного STDERR может лучше подойти другой обработчик журнала. Не записывайте пароли, полные токены и произвольные персональные данные.

Этот вариант. Этот исполняемый пример не вызывает syslog и не отправляет сообщение в системный журнал. Он проверяет вызов настройки/закрытия; реальную доставку проверяют на отдельном тестовом logger.

<?php
declare(strict_types=1);

$configured = openlog('php-manual-fixture', LOG_ODELAY, LOG_USER);
$closed = closelog();
var_dump($configured, $closed);

bool(true)
bool(true)

Этот вариант. | объединяет независимые флаги, & проверяет наличие бита. LOG_ODELAY на некоторых системах равен нулю как поведение по умолчанию; не проверяйте его наличие той же битовой формулой.

<?php
declare(strict_types=1);

$flags = LOG_PID | LOG_ODELAY;
var_dump(($flags & LOG_PID) === LOG_PID);
$facility = LOG_USER;
var_dump(is_int($facility));

bool(true)
bool(true)

Дальше: syslog; closelog.

• PHP: openlog

PHP 4+ · standard

syslog(int $priority, string $message): true

<?php
declare(strict_types=1);

$text = "Молоток — 8 шт.\n";
if (file_put_contents(__DIR__ . '/inventory-report.txt', $text) === false) { throw new RuntimeException('Отчёт не создан'); }
if (!openlog('phpcatalog', LOG_PID, LOG_USER)) { throw new RuntimeException('Logger недоступен'); }
try {
    if (!syslog(LOG_NOTICE, 'inventory report created: product=1 stock=8')) { throw new RuntimeException('Событие не принято logger'); }
} finally { closelog(); }
echo $text, "Событие передано системному logger; проверьте его настроенный журнал\n";

Молоток — 8 шт.
Событие передано системному logger; проверьте его настроенный журнал

Отправить короткое событие приложения в системный журнал с уровнем важности.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Системный журнал собирает сообщения разных программ, а администратор настраивает хранение, фильтры и доставку. PHP не выбирает здесь имя файла на диске. На Unix сообщения обслуживает системный logging-механизм; на Windows используется Event Log. Для JSON-файла приложения или контейнерного STDERR может лучше подойти другой обработчик журнала. Не записывайте пароли, полные токены и произвольные персональные данные.

Этот вариант. Контекстный пример: он действительно пишет в системный журнал при запуске. В общей сборке проверен синтаксис; тесты мануала не засоряют журнал ОС. Доставку и фильтрацию нужно проверять на отдельном настроенном тестовом logger.

<?php
declare(strict_types=1);

openlog('inventory-worker', LOG_PID, LOG_USER);
try {
    $accepted = syslog(LOG_INFO, 'event=import_finished items=12');
} finally { closelog(); }
var_dump($accepted);

bool(true)

Этот вариант. Это подготовка сообщения без записи в ОС. requestId здесь доверенная fixture; внешний идентификатор тоже проверяют. substr ограничивает байты и может разрезать UTF-8: для Unicode выбирают подходящий mb_* способ/структурированный logger. Удаление CR/LF не является полной политикой обработки всех управляющих символов.

<?php
declare(strict_types=1);

$requestId = 'req-42';
$details = "upstream unavailable\nforged line";
$singleLine = str_replace(["\r", "\n"], ' ', $details);
$message = 'event=upstream_failure request=' . $requestId . ' detail=' . substr($singleLine, 0, 100);
echo $message, "\n";

event=upstream_failure request=req-42 detail=upstream unavailable forged line

LOG_EMERG/ALERT не используют для каждой отладки: это уровни серьёзных инцидентов. Для регулярного большого потока логов нужны ротация, ограничения объёма и наблюдение за самим сборщиком. Обработка ошибок помогает отделить техническую причину от ответа пользователю.

Дальше: openlog; closelog.

• PHP: syslog

PHP 4+ · standard

closelog(): true

<?php
declare(strict_types=1);

$text = "Молоток — 8 шт.\n";
if (file_put_contents(__DIR__ . '/inventory-report.txt', $text) === false) { throw new RuntimeException('Отчёт не создан'); }
if (!openlog('phpcatalog', LOG_PID, LOG_USER)) { throw new RuntimeException('Logger недоступен'); }
try {
    if (!syslog(LOG_NOTICE, 'inventory report created: product=1 stock=8')) { throw new RuntimeException('Событие не принято logger'); }
} finally { closelog(); }
echo $text, "Событие передано системному logger; проверьте его настроенный журнал\n";

Молоток — 8 шт.
Событие передано системному logger; проверьте его настроенный журнал

Освободить соединение/состояние системного logger после законченного блока работы.

Здесь $name — переменная, = сохраняет результат, а имя со скобками вызывает функцию. Аргументы разделяют запятыми. echo выводит текст; var_dump также показывает тип. "\n" переводит строку. === false отличает отказ от числа 0, пустой строки и других допустимых значений.

Массив [] собирает элементы; ключ => значение подписывает ячейку. foreach берёт элементы по очереди, if выбирает действие по условию. throw new RuntimeException прекращает нормальный путь при неожиданном отказе, try/finally гарантирует завершающее действие. Имена example.com и адреса документационных диапазонов ниже описывают учебные данные, а не ваши серверы. Вызовы функций и работа с массивами объясняются отдельно.

Системный журнал собирает сообщения разных программ, а администратор настраивает хранение, фильтры и доставку. PHP не выбирает здесь имя файла на диске. На Unix сообщения обслуживает системный logging-механизм; на Windows используется Event Log. Для JSON-файла приложения или контейнерного STDERR может лучше подойти другой обработчик журнала. Не записывайте пароли, полные токены и произвольные персональные данные.

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

<?php
declare(strict_types=1);

var_dump(closelog());

bool(true)

Этот вариант. finally выполняется при обычном исключении и затем передаёт его внешнему catch. syslog здесь не вызывается; реальное приложение записывает уместное событие согласно своей политике. Аварийное завершение процесса не является обычным finally-сценарием.

<?php
declare(strict_types=1);

openlog('php-manual-fixture', LOG_ODELAY, LOG_USER);
try {
    try { throw new RuntimeException('Fixture failure'); }
    finally { $closed = closelog(); }
} catch (RuntimeException $error) {
    echo "Failure handled\n";
}
var_dump($closed);

Failure handled
bool(true)

Дальше: openlog; syslog.

• PHP: closelog