PHP如何识别ZTS与NTS编译_PHP识别ZTS与NTS编译法【编译】

9次阅读

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

PHP如何识别ZTS与NTS编译_PHP识别ZTS与NTS编译法【编译】

phpinfo() 页面里怎么看 ZTS/NTS

最直接的方式是打开 phpinfo() 页面,搜索 Thread Safety 这一项。如果显示 enabled,说明当前 PHP 是 ZTS(Zend Thread Safe)编译;显示 disabled,则是 NTS(Non-Thread-Safe)。

注意:Thread Safety 的值和 Web 服务器类型强相关——apachempm_winntworker 模块通常要求 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 旧文档误导而强行开启,结果卡在扩展兼容性上。

text=ZqhQzanResources