IIS配置PHP环境详细教程

本文详细解析了在Windows IIS服务器上成功部署PHP环境的完整实践路径，涵盖自动安装（Web Platform Installer）、手动配置FastCGI与处理程序映射、php.ini关键参数调优、应用程序池兼容性设置以及系统化验证方法，直击“PHP文件被下载而非执行”“500错误”“空白页”等高频故障根源，为运维人员和开发者提供一套清晰、可靠、可复现的一站式解决方案。

如果您在IIS服务器上部署PHP应用时发现页面无法解析或直接下载PHP文件，则可能是IIS未正确加载PHP模块或未配置处理程序映射。以下是实现IIS支持PHP环境的多种配置方法：

一、使用Web Platform Installer安装PHP

Web Platform Installer（Web PI）是微软官方提供的集成工具，可自动下载、配置并注册PHP运行时及IIS模块，适用于Windows Server 2012及以上或Windows 10/11系统。

1、访问Microsoft Web Platform Installer官网，下载并安装Web PI。

2、启动Web Platform Installer，搜索PHP，选择与当前系统架构匹配的版本（如PHP 8.2 x64 Thread Safe）。

3、勾选“PHP for IIS”扩展组件，点击“安装”按钮。

4、安装完成后，Web PI会自动在IIS中添加FastCGI设置和PHP处理程序映射。

二、手动配置FastCGI与处理程序映射

当无法使用Web PI或需指定自定义PHP安装路径时，可通过IIS管理器手动注册PHP为FastCGI应用程序，并绑定.php扩展处理规则。

1、以管理员身份打开IIS管理器，左侧选中服务器节点，在中间面板双击“FastCGI设置”。

2、点击右侧“添加应用程序”，在“完整路径”栏输入PHP可执行文件绝对路径，例如：C:\php\php-cgi.exe。

3、展开“常规”选项，将“监视对文件所做的更改”设为php.ini所在路径；将“活动状态时间限制”设为300秒。

4、返回站点根节点，双击“处理程序映射”，点击右侧“添加模块映射”。

5、请求路径填入*.php，模块选择“FastCgiModule”，可执行文件路径与步骤2一致，名称设为PHP_via_FastCGI。

6、勾选“仅限脚本”，点击确定完成映射。

三、配置php.ini并启用必要扩展

PHP能否正常运行依赖于php.ini配置是否启用关键扩展（如php_cgi.dll、php_opcache.dll），且IIS需能读取该配置文件。

1、复制php.ini-production为php.ini，置于PHP安装目录下（如C:\php\）。

2、用文本编辑器打开php.ini，取消以下行前的分号注释：extension_dir = "ext" 和 cgi.force_redirect = 0。

3、确保fastcgi.impersonate = 1已启用，否则IIS无法模拟用户权限执行PHP脚本。

4、若需MySQL支持，取消extension=mysqli和extension=pdo_mysql前的分号。

5、保存php.ini后，在命令提示符中运行C:\php\php-cgi.exe -i验证配置是否生效并输出PHP信息。

四、调整IIS应用程序池设置

IIS应用程序池的托管管道模式与CPU架构必须与PHP运行时兼容，否则将触发500.19或500.0错误。

1、在IIS管理器中进入“应用程序池”，右键目标池（如DefaultAppPool），选择“高级设置”。

2、将“托管管道模式”设为Classic（非Integrated），因FastCGI不依赖ASP.NET管线。

3、确认“启用32位应用程序”值与PHP版本一致：x86 PHP设为True，x64 PHP设为False。

4、在“进程模型”中，将“标识”设为具有PHP目录读取权限的账户（如ApplicationPoolIdentity或自定义用户）。

5、重启该应用程序池使设置生效。

五、验证PHP运行环境

完成上述任一配置后，需通过实际PHP脚本测试IIS是否成功解析PHP代码，排除静态文件误配或权限问题。

1、在网站根目录（如C:\inetpub\wwwroot\）新建文件info.php，内容为：。

2、使用浏览器访问http://localhost/info.php，若显示PHP配置详情页面则表示配置成功。

3、若返回500错误，检查IIS日志（%SystemDrive%\inetpub\logs\LogFiles\W3SVC*）中对应时间戳的条目，定位FastCGI超时或路径错误。

4、若返回空白页或源码，确认处理程序映射中“仅限脚本”已勾选，且.php扩展未被其他模块（如StaticFileModule）拦截。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《IIS配置PHP环境详细教程》文章吧，也可关注golang学习网公众号了解相关技术文章。