msg_get_queue
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
msg_get_queue — Создание или подключение к очереди сообщений
Описание
$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() - Установка информации в структуре данных очереди сообщений