msg_get_queue

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

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() - Устанавливает информацию в структуре данных очереди сообщений