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 才生效。注意:多个文件名之间用空格分隔,不能用逗号或换行。
立即学习“PHP免费学习笔记(深入)”;
使用 .htaccess 覆盖默认首页(无需改主配置)
如果你没有权限改 httpd.conf(比如某些共享本地环境或 Docker 容器),或者只想对某个子目录生效,可以用 .htaccess 文件。它必须放在目标目录下,且 Apache 需开启 AllowOverride All(XAMPP/WAMP 默认已开)。
在项目根目录新建或编辑 .htaccess,写入:
DirectoryIndex home.php index.php
这样该目录及所有子目录都会按此顺序找首页。注意:.htaccess 中的 DirectoryIndex 会完全覆盖全局配置,不会合并;它只作用于当前目录及其子目录。
发卡宝是一个专业的软件卡密等虚拟商品在线交易平台,拥有多种兑换方式,费率低,结算快,正规企业平台一直稳定运营,24小时不间断提供自动发卡服务。【模板说明】试用版自带一套模板(响应式)【环境支持】PHP环境 / 200M或以上空间大小 / 开启父路径 / 设置index.php为默认首页 / 目录写入权限需要开启【数据库】MySQL【安装步骤】将文件上传至空间目录,运行“http://域名/inst
- 如果子目录有自己独立的
.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。否则,任何根路径请求都会失败——这点最容易被忽略,尤其刚从 XAMPP 切换过来的人。内置服务器本质是单文件脚本转发器,没有“默认首页”概念,所有逻辑都得你自己补全。










