周四发版后,订单页的站点名变成了「旧站演示」,后台配置里明明是新的。error_log 里一串 PHP NotiCe: Constant SITE_NAME already defined in /data/www/vendor/acme/legacy/src/bootstrap.php on line 12,一分钟两百多条。
我第一反应是 composer.json 里 files 的顺序写反了。项目自己的 bootstrap.php 排在 acme/legacy 前面,按理说应该先执行,常量先定义,后面的 define 只会报警告。
翻到 vendor/composer/autoload_files.php 才发现不是这么回事。这个文件按包依赖拓扑排序生成,root 包的文件确实在前,可我们的常量不在 root 包里,而是放在 acme/config 这个依赖里。acme/legacy 依赖 acme/config,被依赖方排在后面,结果 legacy 先跑。
试过在 composer.json 里调整 require 的书写顺序,跑 composer dump-autoload 后文件顺序纹丝不动。也试过给 legacy 包打 patch,把 define 改成 defined 判断,下次 composer update 补丁就没了。
换了个思路,不去争顺序。新建 app/constants.php,在 public/index.php 里 vendor/autoload.php 之前显式 require 一次,文件里的 define 全部套 defined 判断。这样无论 Composer 怎么排,值都已经定死。
顺手在 CI 里加了一条检查:解析 autoload_files.php,只要出现第二个定义同名常量的文件就失败。发版前拦住,比上线后看日志快。
验证方式是把两个包在 lock 里的顺序故意对调,清 opcache 后访问,Notice 为 0,页面显示的站点名是新值。灰度两台机器跑了一天,日志里再没出现 already defined。
// public/index.php
require __DIR__ . '/../app/constants.php';
require __DIR__ . '/../vendor/autoload.php';
// app/constants.php
if (!defined('SITE_NAME')) {
define('SITE_NAME', 'idc.00645.com');
} 