phpEnv 默认不启用 sysvmsg、sysvsem 和 sysvshm 扩展，必须通过 --enable-sysvmsg --enable-sysvsem --enable-sysvshm 编译参数重新编译对应 PHP 版本，否则调用 ftok()、msg_get_queue() 等函数将报“function undefined”错误。
phpEnv 默认不启用 sysvmsg、sysvsem 和 sysvshm 扩展，必须手动开启编译选项并重启服务，否则调用 ftok()、msg_get_queue() 等函数会直接报错“function undefined”。
确认 phpEnv 当前 PHP 版本和编译方式
phpEnv 是基于源码编译管理多版本 PHP 的工具，所有扩展启用都依赖于编译参数，不是简单改 php.ini 就能生效。先确认你当前用的是哪个 PHP 版本：
phpenv versions 查看已安装版本，比如 7.4.33；再执行 phpenv which php 看当前激活路径。关键点在于：phpEnv 编译时若没加 --enable-sysvmsg --enable-sysvsem --enable-sysvshm，这些扩展根本不会生成 .so 文件。
检查是否已编译进当前 PHP：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep sysv—— 若无任何输出，说明未启用 - 运行
php-config --configure-options—— 搜索是否有--enable-sysvmsg等参数
重新编译启用 sysv* 扩展（必须步骤）
不能跳过重编译。即使你看到 php -m 里有 sysvmsg，也可能是旧版本残留或别的环境干扰，以 php-config 输出为准。
操作流程如下：
- 切换到目标版本：
phpenv local 7.4.33（替换成你的实际版本） - 清理旧构建：
phpenv uninstall 7.4.33（⚠️注意：这会删掉该版本全部扩展和配置） - 设置编译参数：
CONFIGURE_OPTS="--enable-sysvmsg --enable-sysvsem --enable-sysvshm" phpenv install 7.4.33 - 等待编译完成，然后验证：
php -m | grep sysv应输出三行
常见坑：CONFIGURE_OPTS 必须在 phpenv install 前导出，写成 export CONFIGURE_OPTS="..." 再执行安装也行，但不能漏掉任意一个 --enable- 参数。
验证消息队列基础可用性
扩展启用后不代表 IPC 就通了，Linux 内核需支持 SysV IPC，且权限/资源限制可能拦住你。
写个最小验证脚本跑一下：
<?php
$key = ftok(__FILE__, 'a');
if ($key === false) {
die("ftok failed: " . implode(', ', error_get_last()));
}
$queue = msg_get_queue($key, 0666);
if (!$queue) {
die("msg_get_queue failed");
}
var_dump(msg_send($queue, 1, 'test', true, true, $err));
?>如果报 PHP Warning: msg_get_queue(): failed to get system message queue，大概率是：
- 内核禁用了 SysV IPC：检查
cat /proc/sys/kernel/msgmax是否为 0（禁用），需临时启用：echo 1 > /proc/sys/kernel/msgmax（需 root） - 用户超出 IPC 资源限制：用
ipcs -l查看当前限制，ipcs -q看已有队列，必要时用ipcrm -Q <msgid>清理 -
ftok()输入文件不可读或路径含符号链接（它只认真实 inode）——换用绝对路径且确保文件存在、可 stat
为什么不用 sockets 或 Redis 替代？
不是不能用，而是场景决定。SysV 消息队列适合短生命周期、高并发、低延迟的本地进程协作，比如一个主进程派发任务给多个常驻子进程消费，不需要网络层、不依赖外部服务、不走文件系统缓存。而 sockets 在本地虽快，但要自己处理连接、粘包、断连；Redis 则引入额外依赖和序列化开销。如果你只是做简单的父子进程通知或批量任务分发，sysvmsg 反而更轻、更稳——前提是它真被编译进去了，且内核没把它关掉。
最容易被忽略的一点：phpEnv 下每次 phpenv install 都是全新编译，哪怕只改一个扩展参数，也要重来一遍；没有“动态加载”这种事。别在 php.ini 里瞎加 extension=sysvmsg.so，那个文件根本不存在。
