П О Р Т А Л                            
С Е Т Е В Ы Х                          
П Р О Е К Т О В                        
  
Поиск по сайту:
                                                 
Главная

О проекте

Web-мастеру
     HTML & JavaScript
     SSI
     Perl
     PHP
     XML & XSLT
     Unix Shell

MySQL

Безопасность

Хостинг

Другое








Самое читаемое:

Учебник PHP - "Для Чайника".
Просмотров 187238 раз(а).

Иллюстрированный самоучитель по созданию сайтов.
Просмотров 89719 раз(а).

Учебник HTML.
Просмотров 80440 раз(а).

Руководство по PHP5.
Просмотров 50829 раз(а).

Хостинг через призму DNS.
Просмотров 58713 раз(а).

Подборка текстов стандартных документов.
Просмотров 49643 раз(а).

Учебник PHP - Самоучитель
Просмотров 56897 раз(а).

Документация на MySQL (учебник & справочное руководство)
Просмотров 58228 раз(а).

Внешние атаки...
Просмотров 47608 раз(а).

Учебник PHP.
Просмотров 41590 раз(а).

SSI в примерах.
Просмотров 31860 раз(а).



 
 
| Добавить в избранное | Сделать стартовой | Помощь





Учебник РНР
НазадВперёд

socket_select

(PHP 4 >= 4.1.0)

socket_select - запускает системный вызов select() на данных массивах сокетов с таймаутом, специфицированным параметрами tv_sec и tv_usec.

Описание

int socket_select (resource &read, resource &write, resource &except, int tv_sec [, int tv_usec])

Предупреждение!

Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

socket_select() принимает массивы сокетов и ожидает их для изменения статуса. Сокеты, приходящие из BSD, будут распознаваться как так называемые наборы дескрипторов файлов. Ожидаются три массива ресурсов сокетов.

Сокеты массива read будут ожидаться, чтобы просмотреть, становятся ли символы доступными для чтения (точнее, чтобы просмотреть, не будет ли блокировано чтение; ресурс сокета готов также и в end-of-file, и в этом случае socket_read() возвратит строку нулевой длины).

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

Сокеты из массива except ожидаются для исключений.

Предупреждение!

При выходе эти массивы модифицируются для указания на то, какой ресурс сокета фактически изменил статус.

Вам не нужно передавать каждый массив в socket_select(). Вместо них вы можете использовать пустой массив или NULL. Не забывайте также, что эти массивы передаются по сылке и будут модифицированы после возвращения из socket_select().

Пример:
/* Подготовить read-массив */
$read = array($socket1, $socket2);

if (false === ($num_changed_sockets = socket_select($read, $write = NULL, $except = NULL, 0)))
{
    /* Обработка ошибок */
else if ($num_changed_sockets > 0) {
    /* Как минимум в одном из сокетов произойдёт что-нибудь интересное */
}

Примечание: из-за ограничений в текущей Zend-машине невозможно передавать константный модификатор вроде NULL непосредственно как параметр функции, которая ожидает этот параметр, передаваемый по ссылке. В этом случае можно использовать временную переменную или выражение с самым левым членом - временной переменной:
socket_select($r, $w, $e = NULL, 0);

Параметры tv_sec и tv_usec - оба из параметра timeout. Этот timeout является верхней границей времени, прошедшего до возврата из socket_select(). tv_sec может быть 0, вызывая немедленный возврат из socket_select(). Это используется для пулов. Если tv_sec равен NULL (нет таймаута), socket_select() может блокировать бесконечно.

При успехе socket_select() возвращает количество ресурсов сокетов, содержащихся в модифицированных массивах, которое может быть равно 0, если timeout истёк до возникновения чего-нибудь интересного. При ошибке возвращается FALSE. Код ошибки можно запросить функцией socket_last_error().

Примечание: обязательно используйте операцию === при проверке на наличие ошибок. Поскольку socket_select() может возвратить 0, сравнение с помощью == вычислится в TRUE:

if (false === socket_select($r, $w, $e = NULL, 0)) {
    echo "socket_select() failed, reason: " . socket_strerror(socket_last_error()) . "\n";
}

Примечание: помните, что некоторые реализации сокетов должны обрабатываться предельно осторожно. Вот некоторые основные правила:

  • Вы всегда должны пытаться использовать socket_select() без таймаута. Ваша программа ничего не должна делать, если доступных данных нет. Код, зависящий от таймаута плохо переносится и труден для отладки.

  • Никакие ресурсы сокетов не должны добавляться в какой-либо набор, если вы не предполагаете проверять их результаты после вызова socket_select() и соответственно реагировать. После возврата из socket_select(), все ресурсы сокетов во всех массивах обязательно должны проверяться. В любой ресурс сокета, доступный для записи, должна выполняться запись, а из любого ресурса сокета, доступного для чтения, должно выполняться чтение.

  • Если вы read/write в массивы, возвращаемые сокетом, имейте в виду, что они не обязательно read/write полный объём данных, запрошенный вами. Будьте готовы даже к чтению/записи единственного байта.

  • Для многих реализаций сокетов является обычным то, что только исключение, отлавливаемое массивом except, является out-of-bound-данными, полученными на сокете.

См. также socket_read(), socket_write(), socket_last_error() и socket_strerror().


Назад Оглавление Вперёд
socket_recvmsg Вверхsocket_send


Если Вы не нашли что искали, то рекомендую воспользоваться поиском по сайту: