【亲测免费】 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的官方文档，了解更多详细信息。