虚拟主机上无法直接运行 composer install，必须本地构建 vendor 目录并上传；需严格使用 --no-dev --optimize-autoloader --prefer-dist --no-plugins 参数，且注意路径、权限与缓存清理。
在虚拟主机（尤其是仅提供 FTP 访问、无 SSH 的“纯面板型”共享主机）上直接运行 composer install 必然失败——不是配置没调好，而是 proc_open() 被禁用、public_html 目录不可写、Git 未安装、内存限制过低这些硬性限制根本无法绕过。
为什么 FTP 环境下不能在服务器上跑 composer install
你上传了 composer.json 和 composer.lock，然后用 FTP 连上去，试图通过 PHP 文件（比如 run-composer.php）触发安装？大概率会卡在以下任意一步：
-
proc_open() has been disabled：主机明确禁用进程创建函数，Composer 初始化、解压 zip、执行 Git 均依赖它 -
file_put_contents(./vendor/autoload.php): Permission denied：public_html或子目录默认禁止 PHP 写入，连vendor/目录都建不了 -
Cloning into '...'...卡住不动：主机没装 Git，而 Composer 默认优先走 Git 克隆，不会自动 fallback 到 dist 包 - 500 错误且无日志：PHP
memory_limit=64M或max_execution_time=30直接中断 PHAR 执行，连错误提示都不给
必须本地构建 vendor/，且参数不能错
真正可行的路径只有一条：在你本地开发机（Windows/macOS/Linux）用和虚拟主机**完全一致的 PHP 版本**执行构建，再把整个 vendor/ 上传。但以下参数缺一不可，否则上传后必报 Class not found：
-
--no-dev：跳过require-dev中的包（如 PHPUnit、phpstan），它们不仅无用，还可能因扩展缺失或 PHP 小版本差异直接 fatal error -
--optimize-autoloader（或-o）：生成静态classmap，避免运行时遍历文件；不依赖opcache.file_cache（共享主机通常关闭） -
--prefer-dist：强制下载 zip 包而非走 Git，避开主机无 Git 的问题 -
--no-plugins：禁用插件，防止某些钩子脚本（如hirak/prestissimo）因权限失败中断流程
完整命令示例：php composer.phar install --no-dev --optimize-autoloader --prefer-dist --no-plugins
上传后 autoload.php 路径失效的两个真实原因
你确认 vendor/ 完整上传、autoload.php 存在、权限设为 644，但浏览器仍报 Class not found？大概率是以下其一：
- 入口文件里写的是
require __DIR__.'/vendor/autoload.php';—— 如果你的项目不在 Web 根目录下（比如放在public_html/myapp/，而域名绑定了public_html/），这个相对路径会指向错位置；应改为require dirname(__DIR__).'/vendor/autoload.php';或用$_SERVER['DOCUMENT_ROOT']拼绝对路径 -
vendor/autoload.php末尾包含硬编码绝对路径，例如require '/home/user/xxx/vendor/composer/autoload_real.php';—— 这说明本地构建前没清缓存；必须删掉整个vendor/和composer.lock，再重跑上面那条带--no-dev -o的命令
FTP 上传后还要检查文件权限和结构完整性
FTP 客户端（尤其是 Windows 上的 FileZilla）默认上传文件权限是 600，PHP 无法读取；必须批量修改：
- 所有
.php文件（包括vendor/autoload.php）设为644 - 所有目录（
vendor/、vendor/composer/、vendor/monolog/monolog/等）设为755 - 别漏掉
vendor/composer/installed.json和vendor/composer/autoload_classmap.php—— 它们是--optimize-autoloader生成的关键文件，FTP 有时会因文件名长或含点号跳过上传
上传完成后，建议在虚拟主机上放一个 test-autoloader.php 验证：require 'vendor/autoload.php'; echo "OK";。能输出 OK，才说明路径、权限、类映射三者全部就位。
