PHP怎样实现多站点环境_PHP实现多站点环境虚拟【站点】

PHP多站点需Web服务器虚拟主机配置先行，再通过HTTP_HOST校验、环境变量隔离配置、分库分资源

及日志实现站点隔离。

PHP 本身不直接提供“多站点”功能，真正的多站点环境依赖 Web 服务器（如 Nginx/Apache）的虚拟主机配置 + PHP 的运行上下文隔离。PHP 层要做的，是让同一套代码能根据请求的 Host、HTTP_HOST 或路径，加载不同站点的配置、数据库、模板和资源。

Web 服务器必须先做域名/路径路由

没有 Nginx 的 server 块或 Apache 的 ，PHP 就收不到正确的 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 中读取。

• 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：，或统一用 //{$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 开关。