msg_get_queue

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

msg_get_queueСоздание или подключение к очереди сообщений

Описание

msg_get_queue ( int $key , int $permissions = 0666 ) : SysvMessageQueue|false

msg_get_queue() возвращает идентификатор, который используется для доступа к очереди сообщений System V с указанным ключом key. Первый вызов создаёт очередь сообщений с необязательными правами permissions. Второй и последующие вызовы msg_get_queue() для того же key будут возвращать другие идентификаторы, однако все они будут ссылаться на одну и ту же очередь сообщений.

Список параметров

key

Числовой идентификатор очереди сообщений.

permissions

Права доступа к очереди. По умолчанию 0666. Если очередт сообщений уже существует, параметр permissions игнорируется.

Возвращаемые значения

Возвращает экземпляр SysvMessageQueue, который может быть использован для доступа к очереди сообщений System V, или false в случае возникновения ошибки.

Список изменений

Версия Описание
8.0.0 В случае успешного выполнения функция теперь возвращает экземпляр SysvMessageQueue; ранее возвращался ресурс (resource).

Смотрите также

  • msg_remove_queue() - Удаление очереди сообщений
  • msg_receive() - Получение сообщения из очереди сообщений
  • msg_send() - Отправка сообщения в очередь сообщений
  • msg_stat_queue() - Получение информации из структуры данных очереди сообщений
  • msg_set_queue() - Установка информации в структуре данных очереди сообщений