Yii 2 框架安装与使用教程
1. 项目目录结构及介绍
Yii 2 的目录结构是基于约定的,它有助于组织应用程序的各个部分。以下是核心目录和它们的作用:
config/
包含应用的配置文件,如 web.php
(Web 应用配置)、console.php
(控制台应用配置)等。
controllers/
放置控制器类文件,这些类处理用户的请求并协调模型和视图。
models/
存储业务逻辑相关的数据模型类,通常与数据库交互。
views/
存放视图文件,用于呈现数据和用户界面。
vendor/
包含 Composer 依赖管理工具自动下载的所有包,包括 Yii 框架本身和其他第三方库。
runtime/
运行时目录,生成临时文件,如日志、session 文件等。
web/
公共访问目录,通常含有入口脚本 index.php
和静态资源(CSS、JS、图片)。
tests/
测试相关文件,包括 PHPUnit 测试用例。
composer.json
和 composer.lock
描述项目依赖和锁定具体版本的文件,分别用于初始化和更新依赖项。
2. 项目的启动文件介绍
Yii 2 的启动文件通常是 web/index.php
。这个文件负责初始化应用程序并处理请求。其主要步骤包括:
- 加载 Composer 自动加载器以解析类文件。
- 创建一个应用实例,配置基本参数,如应用类型(frontend 或 backend),以及基础路径。
- 处理请求,这可能涉及路由、控制器和动作的选择。
- 渲染响应,将结果发送回浏览器。
示例 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__ . '/../vendor/yiisoft/yii2/Yii.php');
$config = require(__DIR__ . '/../config/web.php');
(new yii\web\Application($config))->run();
?>
3. 项目的配置文件介绍
配置文件在 config/
目录下,通常包括 Web 和 Console 应用的配置。这些文件定义了应用的组件、属性及其行为。
web.php
该文件用于配置 Web 应用。它可以设置组件如数据库连接(db)、URL 管理器(urlManager)、session 组件等。例如,数据库配置可能是这样:
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=mydatabase',
'username' => 'myuser',
'password' => 'mypassword',
'charset' => 'utf8mb4',
],
console.php
对于控制台应用,配置文件通常用于配置命令行操作的相关组件。例如,定时任务或数据库迁移操作。
配置文件可以包含其他子配置,如认证和授权策略,日志组件,以及自定义的类路径映射。
通过修改这些配置,你可以调整 Yii 2 的行为以满足你的特定需求和项目要求。