php多站点需Web服务器虚拟主机配置先行，再通过http_HOST校验、环境变量隔离配置、分库分资源及日志实现站点隔离。
PHP 本身不直接提供“多站点”功能，真正的多站点环境依赖 Web 服务器（如 nginx/apache）的虚拟主机配置 + PHP 的运行上下文隔离。PHP 层要做的，是让同一套代码能根据请求的 Host、HTTP_HOST 或路径，加载不同站点的配置、数据库、模板和资源。
Web 服务器必须先做域名/路径路由
没有 Nginx 的 server 块或 Apache 的 Host 头，后续所有“识别站点”逻辑都会失效。常见错误是只改 PHP 代码却忽略服务器配置，导致所有请求都落到默认站点。
- Nginx 示例中必须有
server_name example1.com example2.com;，且每个站点对应独立root或统一入口但传入不同fastcgi_param SITE_NAME example1; - Apache 需启用
NameVirtualHost *:80并为每个域名定义 - 本地开发用
/etc/hosts绑定多个域名到127.0.0.1，否则浏览器根本发不出多 Host 请求
$_SERVER['HTTP_HOST'] 是最常用但需校验的站点标识源
它来自 HTTP 请求头，可被伪造，不能直接用于权限判断或数据库名拼接。生产环境必须白名单校验。
$allowed_hosts = ['site-a.com', 'site-b.net', 'admin.site-c.org']; $host = $_SERVER['HTTP_HOST'] ?? ''; $host = strtolower($host); $host = preg_replace('/:d+$/', '', $host); // 去掉端口 if (!in_array($host, $allowed_hosts)) { http_response_code(400); exit('Invalid host'); } $site_id = array_search($host, $allowed_hosts); // 或映射到配置数组键- 永远用
strtolower()统一大小写，避免Site-A.com和site-a.com被当成两个站 - 注意
HTTP_HOST可能带端口（如localhost:8080），用正则清除再比对 - 不要用
$_SERVER['SERVER_NAME']—— 它取自服务器配置，不是客户端实际请求的域名
用环境变量或配置文件分离各站点参数
硬编码 DB_NAME 或 UPLOAD_DIR 到 PHP 文件里，会导致部署时反复修改代码。推荐在 Web 服务器层注入环境变量，PHP 中读取。
立即学习“PHP免费学习笔记（深入）”；
- Nginx 中：在
location ~ .php$内加fastcgi_param SITE_ENV "prod-site-a"; - PHP 中：
$env = $_SERVER['SITE_ENV'] ?? 'default';，再用$config = require "config/{$env}.php"; - 避免用
.env文件自动加载全站配置 —— 多站点下每个站应有独立.env.site-a，由SITE_ENV决定加载哪个 - 数据库连接建议按站点分库（如
db_site_a,db_site_b），而非单库多前缀，降低误操作风险
静态资源路径和缓存需按站点隔离
同一个 css 文件被两个站点共用，但其中的图片路径写死为 /assets/logo.png，就可能因 document_root 不同而 404；CDN 缓存也容易串站。
- 生成 html 时用动态 base URL：
href="https:///"> //{$host}/assets/ - 上传目录按站点分：
/var/www/uploads/site-a/、/var/www/uploads/site-b/ - redis 缓存键加站点前缀：
$cache_key = "site-{$host}:user:123"; - session 存储若用文件，确保
session.save_path按站点隔离，或改用 Redis 并带命名空间
最易被忽略的是日志和错误报告 —— 所有站点共用一个 Error.log，出问题时无法快速定位是哪个站崩溃。务必为每个站点配置独立的 error_log 路径和 log_errors 开关。