本文详解在使用 apache 搭建 php 本地开发环境时，如何快速定位并确认文档根目录（documentroot），避免因文件存放路径错误导致网页无法访问。
本文详解在使用 apache 搭建 php 本地开发环境时，如何快速定位并确认文档根目录（documentroot），避免因文件存放路径错误导致网页无法访问。
当你首次运行 localhost 并尝试通过浏览器访问 http://localhost/hello.php 却收到“404 Not Found”错误时，大概率是因为 PHP 文件未放置在 Web 服务器所识别的文档根目录（Document Root）中。该目录是 Apache（或其他 Web 服务器）默认查找和提供静态/动态资源的起点，所有可通过 http://localhost/xxx 访问的文件都必须位于此目录或其子目录下。
✅ 查找 DocumentRoot 的标准方法（以 Apache 为例）
Apache 的文档根目录由配置文件中的 DocumentRoot 指令明确指定。常见路径取决于你的安装方式：
| 安装方式 | 典型 DocumentRoot 路径 |
|---|---|
| XAMPP（Windows/macOS） | C:\xampp\htdocs 或 /Applications/XAMPP/xamppfiles/htdocs |
| MAMP（macOS/Windows） | /Applications/MAMP/htdocs 或 C:\MAMP\htdocs |
| macOS 自带 Apache | /Library/WebServer/Documents |
| Linux（apt/yum 安装） | /var/www/html（Debian/Ubuntu）或 /var/www（CentOS/RHEL） |
? 操作步骤：
- 找到 Apache 主配置文件 httpd.conf（XAMPP 中通常位于 xampp/apache/conf/httpd.conf；MAMP 在 MAMP/conf/apache/httpd.conf）
- 使用文本编辑器（如 VS Code、Notepad++ 或 nano）打开该文件
- 搜索关键词 DocumentRoot，你会看到类似以下行：
DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs"
<Directory "/Applications/XAMPP/xamppfiles/htdocs">
# 后续权限配置...✅ 此处双引号内的路径即为你的文档根目录——将 hello.php 等文件放入该目录后，即可通过 http://localhost/hello.php 正常访问。
⚠️ 注意事项与验证技巧
- 路径区分大小写：Linux/macOS 下路径严格区分大小写（如 Htdocs ≠ htdocs），Windows 相对宽松但建议统一小写。
- 重启 Apache 生效：修改 httpd.conf 后务必重启 Apache 服务（XAMPP 控制面板点击 “Stop” → “Start”）。
-
快速验证是否正确：在文档根目录下新建一个 info.php，内容为：
<?php phpinfo(); ?>
访问 http://localhost/info.php，若显示 PHP 信息页，则说明路径和配置均正确。
- 不要混淆 ServerRoot 和 DocumentRoot：前者是 Apache 自身配置/日志等文件所在目录（如 /usr/local/apache2），后者才是你放网站文件的地方。
? 小结
文档根目录不是固定值，而是由 Web 服务器配置决定的逻辑入口。新手不必依赖“教程截图中的路径”，而应主动查阅本地 Apache 的 httpd.conf —— 这是唯一权威来源。掌握这一方法，不仅能解决“Hello World 无法显示”的问题，更是后续搭建多项目、配置虚拟主机、部署 Laravel/WordPress 等框架的基础能力。
