配置 apache 的 documentroot 核心是明确指定网站文件起始目录，并确保权限、路径与上下文三者匹配：必须在服务器配置或 virtualhost 块中声明，同步配置同路径的 directory 块（含 require all granted），保障父目录执行权限及 selinux 上下文，并为多站点配置独立 virtualhost。
配置 Apache 的 DocumentRoot，核心是明确指定网站文件的起始目录，并确保权限、路径和上下文三者匹配。它不是孤立设置的一行指令，而是一组协同生效的配置项。
找到并编辑正确的配置文件
DocumentRoot 必须写在服务器配置或 VirtualHost 块内，不能出现在 .htaccess 或
- 全局主配置：/etc/apache2/apache2.conf（Debian/Ubuntu）或 /etc/httpd/conf/httpd.conf（RHEL/CentOS）
- 虚拟主机配置：/etc/apache2/sites-available/your-site.conf 或 /etc/httpd/conf.d/vhost.conf
- 本地开发环境：XAMPP 是
xampp/apache/conf/httpd.conf，WAMP 是wamp64/bin/apache/apache*/conf/httpd.conf
正确声明 DocumentRoot 和对应 权限
只改 DocumentRoot 不够，必须同步配置同路径的
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 例如设 DocumentRoot "/var/www/site-a"，就要有
<directory></directory>块 - Apache 2.4+ 必须包含
Require all granted（旧版用Allow from all） - 建议开启
AllowOverride All，方便站点使用 .htaccess（如 WordPress、Laravel）
注意路径权限与执行位
Apache 进程用户（如 www-data 或 apache）需要对 DocumentRoot 及其所有父目录拥有执行（x）权限，才能进入目录读取文件。
- 检查命令：
ls -ld /var /var/www /var/www/site-a - 若缺 x 权限，用
sudo chmod +x /var/www补上（不要盲目 chmod 777） - SELinux 环境需校准上下文：
sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/site-a(/.*)?"，再sudo restorecon -Rv /var/www/site-a
多站点必须用独立 VirtualHost
一个 VirtualHost 只能有一个 DocumentRoot。想托管多个网站，不能靠子目录“模拟”根，而要为每个域名或端口建单独的 VirtualHost。
- 比如 site-a.com → DocumentRoot "/srv/site-a/public"，site-b.net → DocumentRoot "/srv/site-b/public"
- 基于域名的配置需启用
NameVirtualHost *:80（Apache 2.4 默认启用），并配好ServerName - 避免把多个站点塞进同一 DocumentRoot 下（如 /var/www/html/a 和 /var/www/html/b），PHP 的绝对路径引用会出错，且无法真正隔离
