PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8
msg_get_queue - Create or attach to a message queue

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

msg_get_queue returns an id that can be used to access the System V message queue with the given key. The first call creates the message queue with the optional permissions. A second call to msg_get_queue for the same key will return a different message queue identifier, but both identifiers access the same underlying message queue.



Message queue numeric ID


Queue permissions. Default to 0666. If the message queue already exists, the permissions will be ignored.

Return Values

Returns SysvMessageQueue instance that can be used to access the System V message queue, or false on failure.


Version Description
8.0.0 On success, this function returns a SysvMessageQueue instance now; previously, a resource was returned.

Related Functions

Function msg_get_queue:

  • Manual

Semaphore, Shared Memory and IPC Functions

Most used PHP functions