
在 Windows IIS 10 上部署 PHP 8.3.32 网站后,设置默认首页文件(即用户访问根路径时自动加载的入口页)需同时满足两个条件:IIS 要识别并优先尝试该文件名,且该文件必须真实存在、可被 PHP 正确解析(如 index.php)。仅靠 PHP 配置无法实现此功能,必须通过 IIS 的“默认文档”模块显式配置。
确认并添加默认首页文件名
IIS 默认只预置了 Default.htm、Default.asp、index.htm 等静态文件名,不包含 index.php。因此需手动添加:
- 打开 IIS 管理器 → 展开服务器 → 点击目标网站(如“MyPHPApp”)
- 双击右侧功能视图中的默认文档
- 点击右侧操作栏的添加 → 输入
index.php→ 点击确定 - 在列表中选中
index.php,用上方上移按钮将其拖至最顶端(优先级最高)
确保 index.php 文件真实存在且可执行
默认文档只是“名字匹配”,不代表能运行。还需验证:
- 网站物理路径(如
D:\www\myapp)下确实存在index.php - 该文件内容合法,例如至少包含
<?php echo 'OK'; ?>并能被 PHP 正确解析 - 已为该网站正确配置了 PHP 处理程序映射(
*.php→FastCgiModule),否则访问index.php会直接下载或报 500 错误
检查并避免常见冲突
以下情况会导致默认首页失效,需逐一排查:
- 目录浏览未禁用:若默认文档列表为空或无匹配项,IIS 可能返回 403.14(禁止目录浏览)。确保至少有一项有效文件名且已启用默认文档功能
- 文件权限不足:IIS_IUSRS 用户需对网站目录有读取权限(非“修改”或“完全控制”也可);若 PHP 还需写日志或 session,再额外赋予写权限
- 路径含中文/空格/长路径:IIS 和 PHP 在 Windows 下对非 ASCII 字符支持不稳定,建议网站路径全英文、无空格、长度 ≤240 字符
验证是否生效
完成设置后无需重启 IIS 全局服务,但建议重启当前网站(右键网站 → 重新启动):
- 浏览器访问
http://localhost:8080/(或你配置的绑定地址) - 若看到
index.php输出内容,说明成功 - 若仍显示 IIS 欢迎页,说明请求命中了默认站点而非你的 PHP 网站,请检查绑定的 IP/端口/主机名是否唯一
- 若提示 500 错误,重点检查 PHP FastCGI 配置与
php-cgi.exe路径是否正确
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











