首先确保环境满足PHP 7.4+、Composer及必要扩展,接着用composer create-project初始化项目,配置runtime和web/assets目录权限,修改db.php设置数据库连接,运行php yii migrate处理迁移,最后通过php yii serve启动服务并访问首页验证安装成功。

搭建Yii框架并不复杂,只要掌握正确流程和关键配置点,就能快速完成项目初始化。以下是从零开始部署Yii应用的详细步骤与常见注意事项,适合新手和中级开发者参考。
环境准备与系统要求
在安装Yii前,确保本地或服务器环境满足基本条件:
- PHP版本 >= 7.4(推荐PHP 8.0+以获得更好性能)
- 启用PDO、OpenSSL、MBString等常用扩展
- Web服务器如Apache或Nginx,或使用PHP内置开发服务器
- Composer已安装并可全局调用
可通过php -v和composer --version验证环境是否就绪。
使用Composer创建Yii项目
Yii官方推荐通过Composer创建项目。执行以下命令即可生成基础应用:
composer create-project yiisoft/yii2-app-basic myproject其中myproject为项目目录名,可自定义。此命令会自动下载Yii2框架及依赖,并生成目录结构。
若需高级模板(多模块、前后端分离),可用:
composer create-project yiisoft/yii2-app-advanced myproject配置权限与入口文件
项目创建后,需设置正确的文件权限,确保Web服务器可读写必要目录:
- basic模板:确保runtime和web/assets目录可写
- advanced模板:frontend/runtime、backend/runtime等子应用对应目录均需赋权
Linux/macOS下可执行:
chmod 777 runtime/ web/assets/Windows用户需检查文件属性,确保IIS或Apache有修改权限。
数据库配置与迁移
若项目涉及数据库操作,需修改config/db.php中的连接信息:
'components' => [
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=mydb',
'username' => 'root',
'password' => 'password',
'charset' => 'utf8',
],
],
配置完成后,可使用Yii迁移功能管理数据表:
php yii migrate/create create_user_table编辑生成的迁移文件后运行:
php yii migrate启动服务与访问测试
进入项目根目录,使用PHP内置服务器快速测试:
php yii serve该命令默认在http://localhost:8080启动服务。打开浏览器访问首页,看到“Congratulations!”页面即表示安装成功。
生产环境建议配合Nginx或Apache部署,配置document root指向web/目录。
基本上就这些。只要按步骤操作,注意权限和配置细节,Yii框架能很快跑起来。调试时留意日志文件(runtime/logs/app.log),多数问题都能从中找到线索。










