多个站点共享php代码时,应通过运行时加载不同配置文件隔离环境,依据http_host或部署路径选择对应config/*.php,确保log_path、cache_path、upload_path、session_save_path等绝对路径及敏感项各自独立,并在cli场景下通过–env参数或app_env环境变量显式指定环境。

多个站点共享同一份 PHP 代码时,如何用配置文件隔离环境
核心在于:**不改代码、不复制源码、靠运行时加载不同配置来区分数据库、域名、缓存路径等关键参数**。PHP 本身没有“内置多租户配置机制”,得靠约定+加载逻辑实现,否则容易出现 A 站点删了 B 站点的缓存,或写错日志到同一文件里。
入口文件(如 index.php)必须做配置路由判断
不能让所有站点都走同一个 index.php 加载同一份 config.php。常见做法是根据 $_SERVER['HTTP_HOST'] 或子目录路径决定加载哪个配置:
- 用
$_SERVER['HTTP_HOST']区分域名(如site-a.com→config/site-a.php) - 用
$_SERVER['SCRIPT_FILENAME']或dirname(__DIR__)判断部署路径(适合子目录部署,如/var/www/site-b/→config/site-b.php) - 避免硬编码主机名,推荐把映射关系写进一个主路由配置(如
config/environments.php),再由入口统一查表加载
错误示例:require 'config.php'; —— 这会让所有站点共用一份配置,后续任何环境差异都会互相污染。
config/*.php 文件里必须隔离绝对路径和运行时敏感项
配置文件不是只填数据库密码就够了。以下几类必须动态隔离,否则会出问题:
立即学习“PHP免费学习笔记(深入)”;
-
LOG_PATH:不同站点日志不能写进同一个文件,否则 tail -f 会混乱,权限也可能冲突 -
CACHE_PATH:OPcache、File cache、Twig 缓存目录必须分开,否则 A 站点清缓存会干掉 B 站点的编译模板 -
UPLOAD_PATH和UPLOAD_URL:上传目录若共用,用户头像可能被跨站覆盖 -
SESSION_SAVE_PATH:PHP 默认用系统临时目录,多站点下 session_id 冲突概率高,应设为/tmp/session/site-a这类独立路径
建议每个配置文件返回一个数组,并在加载后立即校验关键键是否存在,比如:if (!isset($config['DB_HOST'])) { die('Missing DB_HOST in config'); }
注意 CLI 场景下 $_SERVER 不可靠,需额外约定识别方式
Web 请求能靠 HTTP_HOST 区分,但命令行执行 php artisan migrate 或 php cron.php 时,$_SERVER 是空的。这时候必须显式传参或读取环境变量:
- 启动命令加
--env=site-b参数,入口解析后加载对应配置 - 用
getenv('APP_ENV'),配合export APP_ENV=site-c部署时设置 - 禁止在 CLI 下 fallback 到默认配置——那等于没隔离
最容易被忽略的是队列消费者、定时任务、websocket 后台进程,它们长期运行,一旦加载错配置,可能数小时才暴露问题。