应用结构

入口文件

文件位置： web/index.php

<?php

//开启debug，应用会保留更多日志信息，如果抛出异常，会显示详细的错误调用堆栈
defined('YII_DEBUG') or define('YII_DEBUG', true);

//环境定义
defined('YII_ENV') or define('YII_ENV', 'dev'); //dev,prod

// 注册 Composer 自动加载器
require(__DIR__ . '/../vendor/autoload.php');

// 包含 Yii 类文件
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

// 加载应用配置
$config = require(__DIR__ . '/../config/web.php');

// 创建、配置、运行一个应用
(new yii\web\Application($config))->run();

需要注意的是，如果想通过命令行方式(cli)访问应用，入口文件是根目录下的yii。里面的内容实质是php代码，与config/web.php类似。Windows下请使用yii.bat。该文件在Linux下需要有执行权限，这样用户就能通过命令./yii <route> [arguments] [options] 来运行cli应用。

配置文件

config/web.php

下面列出全部配置属性，实际项目请选择性配置。

<?php

//加载全局配置文件
$params = require(__DIR__ . '/params.php');

//配置开始
$config = [
    /* 必要属性 */
    'id' => 'basic', //用来区分其他应用的唯一标识ID。主要给程序使用
    'basePath' => dirname(__DIR__), //指定该应用的根目录。根目录包含应用系统所有受保护的源代码。 在根目录下可以看到对应MVC设计模式的models, views, controllers等子目录
    
    /* 重要属性 */
    'aliases' => [
        '@name1' => 'path/to/path1',
        '@name2' => 'path/to/path2',
    ], //使用这个属性来定义别名，代替 Yii::setAlias() 方法来设置
    'bootstrap' => ['log'], //指定启动阶段yii\base\Application::bootstrap()需要运行的组件
    'catchAll' => [
        'offline/notice',
        'param1' => 'value1',
        'param2' => 'value2',
    ], //重定向所有请求到某个控制器方法，通常用于系统维护
    'components' => [
        'request' => [
            'cookieValidationKey' => 'test',
        ],
        'cache' => [
            'class' => 'yii\caching\FileCache',
        ],
        'user' => [
            'identityClass' => 'app\models\User',
            'enableAutoLogin' => true,
        ],
        'errorHandler' => [
            'errorAction' => 'site/error',
        ],
        'mailer' => [
            'class' => 'yii\swiftmailer\Mailer',
            'useFileTransport' => true,
        ],
        'log' => [
            'traceLevel' => YII_DEBUG ? 3 : 0,
            'targets' => [
                [
                    'class' => 'yii\log\FileTarget',
                    'levels' => ['error', 'warning'],
                ],
            ],
        ],
        'db' => require(__DIR__ . '/db.php'),
        /*
        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'rules' => [
            ],
        ],
        */
    ], //注册多个在其他地方使用的应用组件
    'controllerMap' => [
        [
            'account' => 'app\controllers\UserController',
            'article' => [
                'class' => 'app\controllers\PostController',
                'enableCsrfValidation' => false,
            ],
        ],
    ], //重映射控制器ID到任意控制器类
    'language'=> 'en', //语言
    'modules' => [
        // "booking" 模块以及对应的类
        'booking' => 'app\modules\booking\BookingModule',

        // "comment" 模块以及对应的配置数组
        'comment' => [
            'class' => 'app\modules\comment\CommentModule',
            'db' => 'db',
        ],
    ], //指定应用所包含的 模块
    'name' => '', //给终端用户展示的应用名称，可选
    'version' => '1.0', //版本，可选
    'sourceLanguage' => 'en', //应用代码的语言，可选
    'timeZone' => 'Asia/Shanghai', //默认时区，可选
    'params' => $params, //全局通用参数
    
    /* 实用属性 : 通常使用系统默认值 */
    'charset' => 'UTF-8', //默认值为 'UTF-8'
    'defaultRoute' => 'site', //对于网页应用，默认值为 'site' 对应 SiteController 控制器，并使用默认的动作
    'extensions' => [
        [
            'name' => 'extension name',
            'version' => 'version number',
            'bootstrap' => 'BootstrapClassName',  // 可选配，可为配置数组
            'alias' => [  // 可选配
                '@alias1' => 'to/path1',
                '@alias2' => 'to/path2',
            ],
        ],
    ], //指定应用安装和使用的 扩展,默认自动生成和维护更新
    'layout' => 'main', // 视图 默认使用的布局名字，默认值为 'main' 对应布局路径下的 main.php 文件
    'layoutPath' => 'layouts', // 布局文件的路径，默认值为 视图路径 下的 layouts 子目录
    'runtimePath' => '@app/runtime', //指定临时文件如日志文件、缓存文件等保存路径，默认值为带别名的 @app/runtime
    'viewPath' => '@app/views', //视图文件的根目录，默认值为带别名的 @app/views
    'vendorPath' => '@app/vendor', //第三方库。 默认值为带别名的 @app/vendor
    'enableCoreCommands' => true, //是否启用Yii中的核心命令，默认值为 true
    
    /* 应用事件：类似于钩子 */
    'on beforeRequest' => function ($event) {
    // ...
    },
];

if (YII_ENV_DEV) {
    // configuration adjustments for 'dev' environment
    $config['bootstrap'][] = 'debug';
    $config['modules']['debug'] = [
        'class' => 'yii\debug\Module',
    ];

    $config['bootstrap'][] = 'gii';
    $config['modules']['gii'] = [
        'class' => 'yii\gii\Module',
        'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // 允许访问的 IP 地址
    ];
}

return $config;

使用配置：

components：使用\Yii::$app->ComponentID 全局访问
params：\Yii::$app->params['key']

使用GII

gii是yii提供的代码自动生成器，可以通过简单的输入生成Controller、Model、View等文件代码，并提供代码预览功能。

开启gii需要将 YII_ENV_DEV 设为 true：

defined('YII_ENV') or define('YII_ENV', 'dev');

我们通过 URL 访问 Gii：http://hostname/index.php?r=gii

由于Gii 是 Yii 中的一个模块。可以通过配置应用的 yii\base\Application::modules 属性开启它。通常来讲在 config/web.php 文件中会有以下配置代码：

$config = [ ... ];

if (YII_ENV_DEV) {
    $config['bootstrap'][] = 'gii';
    $config['modules']['gii'] = [
        'class' => 'yii\gii\Module',
        'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // 允许访问的 IP 地址，可选
    ];
}

这段配置表明，如果当前是开发环境，应用会包含 gii 模块，模块类是 yii\gii\Module。

关于GII的用法请查看：http://www.yiichina.com/doc/guide/2.0/start-gii

数据库连接

切换数据库

默认使用的是config/db.php里的数据库配置。配置连接组件后Yii里可以使用以下语法访问：

$connection = \Yii::$app->db;

同理，我们可以修改config/web.php：

return [
    // ...
    'components' => [
        'db' => require(__DIR__ . '/db.php'),
        'db2' => [
            'class' => 'yii\db\Connection',
            'dsn' => 'mysql:host=localhost;dbname=testdb',
            'username' => 'demo',
            'password' => 'demo',
        ],
];

定义多个数据库连接配置。

Model里：
通过重写 yii\db\ActiveRecord::getDb() 方法切换数据库连接：

class Customer extends ActiveRecord
{
    // ...

    public static function getDb()
    {
        return \Yii::$app->db2;  // 使用名为 "db2" 的应用组件
    }
}

http://www.yiichina.com/doc/guide/2.0/db-active-record

使用SQL直接操作数据库

ActiveRecord 提供了数据库与模型(MVC 中的 M,Model) 的交互，QueryBuilder 用于创建动态的查询语句。

yii除了可以使用模型对象的方式(ORM)操作数据库外，还可以使用原生的SQL语句。通过yii\db\Command::createCommand可以执行SQL语句。

查询：

$connection = \Yii::$app->db;

//返回DataReader对象，需要使用yii\db\DataReader解析
$data = $connection->createCommand('SELECT * FROM post')->query();  
$rows = $data->readAll(); //返回数组
  
//查询返回多行：（数组）  
$command = $connection->createCommand('SELECT * FROM post');  
$posts = $command->queryAll();  

//返回单行：（数组）  
$command = $connection->createCommand('SELECT * FROM post WHERE id=1');  
$post = $command->queryOne();  

//返回某个字段的集合：未指定字段返回第一个字段（数组） 
$command = $connection->createCommand('SELECT title FROM post');  
$titles = $command->queryColumn();  

//查询标量值/计算值：  （标量）
$command = $connection->createCommand('SELECT COUNT(*) FROM post');  
$postCount = $command->queryScalar();  

可以使用insert,update,delete 方法，这些方法会根据参数生成合适的SQL并执行：

// INSERT
$connection->createCommand()->insert('user', [
    'name' => 'Sam',
    'age' => 30,
])->execute();

// INSERT 一次插入多行
$connection->createCommand()->batchInsert('user', ['name', 'age'], [
    ['Tom', 30],
    ['Jane', 20],
    ['Linda', 25],
])->execute();

// UPDATE
$connection->createCommand()->update('user', ['status' => 1], 'age > 30')->execute();

// DELETE
$connection->createCommand()->delete('user', 'status = 0')->execute();

预处理语句

为安全传递查询参数可以使用预处理语句,首先应当使用:placeholder占位，再将变量绑定到对应占位符：

$command = $connection->createCommand('SELECT * FROM post WHERE id=:id');
$command->bindValue(':id', $_GET['id']);
$post = $command->query();
另一种用法是准备一次预处理语句而执行多次查询：

$command = $connection->createCommand('DELETE FROM post WHERE id=:id');
$command->bindParam(':id', $id);

$id = 1;
$command->execute();

$id = 2;
$command->execute();

切换数据库类型

修改config/web.php：

return [
    // ...
    'components' => [
        'db' => [
            'class' => 'yii\db\Connection',
            'dsn' => 'mysql:host=localhost;dbname=mydatabase', // MySQL, MariaDB
            //'dsn' => 'sqlite:/path/to/database/file', // SQLite
            //'dsn' => 'pgsql:host=localhost;port=5432;dbname=mydatabase', // PostgreSQL
            //'dsn' => 'cubrid:dbname=demodb;host=localhost;port=33000', // CUBRID
            //'dsn' => 'sqlsrv:Server=localhost;Database=mydatabase', // MS SQL Server, sqlsrv driver
            //'dsn' => 'dblib:host=localhost;dbname=mydatabase', // MS SQL Server, dblib driver
            //'dsn' => 'mssql:host=localhost;dbname=mydatabase', // MS SQL Server, mssql driver
            //'dsn' => 'oci:dbname=//localhost:1521/mydatabase', // Oracle
            'username' => 'root', //数据库用户名
            'password' => '', //数据库密码
            'charset' => 'utf8',
        ],
    ],
    // ...
];

http://www.yiichina.com/doc/guide/2.0/db-dao

数据库复制和读写分离

很多数据库支持数据库复制 database replication来提高可用性和响应速度. 在数据库复制中，数据总是从主服务器 到 从服务器. 所有的插入和更新等写操作在主服务器执行，而读操作在从服务器执行.

通过配置yii\db\Connection可以实现数据库复制和读写分离.

[
    'class' => 'yii\db\Connection',

    // 配置主服务器
    'dsn' => 'dsn for master server',
    'username' => 'master',
    'password' => '',

    // 配置从服务器
    'slaveConfig' => [
        'username' => 'slave',
        'password' => '',
        'attributes' => [
            // use a smaller connection timeout
            PDO::ATTR_TIMEOUT => 10,
        ],
    ],

    // 配置从服务器组
    'slaves' => [
        ['dsn' => 'dsn for slave server 1'],
        ['dsn' => 'dsn for slave server 2'],
        ['dsn' => 'dsn for slave server 3'],
        ['dsn' => 'dsn for slave server 4'],
    ],
]

以上的配置实现了一主多从的结构，从服务器用以执行读查询，主服务器执行写入查询，读写分离的功能由后台代码自动完成。调用者无须关心。

http://www.yiichina.com/doc/guide/2.0/db-dao

类库扩展

新建helper

示例：新建一个Utils类。该文件可以在任何目录，例如 @app/components。

我们在根目录新建components文件夹，并新建components/Utils.php:

<?php

namespace yii\helpers;

class Utils{
    
    public static function test() {
        echo 'test';
    }
}

引入：
在应用程序入口文件(index.php)处，在引入的 yii.php 文件后面 添加以下代码行，用 Yii 自动加载器 来加载自定义类 代替框架的原始助手类：

Yii::$classMap['yii\helpers\Utils'] = '@app/components/Utils.php';

未完待续。。。