在Windows系统搭建本地PHP环境时,默认Apache的网站根目录通常是安装目录下的htdocs文件夹,很多开发者会把项目放在其他自定义路径,这时候就需要修改Apache的文档根目录。下面一步步讲解具体操作。

修改前的准备工作
首先确认你的Apache安装路径,比如常见的安装路径是C:\Apache24,如果是通过集成环境如WAMP、XAMPP搭建的,需要找到对应集成环境下的Apache配置目录,比如XAMPP的Apache配置文件在C:\xampp\apache\conf目录下。
提前准备好你要设置的新的网站根目录,比如你想把根目录设置为D:\php_projects,确保这个目录已经存在,并且里面可以放一个测试用的PHP文件,方便后续验证修改是否生效。
修改Apache配置文件
找到Apache的配置文件httpd.conf,用记事本或者任意文本编辑器打开这个文件,注意不要用带格式的工具打开,避免修改后文件格式出错。
在配置文件中搜索DocumentRoot,你会找到类似下面这样的默认配置:
# 默认根目录配置,路径根据你的实际安装情况不同
DocumentRoot "C:/Apache24/htdocs"
<Directory "C:/Apache24/htdocs">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>把上面两处路径都替换成你自定义的目录路径,注意Windows路径里的反斜杠要换成正斜杠,修改后如下:
# 修改为自定义根目录
DocumentRoot "D:/php_projects"
<Directory "D:/php_projects">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>如果你的Apache版本比较旧,可能没有Require all granted的配置,而是Allow from all,保持原有配置不变即可,不要随意修改权限相关的参数,避免造成访问权限问题。
重启Apache服务
修改完配置文件后,需要重启Apache服务让配置生效。如果是手动安装的Apache,可以打开命令提示符,切换到Apache的bin目录,执行下面的命令:
# 停止Apache服务 httpd -k stop # 启动Apache服务 httpd -k start
如果是用集成环境的话,直接在集成环境的管理面板里点击重启Apache的按钮即可。重启过程中如果提示配置错误,说明你修改的路径有问题或者格式不对,需要回去检查配置文件。
验证修改是否生效
在你设置的新根目录D:\php_projects下新建一个test.php文件,写入下面的测试代码:
<?php // 输出当前PHP环境信息 phpinfo(); ?>
打开浏览器,访问127.0.0.1/test.php,如果能正常显示PHP的信息页面,说明网站根目录修改成功。如果访问出现403禁止访问或者404找不到页面的错误,可以参考下面的常见问题排查。
常见问题排查
- 如果访问出现403错误,检查新设置的目录是否有足够的访问权限,右键目录选择属性,在安全选项卡里给Users组添加读取和执行的权限。
- 如果访问出现404错误,检查配置文件里的路径是否和实际的目录路径一致,注意斜杠的方向,以及路径是否有拼写错误。
- 如果重启Apache失败,打开命令提示符执行
httpd -t命令,可以检查配置文件的语法错误,根据提示修改对应行的内容即可。
按照上面的步骤操作,就可以顺利完成Windows本地PHP环境下Apache网站根目录的修改,后续开发只需要把项目放在自定义的根目录下,就能通过本地地址直接访问了。
PHP环境Apache文档根目录Windows本地环境网站根目录修改修改时间:2026-05-30 23:20:50