多个站点共享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 后台进程，它们长期运行，一旦加载错配置，可能数小时才暴露问题。
