应本地执行 composer install 生成 vendor 目录后整体上传，确保 composer.json 和 composer.lock 同步上传，验证 autoload.php 路径正确且 PHP 版本匹配约束。
虚拟主机不支持全局 composer 命令怎么办
绝大多数共享虚拟主机（比如阿里云万网、腾讯云轻量应用服务器的「虚拟空间」模式、Godaddy 共享主机等）默认不提供 SSH 访问，也没有预装 composer，更不会把 composer 加入系统 PATH。所以直接在控制面板或文件管理器里点“运行命令”是没用的——composer 命令根本不存在。
解决思路不是“装 composer”，而是绕过命令行，用本地生成好的依赖包上传部署：
- 在自己电脑上用
composer install --no-dev --optimize-autoloader生成完整的vendor/目录 - 确保
composer.json和composer.lock一起上传（尤其composer.lock必须有，否则线上环境行为不可控） - 上传时跳过
vendor/bin/（除非你真用了里面某个可执行脚本） - 检查虚拟主机 PHP 版本是否 ≥
composer.json中"php": ">=8.0"这类约束，不匹配会静默失败
没有 SSH 怎么执行 composer install
有些虚拟主机提供“PHP 执行脚本”功能（如 cPanel 的 “Cron Jobs” 或 “PHP Version Selector” 附带的“运行 PHP 脚本”入口），但这类接口通常不允许执行 shell 命令，exec('composer install') 或 shell_exec() 大概率被禁用，且工作目录、PATH、超时限制都不可控。
更稳妥的做法是：用 PHP 脚本模拟最小化安装逻辑（仅加载 autoloader，不触发下载）：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
<?php
// install.php，上传后浏览器访问一次（记得后续删掉）
if (file_exists('vendor/autoload.php')) {
require 'vendor/autoload.php';
echo "Autoloader OK";
} else {
die("vendor/autoload.php not found — run composer install locally first");
}
- 这个脚本不替代
composer install，只验证 vendor 是否完整 - 不要试图用
proc_open()调用php composer.phar install—— 大部分虚拟主机禁用进程创建函数 - 如果主机支持 .user.ini 或 php.ini 自定义，确认
disable_functions里包含exec,shell_exec,system,proc_open,passthru（基本都含）
用 composer.phar 手动部署仍报错 Class not found
常见现象是上传了 composer.phar 并尝试在根目录运行 php composer.phar install，结果提示 Class 'ComposerAutoloadClassLoader' not found 或直接 500 错误。
根本原因是：虚拟主机的 PHP 配置往往限制了内存（memory_limit=64M）、执行时间（max_execution_time=30）和临时目录权限（sys_get_temp_dir() 返回路径不可写）。
- 先检查
phpinfo()页面里的memory_limit，低于 128M 就别指望composer.phar跑得通 -
composer.phar默认解压到系统临时目录，如果该目录被禁写，会卡在“无法提取 phar 内容”阶段 - 可用
php -d memory_limit=256M -d max_execution_time=300 composer.phar install强制调参，但多数虚拟主机不允许覆盖这些 ini 设置 - 真正有效的做法：本地执行
composer install后，压缩整个项目（含vendor/），再整体上传
为什么 vendor/autoload.php 有时不生效
即使 vendor/ 上传完整，页面仍报 Class not found，大概率是自动加载机制没触发，而非 composer 本身问题。
- 确认入口文件（如
index.php）第一行是require __DIR__ . '/vendor/autoload.php';，路径不能错（别漏掉__DIR__或写成./vendor/autoload.php） - 检查虚拟主机是否启用了 OPcache，且缓存了旧的 autoloader；可临时加
opcache_reset();测试（上线前删掉） - 某些主机对
.htaccess重写规则敏感，若入口被 rewrite 到非标准路径，__DIR__可能指向错误位置，改用dirname(__FILE__)更稳 - Windows 下开发、Linux 虚拟主机部署时注意大小写：
vendor/autoload.php是小写，但若代码里写了Vendor/Autoload.php，就会 404
最麻烦的其实是 autoload 的 PSR-4 映射没生效——比如 "App\": "src/" 写了，但 src/ 没上传，或者命名空间首字母大写和实际文件夹名不一致。这种问题不会报 composer 错误，只会运行时报 class not found。
