PHP 的线程安全类型需通过 phpinfo() 或 php -i 查看 Thread Safety 行,enabled 为 TS,disabled 为 NTS;TS 启用 ZTS 编译选项并隔离全局变量,NTS 性能更高但仅适用于单线程 SAPI(如 FPM);现代主流环境(Nginx+FPM、Docker 等)均应使用 NTS。

怎么看自己的 PHP 是线程安全(TS)还是非线程安全(NTS)
直接看 phpinfo() 输出最可靠。在页面中搜索 Thread Safety 这一行,值为 enabled 表示是 TS 版本,disabled 则是 NTS。
命令行下运行
php -i | grep "Thread Safety"
也能快速确认。注意:Windows 下的 php.exe 和 php-cgi.exe 可能分属不同构建类型,不能只看文件名或目录名判断。
TS 和 NTS 的核心区别在 ZTS 编译选项
TS 版本编译时启用了 ZEND_THREAD_SAFE 宏,所有全局变量(如 EG、CG 等 Zend 内部结构)都通过线程局部存储(TLS)隔离,避免多线程并发访问冲突;NTS 版本不加锁、不隔离,性能略高但只能用于单线程 SAPI(如 CLI、FPM)。
- FPM(FastCGI Process Manager)必须用 NTS —— 它靠多进程而非多线程工作
- Apache 的
mod_php(仅限 Windows + Apache 2.4 旧部署)才可能依赖 TS 版本 - 扩展(.dll 或 .so)必须与 PHP 主体严格匹配 TS/NTS 类型,否则加载失败并报错
Unable to load dynamic library
下载或编译时如何选对版本
Windows 用户从 windows.php.net 下载时,文件名含 Thread Safe 就是 TS,含 Non Thread Safe 就是 NTS。Linux 用户通常无需手动区分:包管理器(如 apt、yum)提供的默认 PHP 都是 NTS;源码编译时,不加 --enable-maintainer-zts 即为 NTS,加了才是 TS。
立即学习“PHP免费学习笔记(深入)”;
常见误操作:
- 把 NTS 的
php.dll放进 Apache 的 TS 环境里,启动直接失败 - 用 TS 版本跑 FPM,会提示
unknown option -- fpm或无法识别php-fpm命令 - 扩展包没标注 TS/NTS,直接丢进
ext/目录导致PHP Startup: Unable to load dynamic library
为什么现在基本不用 TS 了
现代 Web 服务器架构已淘汰 Apache + mod_php 的线程模型。Nginx + PHP-FPM 成为主流,FPM 是多进程模型,每个 worker 进程单线程运行,完全不需要线程安全保护。ZTS 不仅增加内存开销和轻微性能损耗,还让调试更复杂(比如 GDB 调试多线程 Zend 内核比单线程难得多)。
真正需要 TS 的场景极少:仅限 Windows 下用 Apache 2.2/2.4 + mod_php 且开启 mpm_winnt 模块(已过时),或极少数嵌入式 C 程序调用 PHP 解释器并自己管理多线程。
如果你不确定该用哪个,大概率该用 NTS —— 尤其是在 Docker、Laravel Valet、Homestead 或任何基于 FPM 的环境里。
