虚拟主机能否运行Yii 2.0或3.0取决于PHP版本、必需扩展（mbstring/openssl/pdo/phar/fileinfo）、composer权限及写入路径；需逐项验证并针对性配置。
虚拟主机能否跑 Yii 2.0 或 Yii 3.0？
不能一概而论，关键看 PHP 版本、扩展和写入权限——不是“支持 PHP 7.4”就等于能装 Yii。Yii 2.1 要求 mbstring、openssl、json、pdo（哪怕只用文件缓存也要 fileinfo），而 Yii 3.0 还强依赖 composer 可执行权限和 phar 扩展（部分云虚拟主机默认禁用 phar）。先 SSH 登录或进主机控制台查：
php -m | grep -E "mbstring|openssl|pdo|phar|fileinfo"缺任意一个，后续必然卡在
composer install 或 yii serve 启动阶段。
Composer 安装失败：常见报错与绕过方案
云虚拟主机通常禁止 proc_open、限制内存、屏蔽 curl_exec，导致 composer create-project --prefer-dist yiisoft/yii2-app-basic basic 直接报错 Could not open input file: composer.phar 或 Allowed memory size exhausted。别硬扛在线安装：
- 本地用
composer create-project拉好完整项目（含vendor/），再压缩上传 - 删掉
vendor/bin/下所有可执行脚本（如yii），改用php yii调用（避免 chmod 权限问题） - 若提示
Class 'Composer\Autoload\ClassLoader' not found，说明vendor/autoload.php没被引入——检查web/index.php开头是否漏了require __DIR__ . '/../vendor/autoload.php';
Web 入口路径配置错误：403 / 404 / 白屏三连
虚拟主机默认只允许访问 public_html 或 www 目录，但 Yii 要求 Web 根目录必须是 web/（不是项目根目录）。直接把整个 Yii 文件夹丢进 public_html 必然出事：
-
403 Forbidden：因为web.config或.htaccess被忽略，或主机用 IIS 且没启用 URL Rewrite 模块 -
404 Not Found：重写规则失效，index.php没被设为默认首页，或web/index.php路径没对齐（比如你把项目放public_html/myapp/，那 Web 根目录就得是public_html/myapp/web/，还要配Alias或子域名） - 白屏无报错：检查
web/index.php里YII_DEBUG是否为false，以及error_reporting(0)是否关了错误显示——加一句ini_set('display_errors', '1');看真错误
数据库连接失败：PDO 驱动名和 host 写法陷阱
虚拟主机的 MySQL 不一定叫 localhost，常见的是 mysql.hostingprovider.com 或 127.0.0.1（注意：部分主机禁用 localhost 域套接字，必须用 127.0.0.1）。更隐蔽的问题是 PDO DSN：
立即学习“PHP免费学习笔记（深入）”；
- 错写成
mysql:host=localhost;dbname=myapp→ 实际应为mysql:host=127.0.0.1;dbname=myapp;charset=utf8mb4（charset必须显式声明，否则中文存取乱码） - 用户名带前缀（如
cpaneluser_dbuser），密码含特殊字符（@、/、:）→ 必须用urlencode()处理，例如password=abc@123得写成password=abc%40123 - 测试连通性别只信
phpinfo()，要真跑一句new PDO($dsn, $user, $pass)捕获异常，否则yii\db\Connection::open()报SQLSTATE[HY000] [2002] Connection refused时你还在查配置文件拼写
最麻烦的其实是缓存路径——runtimes/ 和 web/assets/ 必须可写，但虚拟主机常把用户目录设为 755，得手动 chmod 775 runtimes web/assets；如果主机禁用 chmod，就只能改 config/web.php 里的 'runtimePath' => '@app/../private_runtime'，再把 private_runtime 放到非 Web 可访问路径下。
