xampp教程htdocs怎么用？-建站教程-锦华智联科技

XAMPP `htdocs` 目录终极教程

什么是 `htdocs`？

htdocs 是 Apache Web 服务器的默认 Web 根目录。

（图片来源网络，侵删）

你放在 htdocs 文件夹里的所有文件，都可以通过浏览器访问。

默认路径：C:\xampp\htdocs\ (Windows) 或 /Applications/XAMPP/htdocs/ (macOS/Linux)。
访问地址：http://localhost/ 或 http://127.0.0.1/。

当你启动 XAMPP 并启动 Apache 服务后，浏览器访问 http://localhost/ 时，Apache 就会自动去 htdocs 目录下寻找一个名为 index.html、index.php 或其他默认首页文件并将其显示出来。

为什么 `htdocs` 如此重要？

htdocs 是你本地开发环境的“公开展厅”，你的所有网站项目、网页文件、图片、CSS 样式表、JavaScript 脚本等，都必须存放在这里才能被 Apache 服务器解析和展示。

安全隔离：htdocs 目录外的文件，例如你的个人文档或 XAMPP 的系统文件，是无法通过 http://localhost/ 直接访问的，这保证了开发环境的安全性。
统一入口：所有项目都从这里开始，方便你管理多个网站。

如何使用 `htdocs`？（分步详解）

第 1 步：启动 XAMPP 服务

在开始之前,请确保 XAMPP 已经启动，Apache 服务是运行状态。

（图片来源网络，侵删）

打开 XAMPP Control Panel。
点击 Apache 模块的 Start 按钮。
确保状态显示为 Running（绿色）。

第 2 步：创建你的第一个项目（网站）

为了方便管理,我们通常不会把所有文件都直接扔进 htdocs，而是为每个项目创建一个子文件夹。

打开 htdocs 目录：
- 在 Windows 上，可以直接在 XAMPP Control Panel 的 "Apache" 模块下点击 "Explorer" 按钮。
- 或者手动在文件资源管理器中导航到 C:\xampp\htdocs\。
创建项目文件夹：在 htdocs 目录下，新建一个文件夹，命名为 my-first-website（或任何你喜欢的名字）。

创建网页文件：进入 my-first-website 文件夹，创建一个名为 index.html 的文件，并写入以下内容：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>我的第一个本地网站</title>
</head>
<body>
    <h1>你好，世界！</h1>
    <p>欢迎来到我的本地开发环境！</p>
</body>
</html>

第 3 步：通过浏览器访问你的网站

奇迹发生了！

打开你的浏览器（Chrome, Firefox, Edge 等）。
在地址栏输入：http://localhost/my-first-website/
按下回车键。

你应该能看到你刚刚创建的 "你好，世界！" 页面了！

重要提示：

访问 http://localhost/ 会直接显示 htdocs 目录下的默认首页文件。
访问 http://localhost/你的项目文件夹名/ 就能访问到对应的项目。

`htdocs` 进阶使用技巧

技巧 1：如何创建多个项目？

非常简单！你只需要在 htdocs 目录下创建多个不同的文件夹即可。

htdocs\project-a\ -> 访问地址：http://localhost/project-a/
htdocs\project-b\ -> 访问地址：http://localhost/project-b/
htdocs\blog\ -> 访问地址：http://localhost/blog/

这样你就可以同时开发多个不同的网站项目,互不干扰。

技巧 2：如何为项目设置一个更友好的域名？（虚拟主机）

每次输入 http://localhost/project-name 有点麻烦，我们可以为每个项目设置一个自定义的域名，http://project-a.local。

配置 hosts 文件：这个文件用于将域名映射到本地 IP 地址。
- Windows: C:\Windows\System32\drivers\etc\hosts
- macOS/Linux: /etc/hosts
- 注意：你需要用管理员权限（或 sudo）编辑这个文件。
在文件末尾添加以下两行（每行一个项目）：
```
0.0.1       project-a.local
127.0.0.1       project-b.local
```
保存文件。

配置 Apache 虚拟主机：

打开 XAMPP 的 Apache 配置目录：C:\xampp\apache\conf\extra\ (Windows) 或 /Applications/XAMPP/etc/extra/ (macOS)。
找到并编辑 httpd-vhosts.conf 文件。
在文件末尾添加以下配置（每个项目一个配置块）：

# project-a.local 的配置
<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/project-a"  # 你的项目绝对路径
    ServerName project-a.local
    <Directory "C:/xampp/htdocs/project-a">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
# project-b.local 的配置
<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/project-b"  # 你的项目绝对路径
    ServerName project-b.local
    <Directory "C:/xampp/htdocs/project-b">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

注意：路径中的反斜杠在 Windows 上也可以使用，但推荐使用正斜杠，因为它在所有系统上都能被 Apache 正确识别。

重启 Apache：回到 XAMPP Control Panel，点击 Apache 模块的 Stop 按钮，然后再点击 Start 按钮，以使新配置生效。
访问测试：现在在浏览器中访问 http://project-a.local，你应该能看到 project-a 项目的内容了！

技巧 3：如何处理 URL 中的 `.php` 后缀？

如果你使用 PHP 框架（如 Laravel, Symfony），通常希望 URL 是干净的，http://localhost/project/public/home 而不是 http://localhost/project/public/index.php/home。

这需要配置 Apache 的 URL 重写 功能。

确保 mod_rewrite 模块已启用：在 XAMPP 的 apache\conf\httpd.conf 文件中，找到下面这行，确保它没有被注释掉（行首没有）： LoadModule rewrite_module modules/mod_rewrite.so
在项目目录中创建 .htaccess 文件：在你的项目根目录（htdocs\my-project\）下创建一个名为 .htaccess 的文件，这个文件可以对当前目录及其子目录的 URL 进行重写规则设置。

一个常见的 .htaccess 示例（适用于将所有请求转发给 index.php）：
```
<IfModule mod_rewrite.c>
    RewriteEngine On
    # 如果请求的不是真实存在的文件或目录
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    # 将所有请求重写到 index.php
    RewriteRule . index.php [L]
</IfModule>
```
重启 Apache。
访问测试：现在你可以访问不包含 .php 的 URL 了。

常见问题与解决方案

问题现象	可能原因	解决方案
访问 `http://localhost/` 显示 403 Forbidden 错误	Apache 未启动。 `htdocs` 目录权限问题。	在 XAMPP Control Panel 中启动 Apache。检查 `htdocs` 文件夹的读取权限。
访问项目时显示 404 Not Found	URL 输入错误，文件夹名或文件名拼写错误。文件放错了位置，不在 `htdocs` 或其子目录中。	仔细检查 URL 和文件路径。确保文件位于 `htdocs` 目录下。
PHP 文件无法执行，直接显示代码	Apache 的 `mod_php` 模块未启用。 XAMPP 的 PHP 模块未启动。	在 `httpd.conf` 中确认 `LoadModule php_module ...` 行存在且未被注释。在 XAMPP Control Panel 中确保 PHP 模块已启动。
自定义域名（如 `project-a.local`）无法访问	`hosts` 文件未配置或保存失败。 `httpd-vhosts.conf` 配置错误。 Apache 未重启。	检查 `hosts` 文件，确保域名和 IP 正确，并保存。检查 `httpd-vhosts.conf` 中的 `DocumentRoot` 和 `ServerName`。重启 Apache。

htdocs 是 XAMPP 环境的核心，是你所有本地网站的起点。

基础：把你的网站文件放在 htdocs 或其子文件夹中，通过 http://localhost/文件夹名/ 访问。
进阶：通过创建子文件夹来管理多个项目。
专业：通过配置 hosts 文件和 httpd-vhosts.conf 来使用自定义域名，提升开发体验。
框架：通过 .htaccess 文件实现 URL 重写，支持现代 PHP 框架的开发。

掌握了 htdocs 的使用，你就已经掌握了本地 Web 开发的 80%！祝你开发愉快！

xampp教程htdocs怎么用？

XAMPP htdocs 目录终极教程

什么是 htdocs？

为什么 htdocs 如此重要？

如何使用 htdocs？（分步详解）