IIS运行PHP必须用Non-Thread Safe(NTS)版,因其通过FastCGI启动单线程php-cgi.exe进程;需将php.ini置于PHP根目录,启用fastcgi.impersonate=1、date.timezone等关键配置,并在IIS中正确映射FastCgiModule及设置FastCGI参数。

能直接跑 phpinfo() 就算通了,但卡在空白页、500 错误、php-cgi.exe 闪退或 PHP -v 报 DLL 缺失——这些都不是 PHP 没装好,而是 IIS 和 PHP 的“握手方式”没对上。
为什么必须用 Non-Thread Safe(NTS)版 PHP?
IIS 默认通过 FastCGI 启动独立的 php-cgi.exe 进程处理每个请求,每个进程是单线程、隔离的。而 Thread-Safe(TS)版 PHP 是为 Apache 的多线程 MPM 设计的,内部做了线程同步保护,在 IIS 的 FastCGI 模式下不仅多余,还可能触发内存冲突或初始化失败。
- 下载时认准官网
Non-Thread Safe+VC15/VC17(对应 VS2019/VS2022 编译)+x64(除非你明确用 32 位系统) - 路径别放带空格或中文的目录(如
C:\Program Files\php或D:\我的PHP),推荐C:\php或E:\php83 - 解压后立刻检查是否存在
php-cgi.exe—— 如果没有,说明下错包了(TS 版只有php.exe)
php.ini 放哪?改哪些关键项才不报错?
不要把 php.ini 往 C:\Windows 里硬塞。IIS 下的 php-cgi.exe 默认只在自身目录和系统环境变量 PHPRC 指向的路径里找配置文件。放错位置会导致扩展全失效、时区报错、上传失败等静默问题。
- 把
php.ini-production复制一份,重命名为php.ini,就放在 PHP 根目录(如C:\php\php.ini) - 必须取消注释并修正这三行:
extension_dir = "ext"(确保是相对路径,不是绝对路径)date.timezone = "Asia/Shanghai"(不设时区,strtotime()等函数会警告)fastcgi.impersonate = 1(关键!让 PHP 以当前网站用户身份读文件,否则常因权限被拒返回 500) - 启用扩展时,只开真正需要的,比如:
extension=mysqli、extension=mbstring、extension=openssl;php_mysql.dll已废弃,别开
添加模块映射时,“模块”选 FastCgiModule 还是 CgiModule?
选 FastCgiModule。虽然名字像,但 CgiModule 是旧式 CGI(每请求启一个新进程,极慢且易崩),而 FastCgiModule 才真正复用 php-cgi.exe 进程池,是 IIS 官方推荐且唯一稳定的模式。
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南,适用于远程桌面访问、安全 RDP 等。
立即学习“PHP免费学习笔记(深入)”;
- 在 IIS 管理器 → 服务器节点 → “处理程序映射” → 右侧“添加模块映射”
- 请求路径:
*.php
模块:FastCgiModule
可执行文件:C:\php\php-cgi.exe(路径必须精确,不能有尾部反斜杠)
名称:PHP_via_FastCGI - 添加完别急着测,先去“FastCGI 设置”里确认
php-cgi.exe已自动注册;如果没有,手动添加,设置“最大实例数”为4,“活动超时”为300秒,避免进程僵死
测试失败时,第一眼该看哪三个地方?
别一上来就重装。90% 的问题出在这三个具体位置:
- 命令行执行
php -v报VCRUNTIME140_1.dll缺失?→ 装对应 VC++ 运行库:vc_redist.x64.exe(注意:PHP 8.2+ 需 VS2022 运行库,不是 2015 或 2019) - 浏览器打开
index.php是空白或 500,但php -m显示扩展正常?→ 检查 IIS 应用程序池 .NET 版本是否设为“无托管代码”,且“启用 32 位应用程序”要和 PHP 架构一致(x64 PHP 必须关掉此项) - 能显示
phpinfo(),但连不上 MySQL?→ 不是驱动问题,先确认mysqli.default_socket是否为空,Windows 下应设为mysql.sock路径或留空;更大概率是 MySQL 服务没开,或绑定到了127.0.0.1:3306而 PHP 尝试连localhost(触发 socket 模式,但 Windows 默认没配 socket 文件)
最易被忽略的是 FastCGI 进程的生命周期管理:IIS 不会主动杀掉僵死的 php-cgi.exe,一旦某个请求卡住(比如死循环、PDO 连接未 close),整个 FastCGI 实例就会挂住,后续所有 PHP 请求都排队等待——现象就是页面加载变慢或超时,但错误日志里却没报错。所以生产环境务必在“FastCGI 设置”里配好“活动超时”和“重置间隔”。


















