Apache 的 DirectoryIndex 指令控制默认首页文件顺序,如需优先加载 home.php,应修改为 DirectoryIndex home.php index.php index.html index.htm 并重启服务;.htaccess 可局部覆盖该配置;Nginx 使用 index 指令替代;PHP 内置服务器不支持自动首页,需手动路由。

Apache 的 DirectoryIndex 是控制默认首页的核心配置
PHP 本地环境(如 XAMPP、WAMP、MAMP 或手动搭建的 Apache)中,默认首页不是由 PHP 决定的,而是由 Web 服务器决定。Apache 默认查找的文件名顺序是 index.html → index.htm → index.php,这个顺序由 DirectoryIndex 指令控制。如果你放一个 home.php 在根目录却打不开,浏览器返回 403 或 404,大概率就是它没被列在 DirectoryIndex 里。
修改方法:打开 Apache 配置文件(通常是 httpd.conf 或 extra/httpd-default.conf),找到这行:
DirectoryIndex index.html index.htm index.php
把它改成你想要的顺序,比如优先加载 home.php:
DirectoryIndex home.php index.php index.html index.htm
改完必须重启 Apache 才生效。注意:多个文件名之间用空格分隔,不能用逗号或换行。
使用 .htaccess 覆盖默认首页(无需改主配置)
如果你没有权限改 httpd.conf(比如某些共享本地环境或 Docker 容器),或者只想对某个子目录生效,可以用 .htaccess 文件。它必须放在目标目录下,且 Apache 需开启 AllowOverride All(XAMPP/WAMP 默认已开)。
在项目根目录新建或编辑 .htaccess,写入:
DirectoryIndex home.php index.php
这样该目录及所有子目录都会按此顺序找首页。注意:.htaccess 中的 DirectoryIndex 会完全覆盖全局配置,不会合并;它只作用于当前目录及其子目录。
- 如果子目录有自己独立的
.htaccess,则以子目录的为准 - 文件名区分大小写(
Home.php≠home.php) - 若指定的文件不存在,Apache 会继续尝试下一个,直到全部失败后返回 403(禁止列表)或 404(启用目录浏览时才可能显示)
Nginx 环境下用 index 指令替代
如果你用的是 Nginx(如 Laragon、Docker + nginx:alpine 或手动编译),规则完全不同:DirectoryIndex 不起作用。Nginx 使用 index 指令,在 server 或 location 块中声明:
location / {
index home.php index.php index.html;
}
这个顺序同样是从左到右匹配,找到第一个存在的就返回。注意:
-
index后面的文件名必须显式带扩展名,不能写index - 如果用
try_files(常见于 Laravel 等框架),index可能被绕过,此时需确保try_files $uri $uri/ /index.php?$query_string;中的 fallback 路径与实际入口一致 - 改完要运行
nginx -t检查语法,再nginx -s reload
PHP 内置服务器(php -S)不支持自动首页,必须手动路由
PHP 自带的开发服务器(php -S localhost:8000)**完全不读取 DirectoryIndex 或 .htaccess**。它默认只响应精确路径,访问 http://localhost:8000/ 会直接报 404,除非你显式写路由回调。
解决方法:创建一个简单的路由器文件(如 router.php):
php -S localhost:8000 router.php
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











