Yii 框架入门教程
yiiYii PHP Framework 1.1.x项目地址:https://gitcode.com/gh_mirrors/yi/yii
本文将带你逐步了解Yii框架的基础知识,包括项目的目录结构、启动文件以及配置文件。
1. 项目的目录结构及介绍
Yii的目录结构设计简洁明了,便于理解和管理。以下是一般的项目目录结构:
yiiframework-app/
├── config/ # 配置文件夹
│ ├── bootstrap.php # 启动配置文件
│ └── main.php # 主要应用配置文件
├── console/ # 控制台应用程序目录
│ ├── commands/ # 自定义控制台命令
│ ├── config/ # 控制台应用配置
│ ├── runtime/ # 控制台运行时文件
│ └── yii # 控制台入口文件
├── frontend/ # 前端Web应用程序目录
│ ├── controllers/ # 前端控制器
│ ├── models/ # 前端模型
│ ├── views/ # 前端视图
│ ├── config/ # 前端配置
│ ├── runtime/ # 前端运行时文件
│ └── web/ # 前端公共文件,如CSS、JS、index.php
├── backend/ # 后台Web应用程序目录(如果有的话)
│ ├── ...
├── vendor/ # composer依赖库
├── common/ # 公共代码,可以被前端和后台共享
│ ├── components/ # 自定义组件
│ ├── controllers/
│ ├── models/
│ └── config/
├── runtime/ # 应用程序运行时文件
└── tests/ # 测试用例目录
config/
存放所有配置文件。console/
包含控制台应用程序相关代码。frontend/
和backend/
分别是前端和后台Web应用程序。vendor/
由Composer管理的所有第三方库。common/
存放跨前、后端的应用代码。runtime/
文件夹用于存放运行时生成的文件,如日志和缓存。tests/
目录包含单元测试和其他类型的测试用例。
2. 项目的启动文件介绍
Yii的启动过程由入口脚本触发,这个脚本通常在项目的根目录下或前端的web/
目录下,命名为index.php
。它加载Yii的核心组件,解析请求,并初始化应用程序。
以下是一个基本的index.php
示例:
<?php
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');
require __DIR__ . '/../vendor/autoload.php';
require __DIR__ . '/../bootstrap.php';
$config = require __DIR__ . '/../config/web.php';
(new yii\web\Application($config))->run();
YII_DEBUG
和YII_ENV
是预定义的常量,用于设置调试模式和环境变量。require
语句引入Composer自动加载文件和启动文件。new yii\web\Application($config)
创建一个新的Web应用程序实例,$config
是从config/web.php
加载的配置数组。- 最后的
->run()
方法启动并执行应用程序。
3. 项目的配置文件介绍
配置文件在Yii中扮演着重要角色,它们定义了应用程序的行为和依赖关系。
(1) bootstrap.php
bootstrap.php
通常位于config/
目录下,用于初始化一些全局的组件或者加载额外的配置。例如,你可以在这里注册全局事件监听器或者添加到Autoloader中的类路径。
Yii::setAlias('@common', dirname(__DIR__));
Yii::setAlias('@frontend', dirname(dirname(__DIR__)) . '/frontend');
Yii::setAlias('@backend', dirname(dirname(__DIR__)) . '/backend');
Yii::setAlias('@runtime', '@frontend/runtime');
Yii::setAlias('@vendor', '@frontend/vendor');
Yii::setAlias('@upload', '@frontend/web/upload');
// 加载其他配置或组件
(2) main.php
main.php
(在config/
目录下)是主要的应用配置文件,包含了关于数据库连接、路由规则、组件等的信息。例如:
return [
'id' => 'app',
'basePath' => dirname(__DIR__),
'bootstrap' => ['log'],
'components' => [
'request' => [
// ...
],
'cache' => [
// ...
],
'db' => [
// 数据库配置...
],
'errorHandler' => [
// 错误处理...
],
'mailer' => [
// 邮件发送配置...
],
'log' => [
// 日志记录...
],
'formatter' => [
// 格式化日期时间...
],
],
'params' => $params,
];
配置中的components
部分定义了应用程序组件,例如数据库、缓存、邮件等。params
则可以存储应用级别的常量。
以上就是对Yii框架的基本目录结构、启动文件及配置文件的简要介绍,希望对你理解Yii有所帮助。进一步学习可以参考Yii的官方文档,了解更多详细信息。
yiiYii PHP Framework 1.1.x项目地址:https://gitcode.com/gh_mirrors/yi/yii