最直接的方式是查看 phpinfo() 中的 Thread Safety 项:enabled 为 ZTS,disabled 为 NTS;也可用 php -r "echo PHP_ZTS ? 'ZTS' : 'NTS';" 命令判断,PHP_ZTS 常量值为 1 或 0。

phpinfo() 页面里怎么看 ZTS/NTS
最直接的方式是打开 phpinfo() 页面,搜索 Thread Safety 这一项。如果显示 enabled,说明当前 PHP 是 ZTS(Zend Thread Safe)编译;显示 disabled,则是 NTS(Non-Thread-Safe)。
注意:Thread Safety 的值和 Web 服务器类型强相关——Apache 的 mpm_winnt 或 worker 模块通常要求 ZTS,而 Nginx + PHP-FPM 场景下几乎全是 NTS。
命令行用 php -i 或 php -r 快速判断
终端执行以下任一命令即可:
php -i | grep "Thread Safety"
php -r "echo PHP_ZTS ? 'ZTS' : 'NTS';"
其中 PHP_ZTS 是 PHP 内置常量,ZTS 编译时为 1,NTS 为 0。这个方式不依赖 Web 环境,适合 CI/CD 或容器镜像检查。
立即学习“PHP免费学习笔记(深入)”;
常见误判点:
- 某些定制化打包的 PHP(如 XAMPP、MAMP)可能隐藏或篡改
phpinfo()输出,但PHP_ZTS常量仍可靠 -
php -v不显示 ZTS/NTS 信息,别白费劲看版本行
扩展加载失败时,ZTS/NTS 不匹配是首要怀疑对象
当你遇到类似这样的错误:
PHP Warning: PHP Startup: Unable to load dynamic library 'redis.so' (tried: /usr/lib/php/20220829/redis.so (/usr/lib/php/20220829/redis.so: undefined symbol: _zval_ptr_dtor), ...)
大概率是扩展(如 redis.so)和 PHP 主体的 ZTS/NTS 类型不一致。比如:
- NTS 的 PHP 加载了 ZTS 编译的
.so文件 → 符号缺失(_zval_ptr_dtor等内部函数名不同) - Ubuntu/Debian 默认仓库的
php-redis包是 NTS 版,但你手动编译的 PHP 是 ZTS,就会撞上这类问题 - Windows 下的
php_redis.dll文件名常带ts(ZTS)或nts(NTS)后缀,必须严格对应
编译 PHP 时如何指定 ZTS 或 NTS
源码编译 PHP 时,ZTS 不是默认选项,必须显式开启:
./configure --enable-maintainer-zts ...
加了 --enable-maintainer-zts 才是 ZTS;不加就是 NTS(无论是否用 --disable-zts,后者无效)。
关键细节:
-
--enable-zts不是合法参数,正确写法只有--enable-maintainer-zts - ZTS 会引入线程锁开销,对 FPM 场景无实际收益,反而可能降低性能
- 启用 ZTS 后,所有扩展也必须用相同配置重新编译,否则
make install可能成功,但运行时报错
ZTS 和 NTS 的区别不在“能不能跑多线程”,而在于 Zend 内存管理器和全局变量是否做了线程安全封装。多数人根本不需要 ZTS,却因 Apache 旧文档误导而强行开启,结果卡在扩展兼容性上。











