IIS10配置PHP7.3环境教程

本文详细解析了在IIS 10上成功部署PHP 7.3的关键技术要点与常见陷阱：必须严格使用NTS（非线程安全）版本、VC15运行库及php-cgi.exe配合FastCGI模式（禁用ISAPI），并强制设置cgi.fix_pathinfo=0，否则必现500错误；同时深入剖析了FastCGI应用注册与处理器映射需路径完全一致、php.ini中fastcgi.impersonate、extension_dir和时区等核心配置的精确写法，以及快速定位源码泄露、空白页或500错误的三步排查法——帮你绕过90%的配置坑，一次配通稳定运行。

直接上结论：IIS 10 运行 PHP 7.3 必须用 php-cgi.exe + FastCGI 模式，不能用 ISAPI；必须选 Non-Thread-Safe (NTS) 版本，且依赖 VC15 运行库；php.ini 里 cgi.fix_pathinfo=0 是硬性要求，漏掉就会 500 错误。

为什么必须用 NTS 版本和 php-cgi.exe

IIS 10 的 FastCGI 模块是单线程、进程隔离模型，与 PHP 的线程安全（TS）版本设计冲突。TS 版本会尝试管理线程本地存储，而 FastCGI 进程每次请求都可能被复用或回收，导致内存错乱或崩溃。NTS 版本不干预线程模型，只专注处理单次 CGI 请求，稳定性高。

• 下载时务必认准文件名含 -nts- 和 VC15（如 php-7.3.11-nts-Win32-VC15-x64.zip）
• 解压后确认目录下存在 php-cgi.exe —— 如果只有 php.exe，说明下错了 TS 版本
• 运行 php-cgi -v 命令验证：成功输出版本号即通过；报“缺少 VCRUNTIME140.dll”需先装 Visual C++ 2015-2019 Redistributable (x64)

FastCGI 设置和处理器映射的坑点

IIS 管理器里“处理程序映射”只是入口，真正起作用的是底层 FastCGI 应用注册。两者不同步是 500/404/空白页最常见的原因。

• 先在“IIS”节点双击打开 FastCGI 设置，点击右侧“添加应用程序”，填入完整路径：C:\PHP\php-cgi.exe（路径必须精确，不能用相对路径或环境变量）
• 再进站点或服务器级别的“处理程序映射”→“添加模块映射”，请求路径填 *.php，模块选 FastCgiModule，可执行文件填同一路径，名称随意（如 PHP_via_FastCGI）
• 勾选“调用程序时验证文件是否存在”——否则访问不存在的 xxx.php 会返回 500 而非 404
• 别碰 CgiModule：它对应传统 CGI，启动慢、无进程复用，IIS 10 官方已不推荐

php.ini 关键配置项不能省略

PHP 7.3 在 IIS 下对某些 ini 项敏感，尤其涉及路径解析和权限模拟。默认的 php.ini-development 或 php.ini-production 都不能直接用。

• cgi.fix_pathinfo=0：必须显式设为 0。设为 1 时，IIS 传入的 PATH_INFO 会被二次解析，导致路由错误或 500
• fastcgi.impersonate=1：启用后 PHP 进程会以当前网站匿名用户（通常是 IUSR）身份读取文件，避免权限拒绝
• extension_dir = "C:\PHP\ext"：路径必须绝对、结尾不带反斜杠，且与实际 ext 目录一致；否则 extension=mysqli 等会静默失败
• 时区必须设：date.timezone="Asia/Shanghai"，否则 phpinfo() 里时间相关函数报错

测试失败时优先查这三处

写完 info.php 访问却看到源码、500 或空白？不用重装，按顺序快速定位：

• 浏览器 F12 查 Network → Response，看是否返回纯文本（说明 IIS 没触发 PHP，处理器映射失效）
• 查 Windows 事件查看器 → Windows 日志 → 应用程序，筛选来源为 IIS-IIS Manager 或 PHP-CGI，常有明确报错如“无法加载 ext\php_mysqli.dll”
• 临时把 php.ini 里所有 extension= 行注释掉，仅保留核心配置重启 IIS，再试 phpinfo() —— 若成功，说明某个扩展 DLL 与 PHP 7.3 不兼容（比如旧版 php_redis.dll）

最易忽略的是：修改 php.ini 后没重启 IIS（iisreset /noforce），或 FastCGI 应用注册路径和处理器映射路径不一致 —— 这两个地方必须完全相同，一个字符都不能差。

好了，本文到此结束，带大家了解了《IIS10配置PHP7.3环境教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！