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账户权限，以及主机控制面板的访问权限,用于创建数据库和管理文件。

本地开发与打包

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

1. 本地创建项目：在您的本地开发环境中，使用Composer创建一个新的Yii2应用，创建一个基础应用模板：

   composer create-project yiisoft/yii2-app-basic my-yii-app

2. 本地配置与测试：在本地完成应用的基本配置，包括数据库连接（config/db.php）、URL美化规则等,并确保应用在本地能够正常运行。
3. 上传项目文件：使用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文件。

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

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

2. ：
   这个文件的目的是阻止任何用户通过浏览器直接访问yii_core目录下的敏感文件。

   

   Deny from all

至此，您的Yii应用已经成功部署到虚拟主机上，现在可以通过浏览器访问您的域名,查看应用是否正常运行。

---

相关问答FAQs

问：我可以在虚拟主机上直接运行Composer命令来安装依赖吗？
答：通常情况下不可以，绝大多数虚拟主机服务不提供SSH命令行访问权限，或者即使提供，也限制了执行此类系统级程序的权限，正确的做法是在您的本地开发环境中运行composer install或composer update，然后将生成的vendor目录完整上传到虚拟主机的yii_core目录中。

问：部署后网站显示500 Internal Server Error，我该如何排查？
答：500错误通常由多种原因引起,请按以下步骤排查：

1. 检查PHP错误日志：登录您的虚拟主机控制面板（如cPanel），找到“Errors”或“日志”栏目，查看最新的PHP错误日志,它通常会给出具体的错误信息。
2. 验证文件权限：确保yii_core/runtime和public_html/assets目录对于Web服务器是可写的，通常权限设置为755（目录）和644（文件）。
3. 检查路径配置：再次确认public_html/index.php文件中的require路径是否正确指向了yii_core目录下的vendor/autoload.php和config/web.php。
4. 数据库连接：检查yii_core/config/db.php中的数据库主机名、用户名、密码和数据库名是否与您在控制面板中创建的数据库信息完全一致。