PHP本地环境如何设置默认首页_PHP本地环境设默认首页规则【设定】

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

php本地环境如何设置默认首页_php本地环境设默认首页规则【设定】

Apache 的 DirectoryIndex 是控制默认首页的核心配置

PHP 本地环境(如 XAMPP、WAMP、MAMP 或手动搭建的 Apache)中,默认首页不是由 PHP 决定的,而是由 Web 服务器决定。Apache 默认查找的文件名顺序是 index.htmlindex.htmindex.php,这个顺序由 DirectoryIndex 指令控制。如果你放一个 home.php 在根目录却打不开,浏览器返回 403 或 404,大概率就是它没被列在 DirectoryIndex 里。

修改方法:打开 Apache 配置文件(通常是 httpd.confextra/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.phphome.php
  • 若指定的文件不存在,Apache 会继续尝试下一个,直到全部失败后返回 403(禁止列表)或 404(启用目录浏览时才可能显示)

Nginx 环境下用 index 指令替代

如果你用的是 Nginx(如 Laragon、Docker + nginx:alpine 或手动编译),规则完全不同:DirectoryIndex 不起作用。Nginx 使用 index 指令,在 serverlocation 块中声明:

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 切换过来的人。

内置服务器本质是单文件脚本转发器,没有“默认首页”概念,所有逻辑都得你自己补全。

https://www.php.cn/faq/1994807.html

发表回复

Your email address will not be published. Required fields are marked *