本文详解在 apache + php 本地开发环境中查找文档根目录的方法，包括配置文件定位、关键指令识别及常见路径示例，帮助初学者准确部署 php 文件并成功通过 http://localhost 访问。
本文详解在 apache + php 本地开发环境中查找文档根目录的方法，包括配置文件定位、关键指令识别及常见路径示例，帮助初学者准确部署 php 文件并成功通过 http://localhost 访问。
当你首次尝试在本地运行 PHP（例如输出 "Hello World"），却无法通过 https://www.php.cn/link/963804be09622f182e4dde9d9e0568fa 访问时，最常见的原因就是：PHP 文件未放置在 Web 服务器认可的“文档根目录”（Document Root）下。该目录是 Apache（或其他 Web 服务器）默认提供 HTTP 服务的起始文件夹，所有通过浏览器请求的 URL 都以此目录为基准进行路径解析。
? 查找 DocumentRoot 的标准方法（以 Apache 为例）
Apache 的文档根目录由配置文件中的 DocumentRoot 指令明确指定。你需要定位并打开主配置文件：
Windows（XAMPP/WAMP）：通常位于
C:\xampp\apache\conf\httpd.conf 或
C:\wamp64\bin\apache\apache{version}\conf\httpd.confmacOS（MAMP 或手动安装）：常见路径为
/Applications/MAMP/conf/apache/httpd.conf 或
/etc/apache2/httpd.confLinux（Ubuntu/Debian）：多为
/etc/apache2/sites-enabled/000-default.conf（虚拟主机配置中）或
/etc/apache2/apache2.conf
打开对应文件后，使用搜索功能查找关键词 DocumentRoot。你会看到类似如下行：
DocumentRoot "/Applications/MAMP/htdocs" # 或 DocumentRoot "/var/www/html" # 或 DocumentRoot "C:/xampp/htdocs"
✅ 这一行引号内的路径，就是你的文档根目录——你必须将 hello.php 等 PHP 文件保存在此目录（或其子目录）中，才能通过 https://www.php.cn/link/963804be09622f182e4dde9d9e0568fa 正常访问。
⚠️ 注意事项与验证技巧
- 路径区分大小写：Linux/macOS 下路径严格区分大小写（如 /var/www/HTML ≠ /var/www/html），Windows 则不敏感，但仍建议统一小写以利跨平台兼容。
- 重启服务生效：修改配置后，务必重启 Apache（如 XAMPP 控制面板点击 “Stop/Start”，或终端执行 sudo systemctl restart apache2）。
-
快速验证是否正确：在文档根目录下新建一个 info.php 文件，内容为：
<?php phpinfo(); ?>
然后访问 https://www.php.cn/link/31bd2c1425f9766a5081c75efff468bd。若页面正常显示 PHP 配置信息，则证明路径和服务器均已就绪。
-
不要混淆 Directory 和 DocumentRoot：前者定义目录权限（如
），后者才是实际的 Web 根路径；二者路径通常一致，但逻辑不同。
✅ 总结
文档根目录不是固定不变的“标准位置”，而是由 Web 服务器配置决定的可定制路径。对 PHP 新手而言，掌握从 httpd.conf 中识别 DocumentRoot 是搭建本地开发环境的第一步。记住三要素：找对配置文件 → 搜索 DocumentRoot → 将代码放进去 → 重启服务 → 浏览器验证。一旦定位准确，后续的 PHP 开发、路由调试、静态资源引用都将变得清晰可控。
