msg_stat_queue()

返回有关消息队列的状态信息

首字母:M

函数名称:msg_stat_queue()

函数描述:msg_stat_queue() 函数返回有关消息队列的状态信息。

适用版本:PHP 4 >= 4.3.0, PHP 5, PHP 7

语法:msg_stat_queue(int $queue) : array|false

参数:

  • $queue:消息队列的标识符,通过 msg_get_queue() 函数获取。

返回值:

  • 如果成功,该函数返回一个包含消息队列状态信息的关联数组。
  • 如果失败,返回 false。

示例:

// 创建一个消息队列
$queue = msg_get_queue(1234, 0666);
// 获取消息队列的状态信息
$status = msg_stat_queue($queue);
// 打印状态信息
print_r($status);

输出结果:

Array
(
 [msg_perm] => Array
 (
 [uid] => 0
 [gid] => 0
 [cuid] => 0
 [cgid] => 0
 [mode] => 33204
 [seq] => 1
 )
 [msg_stime] => 1641583360
 [msg_rtime] => 0
 [msg_ctime] => 1641583360
 [msg_qnum] => 0
 [msg_qbytes] => 16384
 [msg_lspid] => 0
 [msg_lrpid] => 0
 [msg_stime_tv_sec] => 1641583360
 [msg_stime_tv_usec] => 0
 [msg_rtime_tv_sec] => 0
 [msg_rtime_tv_usec] => 0
 [msg_ctime_tv_sec] => 1641583360
 [msg_ctime_tv_usec] => 0
)

注意事项:

  • 在调用 msg_stat_queue() 函数之前,必须先通过 msg_get_queue() 函数获取消息队列的标识符。
  • 消息队列的状态信息将以关联数组的形式返回,包含了诸如权限、时间戳、消息数量等信息。
  • 如果函数调用失败,将返回 false。

同首字母函数