Функция PHP socket_get_status(): Всё, что нужно знать

Как разработчик PHP, вам может потребоваться проверить состояние сокета, чтобы убедиться, что он открыт и готов к использованию. Функция socket_get_status() является встроенной функцией PHP, которая возвращает эту информацию.

Что такое функция socket_get_status()?

Функция socket_get_status() возвращает состояние ресурса потока. Обратите внимание, что она предназначена для ресурсов потока (например, полученных через fsockopen() или stream_socket_client()), а не для сырых сокетных ресурсов из socket_create(), что может вызывать предупреждения об устаревании в PHP 8+.

Как использовать функцию socket_get_status()

Использование функции socket_get_status() достаточно просто. Ниже приведён синтаксис функции:

PHP-синтаксис функции socket_get_status()

socket_get_status(resource $socket);

Функция принимает один параметр:

• $socket: Ресурс потока, состояние которого необходимо получить.

Ниже приведён пример использования функции socket_get_status() для получения состояния сокета:

Как использовать функцию socket_get_status()?

<‌?php

$socket = fsockopen("www.example.com", 80, $errno, $errstr, 30);
if (!$socket) {
    die("Error: $errstr ($errno)");
}

$status = socket_get_status($socket);
if ($status["eof"]) {
    echo "Socket closed";
} else {
    echo "Socket open";
}

fclose($socket);
?>

В этом примере мы используем fsockopen() для создания ресурса потока, затем проверяем успешность его создания перед проверкой состояния. Мы проверяем, равно ли поле eof значению true (что указывает на достижение конца потока) или false (что указывает на его активное состояние).

Функция возвращает ассоциативный массив со следующими ключами:

• wrappable: Логическое значение, указывающее, может ли поток быть обернут.
• stream_type: Строка, описывающая тип потока (например, tcp_socket).
• mode: Строка, указывающая режим доступа (например, r, w).
• unread_bytes: Целое число, представляющее количество непрочитанных байтов в буфере потока.
• timed_out: Логическое значение, указывающее, истёк ли тайм-аут потока.
• eof: Логическое значение, указывающее, достигнут ли конец потока.

Заключение

Функция socket_get_status() — это полезный инструмент для проверки состояния сокета в вашем PHP-веб-приложении. Понимая синтаксис, возвращаемые значения и правильные типы ресурсов, вы сможете легко отслеживать состояния сокетов для обеспечения надёжной сетевой связи. Надеемся, эта статья оказалась информативной и полезной для понимания функции socket_get_status() в PHP.

Практика

Какова цель функции socket_get_status() в PHP?

Она открывает соединение с сокетомОна возвращает состояние ресурса сокетаОна закрывает соединение с сокетомОна изменяет состояние ресурса сокета