如何在共享主机上配置使用Composer进行虚拟主机部署？

本文共计1032个文字，预计阅读时间需要5分钟。

在共享主机上无法直接运行composer install命令——这并非配置不对，而是大多数主机禁用了一些功能，如exec、proc_open等函数。此外，public_目录不可写，导致vendor目录生成失败。唯一可靠的方法：

为什么在共享主机上运行 composer install 几乎必败

报错形式五花八门，但根因一致：主机限制了执行能力与文件系统权限。

• proc_open() has been disabled 或 command not found：PHP 配置中 disable_functions 明确禁用了进程创建函数
• file_put_contents(./vendor/autoload.php): Permission denied：Web 根目录（如 ~/public_html/）被设为只读，无法创建 vendor/
• Cloning into '' 卡住或失败：主机没装 Git，而 Composer 默认优先走 Git 克隆而非 dist 包下载
• 500 错误且无日志：memory_limit=64M 或 max_execution_time=30 导致 PHAR 执行中途被杀

本地构建 vendor 的实操要点

这不是“复制粘贴”就能成的事，关键参数和环境必须对齐。

• 本地 PHP 版本必须与共享主机一致（至少主版本相同），比如主机是 PHP 8.1，就别用 8.3 跑 composer install
• 必须加 --no-dev --optimize-autoloader（简写 -o）：跳过 dev 依赖，生成 classmap 映射，不依赖 opcache.file_cache
• 推荐加 --no-plugins --prefer-dist：禁用插件（如 fxp-asset-plugin），强制走 zip 包，避开 Git 依赖
• 删掉 composer.json 中所有 "scripts"、私有 "repositories" 和 "config" 下的全局路径设置（如 bin-dir）
• 运行前清空本地缓存：composer clear-cache，再删掉项目下 vendor/ 和 composer.lock，重新 composer install -o --no-dev

上传后 Class not found 的真实原因和验证方法

不是 vendor 没传全，而是 autoloader 路径写死了或加载逻辑失效。

• 检查 vendor/autoload.php 开头几行：如果看到 require '/home/xxx/vendor/composer/autoload_real.php' 这种绝对路径，说明缓存没清干净，重跑 composer dump-autoload -o
• 确认入口文件（如 index.php）里 autoload 的写法：require_once __DIR__ . '/../vendor/autoload.php'; 比 require 'vendor/autoload.php'; 更稳
• 上传后立即建一个 test-autoloader.php 放 Web 目录下：

  <?php if (file_exists(__DIR__ . '/../vendor/autoload.php')) { require __DIR__ . '/../vendor/autoload.php'; echo "Autoloader loaded"; } else { die("autoload.php not found"); } 浏览器访问它，能输出即说明路径和权限基本 OK

• 检查 vendor/ 目录权限：目录需 755，文件需 644；某些主机对 755 仍拒绝遍历，可试 775

没有 SSH 时，别碰 composer.phar 自动安装

有人试图上传 composer.phar 后用 php composer.phar install 补救，结果更糟。

• 即使上传成功，php composer.phar install 仍会触发 proc_open、临时目录写入、Git 调用等被禁行为
• sys_get_temp_dir() 返回路径往往不可写（如 /tmp 被隔离），导致 PHAR 解包失败
• 部分主机连 php -v 都返回空，说明 CLI 完全不可用，此时连 php composer.phar 都执行不了
• 所谓“PHP 执行脚本”控制面板功能（如 cPanel 的 Cron 或 PHP 脚本入口），本质是 CGI 模式，不支持命令行上下文，exec 类函数一律静默失败

最易被忽略的一点：composer.lock 必须和 vendor/ 一起上传，且内容要和线上 PHP 版本约束匹配；否则即便 autoload 加载成功，某一行 new 语法也可能因版本不兼容直接报 syntax error，连错误提示都不显示。