Laravel应用部署至虚拟主机后无法加载vendor/autoload.php问题

这种路径问题在虚拟主机部署时真的很常见，我来帮你一步步排查解决：

1. 别用相对路径，改用绝对路径引入autoload.php #

本地开发时的相对路径../vendor/autoload.php在虚拟主机上可能失效，因为虚拟主机的目录结构（比如项目可能放在public_html下）和本地不一样，导致相对路径指向的位置不对。

最稳妥的办法是用绝对路径：

• 如果是在Laravel框架的代码里（比如控制器、自定义命令等），直接用Laravel自带的辅助函数：

  require base_path('vendor/autoload.php');
  

  base_path()会自动指向Laravel项目的根目录，不管你部署在哪个服务器目录下，都能精准找到vendor文件夹。
• 如果是在项目根目录外的自定义脚本里，可以用__DIR__来拼接路径：

  require __DIR__ . '/../vendor/autoload.php';
  

  这里要确认__DIR__是当前脚本所在的目录，调整../的数量来匹配vendor的位置。

2. 确认Composer安装是否完全成功 #

上传代码后执行composer install时，很容易因为服务器环境问题导致安装失败：

• 先检查虚拟主机的文件管理器，看看项目根目录下有没有vendor文件夹，里面是否存在autoload.php文件。如果没有，说明Composer安装没完成。
• 登录虚拟主机的SSH终端，重新执行composer install --no-dev（生产环境建议去掉开发依赖，减少体积），仔细看输出有没有报错，比如PHP版本不兼容（Guzzle对PHP版本有要求，错误里显示服务器用的是PHP7.0，要确认你的Guzzle版本支持这个版本）、权限不足等问题。

3. 检查目录和文件权限 #

虚拟主机的权限限制很严格，可能导致PHP无法读取autoload.php：

• 把vendor文件夹的权限设置为755，里面的文件权限设置为644，确保服务器的PHP进程有读取这些文件的权限。
• 如果是用FTP上传代码，注意不要把本地的权限带过去，最好在服务器上直接执行Composer安装来生成vendor文件，避免权限问题。

4. 忽略include_path的影响 #

错误提示里提到了include_path='.:/opt/alt/php70...'，PHP会在这些路径里查找要引入的文件，但你的vendor文件夹不在这些路径里，所以依赖include_path的相对路径肯定不靠谱，用绝对路径就能彻底避开这个问题。

内容的提问来源于stack exchange，提问作者Saurabh Mistry