0

0

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

看不見的法師

看不見的法師

发布时间:2026-01-17 18:26:40

|

917人浏览过

|

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

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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2601

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1626

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1510

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1417

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1447

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

40

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.7万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 7.4万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号