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 中读取。
一款基于PHP+MYSQL开发的企业网站管理软件,具有灵活的栏目内容管理功能和丰富的网站模版,可用于创建各种企业网站。v5.1版本支持了PHP5+MYSQL5环境,前台网站插件开放源码,更利于个性化的网站开发。具有以下功能特点和优越性:[>]模版精美实用具有百款适合企业网站的精美模版,并在不断增加中[>]多语言支持独立语言包,支持GBK,UTF8编码方式,可用于创建各种语言的网站[&g
立即学习“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 开关。










