无SSH权限共享主机部署QuantumPHP项目遇问题求指导

1. 修复vendor/autoload.php加载失败 #

问题根源 #

错误提示的绝对路径/vendor/autoload.php在共享主机环境下无效，因为主机目录结构与本地不同，该绝对路径指向的是服务器根目录而非项目根目录。

解决步骤 #

• 调整index.php路径引用：找到项目public/index.php第3行的加载代码，将绝对路径改为基于当前文件的相对路径（假设vendor目录在public的上级目录）：

  // 原代码
  require '/vendor/autoload.php';
  // 修改后
  require __DIR__ . '/../vendor/autoload.php';
  

• 确保vendor目录完整上传：
  1. 本地执行composer install --no-dev，生成生产环境专用的vendor目录（剔除开发依赖）
  2. 打包项目时务必包含整个vendor目录，包括其中的隐藏文件（如composer.json、composer.lock）
  3. 上传后检查主机上的vendor/autoload.php是否存在，目录结构与本地一致

2. 修正.htaccess配置 #

当前的.htaccess存在硬编码协议和绝对路径问题，修改为适配共享主机的版本：

<IfModule mod_rewrite.c>
    RewriteEngine On

    # 移除尾部斜杠（自动适配HTTP/HTTPS）
    RewriteRule ^(.+)/$ %{REQUEST_SCHEME}://%{HTTP_HOST}/$1 [R=301,L]

    # 前端控制器路由
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

• 若项目部署在子目录（而非域名根目录），需在RewriteRule前添加目录前缀，比如项目在/oraks目录下：

  RewriteRule ^ oraks/index.php [L]
  

3. 处理平台兼容性问题 #

• 本地预适配主机环境：在本地执行以下命令，确保依赖包兼容主机的PHP7.4版本：

  composer config platform.php 7.4
  composer install --no-dev
  

• 检查PHP扩展：登录cPanel查看PHP扩展列表，确保QuantumPHP所需的mbstring、json、xml等扩展已启用，缺失则联系主机商开启。

4. 无SSH环境下更新依赖/autoload的替代方案 #

后续若需更新自动加载规则或依赖，无需在主机执行命令：

1. 本地执行composer dump-autoload --optimize或composer update --no-dev
2. 重新打包vendor目录，上传覆盖主机上的对应目录即可

内容的提问来源于stack exchange，提问作者Andrey S