“关键帧清理”是误用术语,真正需解决的是vendor目录体积大问题,根源在于安装策略、.git残留、dev依赖、autoload未优化及打包时未排除无关文件。

“关键帧清理”不是 Composer 的概念,这属于误用术语;真正要解决的是 vendor 目录体积大、打包后二进制臃肿的问题——根源在安装策略和残留内容,不在“帧”或压缩算法。
为什么删了 tests/docs 还是大?
手动删 tests/、docs/ 看似合理,但 Composer 默认不从 dist 包里排除它们,且很多包(如 guzzlehttp/guzzle、monolog/monolog)的 zip 发布版本身就含这些目录。更关键的是:.git 目录、vendor/bin/、未优化的 autoload 映射、dev-only 依赖,才是体积主力。
- 运行
du -sh vendor/* | sort -hr | head -3查最大包,再进对应目录看有没有.git或tests/子目录 - 确认是否用了
--prefer-source:若是,vendor/下每个包都带完整 Git 仓库,rm -rf vendor && composer install --no-dev才能清掉 - 检查
composer.json的config段是否设了"discard-changes": true,否则下次 install 仍会拉 .git
composer install --no-dev 不生效?检查这三处
--no-dev 只跳过 require-dev 声明的包,但有些包被其他依赖“悄悄带进来”,比如 symfony/debug-bundle 被 laravel/framework 间接 require。这类包不会出现在你的 composer.json 里,却真实存在 vendor 中。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行
composer show --dev看哪些 dev 包被装了;再跑composer depends --tree symfony/debug-bundle查它怎么进来的 - 若确认线上完全不用,可在
composer.json的conflict段加"symfony/debug-bundle": "*",强制阻止安装 - 某些包(如
phpunit/phpunit)即使没在 require-dev 里,也可能因vendor/bin/phpunit软链存在而被保留——删vendor/bin/本身没用,得从源头掐断依赖
autoload 优化失败?看 classmap 是否真生成
--optimize-autoloader 生效的前提是:所有包的 autoload 配置干净,且最终生成了 vendor/composer/autoload_classmap.php。如果这个文件为空或不存在,说明优化根本没走。
- 检查
vendor/composer/autoload_static.php里$classMap数组长度是否 > 0;若为 0,说明有包用了动态扫描(如psr-4映射到含tests/的目录) - 运行
composer dump-autoload -o -v(加-v看详细日志),留意是否有警告 like “Cannot use classmap for … because directory does not exist” - 对问题包,可临时 fork 后删掉其
composer.json中 autoload.classmap 里指向tests/或examples/的条目,再发布私有版本
UPX 压缩失败时别硬上 --no-compress
frankenphp build --no-compress 不是“轻量方案”,而是放弃压缩——结果往往比 UPX 失败前还大 20%。真正该做的是定位 UPX 报错原因:
- 报
CantPackException: load segment address overlap?说明 PHP 扩展加载冲突,重点检查php.ini中extension=行,注释掉非必需项(如gd、opcache若已静态编译进 FrankenPHP 就冗余) - 先构建无压缩版:
frankenphp build --output app --server-name example.com --no-compress - 再手动试 UPX:
upx --best --lzma app;若仍失败,用readelf -l app | grep LOAD看段地址是否重叠,确认是 FrankenPHP 构建参数问题还是扩展干扰
最易被忽略的一点:FrankenPHP 打包时默认把整个项目目录(含隐藏文件)全塞进去,.gitignore 不起作用;必须用 rsync -a --exclude='.git' --exclude='tests' ... 或 git archive 提前整理源码树,否则再怎么优化 autoload 也白搭。

















