虚拟主机上不能运行composer install，因无命令行权限、proc_open被禁、public_html不可写、memory_limit过低且open_basedir限制严格，必须本地执行composer install后上传完整vendor目录，否则autoload.php路径错误或缺失将导致class not found。
不能直接解压上传，必须本地装好依赖再传，否则 Class 'think\App' not found 是必然结果。
为什么虚拟主机上不能运行 composer install
虚拟主机没有命令行权限，composer install、php think clear 这类命令根本执行不了。你上传的代码里如果缺 vendor/，框架连自动加载器都起不来——public/index.php 第一行 require __DIR__ . '/../vendor/autoload.php'; 就会失败，直接 500 或白屏。
- 所有依赖（包括
topthink/think、psr/log、monolog/monolog等）必须在本地用composer install装全，再把整个vendor/目录一起上传 - 别信“删掉 vendor 上传后在线安装”的说法，虚拟主机不支持
- 上传前检查：项目根目录下必须有
vendor/autoload.php，且vendor/topthink/think存在
public/ 目录不能当摆设，得让它真正成为 Web 根目录
虚拟主机的网站根目录（比如 wwwroot 或 htdocs）默认指向整个项目，但 ThinkPHP 要求 Web 请求只进 public/。你不能靠改 Nginx 配置来解决——大多数虚拟主机连配置文件都不可写。
- 最稳妥做法：把
public/里的全部内容（index.php、router.php、static/）剪切到网站根目录，再手动修正index.php中两处路径 - 第一处：
require __DIR__ . '/../vendor/autoload.php';→ 改成require __DIR__ . '/vendor/autoload.php'; - 第二处：
require __DIR__ . '/../thinkphp/base.php';→ 改成require __DIR__ . '/thinkphp/base.php'; - 同时把
app/、config/、runtime/、vendor/、thinkphp/这些目录全部放到跟index.php同级（也就是网站根目录下） -
runtime/必须可写，FTP 工具里右键设为 755 或 777（看主机是否允许）
伪静态规则不是可选项，是访问非 index.php URL 的前提
没伪静态，https://example.com/user/login 会 404，因为服务器找不到对应物理文件。虚拟主机大多用 Apache，靠 .htaccess 实现；少数用 Nginx，则需控制面板里填规则。
- Apache 场景：在网站根目录放一个
.htaccess文件，内容为：
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
- Nginx 场景：登录主机控制面板（如宝塔精简版、小皮、或厂商自研面板），找到“伪静态”设置项，粘贴以下规则：
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php?s=/$1 last;
}
- 部分主机禁用
mod_rewrite或屏蔽.htaccess，这时只能退回到带index.php的 URL 模式，在config/app.php里设'url_common' => true，并确保url_route_must为false
.env 和 runtime/ 权限是线上报错最高发区域
很多白屏、日志写不进、缓存生成失败，根源就在这两个地方。
-
.env文件必须上传，且不能被 Web 直接访问——检查能否通过浏览器打开https://yoursite.com/.env，如果能，说明没被屏蔽，要立刻在.htaccess里加：deny from all或重命名成env.php并在index.php开头 include 它 -
runtime/下的log/、cache/、temp/目录必须可写，FTP 工具里逐个点开看属性，Windows 主机尤其注意：IIS 默认以IUSR身份运行，需在文件夹“安全”页添加该用户并勾选“写入” - 如果
runtime/下没生成任何子目录，说明入口文件根本没跑通，先查 PHP 错误日志（主机控制面板一般有“错误日志”入口）
真正卡住人的从来不是框架本身，而是虚拟主机那几条看不见的线：Web 根目录锁死、无命令行、伪静态开关藏得深、runtime 写权限被系统策略拦截。每一步都得对着服务器实际反馈来调，而不是照着本地开发环境硬套。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
