Class not found主因是autoload.php中类路径与目标机实际结构不匹配;需确保PHP版本、必需扩展、composer.lock一致,并用COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader后执行composer dump-autoload -o。

为什么 vendor 目录复制后还报 “Class not found”
不是文件没拷全,而是 autoload.php 里记录的类路径和目标机实际文件结构对不上。PHP 版本微小差异(如 8.2.12 vs 8.2.13)、扩展缺失(mbstring、openssl 没启用)、或 composer.lock 被手动改过,都会让自动加载器生成错误映射。
验证方式很简单:在目标机执行 php -r "require 'vendor/autoload.php';",不报错才算通过。如果报错,别急着重装,先检查这三点:
- 源环境和目标机的 PHP 版本字符串必须完全一致(
php -v输出逐字相同) -
php -m输出里必须包含mbstring、openssl、zlib、curl -
composer.lock文件不能被编辑过,且不含"source": {"type": "git"}这类条目
用 --no-plugins --no-scripts --no-autoloader 组合绕过校验陷阱
即使 vendor/ 已存在,composer install 默认仍会触发插件初始化、脚本执行、autoload 重建——这些环节可能隐式联网或依赖旧上下文。硬性跳过它们,才能让命令真正“只校验不拉取”。
正确命令是:
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader
注意:--no-autoloader 不是省事,而是防止它用残留路径重建出错;之后必须补一记:
composer dump-autoload -o
这个 -o 参数强制生成优化版类映射,比默认散列方式更稳定,尤其适合离线部署。
打包 vendor 时漏文件?别信 .gitignore
直接 tar -czf vendor.tgz vendor/ 很危险。有些包把构建产物(比如前端资源、二进制工具)写在 .gitignore 里,但运行时又真需要——这类文件不会进 Git,但会被 composer install 生成出来。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
稳妥做法是:在目标机同版本 PHP 环境下,先清空 vendor/,再跑一次完整安装:
composer install --no-dev --prefer-dist --optimize-autoloader
装完立刻打包,确保所有运行时必需文件都在里面。如果项目用了 .gitattributes 声明 export-ignore,也要同步检查。
本地包怎么离线加进去?path 仓库 + @dev 是唯一通路
composer require 在断网时必失败,它根本不会看本地目录,第一反应就是连 repo.packagist.org。想加本地包,唯一合法路径是声明 path 类型仓库。
操作要点很具体:
- 本地包根目录下必须有合法
composer.json,含完整"name"(如"acme/utils")和"version"或分支名(如"dev-main") - 项目
composer.json的repositories段加:{"type":"path","url":"./packages/my-utils"} - 执行前必须设环境变量:
COMPOSER_DISABLE_NETWORK=1 - 运行:
composer require acme/utils:@dev(必须带@dev,否则不识别) - 装完立刻跑:
composer dump-autoload -o,否则class_exists()一定返回false
最容易被忽略的是环境变量——没它,哪怕写了 path,Composer 仍会 fallback 到 Packagist 并报错 Could not fetch https://repo.packagist.org/packages.json。










