Yii框架在虚拟主机上部署，具体步骤是什么？

将Yii框架部署到虚拟主机上，相较于拥有完整服务器权限的VPS或云服务器，确实需要一些技巧和变通方法，虚拟主机通常限制了用户对系统核心配置的访问权限，例如无法随意修改Apache或Nginx的配置文件，也无法通过命令行直接执行Composer等工具，但只要遵循正确的步骤,成功运行Yii应用是完全可行的。

前期准备与环境检查

在开始部署之前，首要任务是确认您的虚拟主机环境满足Yii2的基本运行要求，这通常可以通过虚拟主机控制面板（如cPanel）查看或咨询主机提供商。

PHP版本：确保PHP版本为7.3或更高（推荐使用PHP 7.4或8.0以获得更好的性能）。
必需的PHP扩展：检查并确认已安装并启用PDO（及其对应的数据库驱动，如pdo_mysql）、GD2或ImageMagick（用于图片处理）、CURL、Fileinfo、Mbstring等。
访问权限：确保您拥有FTP/SFTP账户权限，以及主机控制面板的访问权限,用于创建数据库和管理文件。

本地开发与打包

最佳实践是在本地完成所有的开发工作,然后将整个项目打包上传至虚拟主机。

本地创建项目：在您的本地开发环境中，使用Composer创建一个新的Yii2应用，创建一个基础应用模板：
```
composer create-project yiisoft/yii2-app-basic my-yii-app
```
本地配置与测试：在本地完成应用的基本配置，包括数据库连接（config/db.php）、URL美化规则等,并确保应用在本地能够正常运行。
上传项目文件：使用FTP/SFTP客户端（如FileZilla），将本地my-yii-app文件夹中的所有内容上传到虚拟主机的某个目录下，例如/home/your_username/yii_core，这个目录应当位于Web根目录（通常是public_html或www）之外,以保证源代码安全。

调整目录结构（关键步骤）

这是在虚拟主机上部署Yii的核心，标准的Yii应用结构要求Web服务器的根目录指向web文件夹，但在虚拟主机上，Web根目录是固定的（如public_html）,我们需要通过调整文件和目录结构来模拟这个效果。

目标：让public_html目录扮演web目录的角色，同时让应用的其他部分（如vendor, config等）保留在Web根目录之外。

请按照下表所示,移动您已上传的文件：

本地路径	虚拟主机目标路径	说明
`my-yii-app/web/` 下的所有文件	`/home/your_username/public_html/`	将`web`目录内的文件移动到Web根目录
`my-yii-app/` 的其他目录和文件	`/home/your_username/yii_core/`	将除`web`外的所有文件保留在安全目录中

完成移动后,您的虚拟主机目录结构应类似于：

/home/your_username/
├── yii_core/
│   ├── assets/
│   ├── commands/
│   ├── config/
│   ├── controllers/
│   ├── models/
│   ├── vendor/
│   ├── views/
│   └── ...
└── public_html/
    ├── assets/
    ├── index.php
    └── .htaccess

修改入口文件路径

由于我们将index.php（在public_html中）和其他核心文件（在yii_core中）分开了，必须修改index.php中的路径引用,使其能正确找到自动加载文件和配置文件。

打开public_html/index.php文件，修改其中的require语句：

<?php
// 定义项目根目录的绝对路径
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', dev);
// 注册 Composer 自动加载器
// 注意这里的路径需要指向您上传的 yii_core 目录下的 vendor 文件夹
require __DIR__ . '/../yii_core/vendor/autoload.php';
// 加载应用配置文件
// 同样，路径需要指向 yii_core 目录下的 config 文件夹
$config = require __DIR__ . '/../yii_core/config/web.php';
// 创建并运行应用
(new yiiwebApplication($config))->run();

使用__DIR__ . '/../yii_core/...'可以确保无论您的实际目录名是什么,路径都能被正确解析。

配置URL重写

为了启用Yii的URL美化功能，您需要正确配置.htaccess文件。

在 public_html 目录下创建或修改 .htaccess：

RewriteEngine on
# 如果请求的是一个真实存在的文件或目录，则直接访问
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 否则，将请求重定向到 index.php
RewriteRule . index.php