Yii2数据库操作全攻略：ActiveRecord与QueryBuilder-优快云博客

Yii2数据库操作全攻略：ActiveRecord与QueryBuilder

【免费下载链接】yii2 Yii 2: The Fast, Secure and Professional PHP Framework 项目地址: https://gitcode.com/gh_mirrors/yi/yii2

本文全面解析Yii2框架中的数据库操作核心技术，重点深入ActiveRecord模式和QueryBuilder查询构建器的原理与实践。文章详细探讨ActiveRecord的架构设计、核心机制、事件生命周期和最佳实践指南，包括模型设计规范、查询优化策略、事务管理和性能优化技巧。同时深入讲解QueryBuilder构建复杂查询语句的能力，涵盖基础查询、多表关联、聚合函数、子查询等高级用法，并提供数据库迁移与版本控制的完整解决方案，以及多数据库支持与性能优化的专业技巧。

ActiveRecord模式原理与最佳实践

ActiveRecord模式是Yii2框架中数据库操作的核心组件，它将数据库表映射为对象，实现了面向对象的数据库操作方式。本节将深入探讨ActiveRecord的设计原理、核心机制以及在实际开发中的最佳实践。

ActiveRecord核心架构与设计原理

ActiveRecord模式基于Martin Fowler提出的企业应用架构模式，其核心思想是将数据表映射为对象，表中的每一行对应一个对象实例，表中的列对应对象的属性。

类继承结构

Yii2的ActiveRecord采用分层设计，核心类继承关系如下：

mermaid

核心组件交互流程

ActiveRecord的数据库操作涉及多个组件的协同工作：

mermaid

ActiveRecord核心机制解析

1. 属性映射机制

ActiveRecord通过反射和数据库元数据自动映射表字段到对象属性：

class User extends \yii\db\ActiveRecord
{
    public static function tableName()
    {
        return '{{%user}}';
    }
}

// 自动映射过程
$user = new User();
$user->username = 'john_doe'; // 映射到user表的username字段
$user->email = 'john@example.com'; // 映射到user表的email字段

2. 查询构建机制

ActiveQuery提供了流畅的接口构建复杂查询：

// 基础查询
$users = User::find()
    ->where(['status' => User::STATUS_ACTIVE])
    ->orderBy('created_at DESC')
    ->limit(10)
    ->all();

// 关联查询
$usersWithPosts = User::find()
    ->joinWith('posts')
    ->where(['post.status' => Post::STATUS_PUBLISHED])
    ->all();

3. 事件生命周期

ActiveRecord提供了完整的事件生命周期管理：

事件类型	触发时机	常用场景
EVENT_BEFORE_VALIDATE	验证前	数据预处理
EVENT_AFTER_VALIDATE	验证后	验证后处理
EVENT_BEFORE_INSERT	插入前	数据加密、审计字段
EVENT_AFTER_INSERT	插入后	缓存更新、通知发送
EVENT_BEFORE_UPDATE	更新前	乐观锁检查
EVENT_AFTER_UPDATE	更新后	历史记录、缓存失效
EVENT_BEFORE_DELETE	删除前	关联数据检查
EVENT_AFTER_DELETE	删除后	清理关联数据

最佳实践指南

1. 模型设计规范

表名和字段映射

class Product extends \yii\db\ActiveRecord
{
    // 明确指定表名
    public static function tableName()
    {
        return '{{%products}}';
    }
    
    // 字段常量定义
    const STATUS_DRAFT = 0;
    const STATUS_PUBLISHED = 1;
    const STATUS_ARCHIVED = 2;
    
    // 获取状态标签
    public function getStatusLabel()
    {
        $statuses = [
            self::STATUS_DRAFT => '草稿',
            self::STATUS_PUBLISHED => '已发布',
            self::STATUS_ARCHIVED => '已归档'
        ];
        return $statuses[$this->status] ?? '未知';
    }
}

2. 查询优化策略

避免N+1查询问题

// 错误做法：产生N+1查询
$users = User::find()->all();
foreach ($users as $user) {
    $posts = $user->posts; // 每次循环都执行一次查询
}

// 正确做法：使用预加载
$users = User::find()->with('posts')->all();
foreach ($users as $user) {
    $posts = $user->posts; // 数据已预加载，无额外查询
}

批量查询处理

// 使用batch处理大量数据
foreach (User::find()->batch(100) as $users) {
    foreach ($users as $user) {
        // 处理每批100条记录
    }
}

// 使用each逐条处理
foreach (User::find()->each(100) as $user) {
    // 逐条处理，内存友好
}

3. 事务管理最佳实践

模型级别事务控制

class Order extends \yii\db\ActiveRecord
{
    public function transactions()
    {
        return [
            'default' => self::OP_ALL, // 所有操作都使用事务
            'api' => self::OP_INSERT | self::OP_UPDATE,
        ];
    }
    
    public function createOrder($data)
    {
        $transaction = static::getDb()->beginTransaction();
        try {
            $this->attributes = $data;
            if (!$this->save()) {
                throw new \Exception('保存订单失败');
            }
            
            // 创建订单明细
            foreach ($data['items'] as $item) {
                $orderItem = new OrderItem($item);
                $orderItem->order_id = $this->id;
                if (!$orderItem->save()) {
                    throw new \Exception('保存订单明细失败');
                }
            }
            
            $transaction->commit();
            return true;
        } catch (\Exception $e) {
            $transaction->rollBack();
            Yii::error($e->getMessage());
            return false;
        }
    }
}

4. 验证和安全实践

数据验证规则

class User extends \yii\db\ActiveRecord
{
    public function rules()
    {
        return [
            [['username', 'email'], 'required'],
            ['username', 'string', 'min' => 3, 'max' => 20],
            ['email', 'email'],
            ['email', 'unique'],
            ['status', 'default', 'value' => self::STATUS_ACTIVE],
            ['status', 'in', 'range' => [self::STATUS_ACTIVE, self::STATUS_INACTIVE]],
        ];
    }
    
    public function scenarios()
    {
        return [
            'create' => ['username', 'email', 'password', 'status'],
            'update' => ['username', 'email', 'status'],
            'register' => ['username', 'email', 'password'],
        ];
    }
}

安全属性赋值

// 使用load安全赋值
if ($user->load(Yii::$app->request->post()) && $user->save()) {
    // 处理成功
}

// 明确指定可安全赋值的字段
class User extends \yii\db\ActiveRecord
{
    public function safeAttributes()
    {
        return ['username', 'email', 'status'];
    }
}

5. 性能优化技巧

选择性字段查询

// 只查询需要的字段
$users = User::find()
    ->select(['id', 'username', 'email'])
    ->where(['status' => User::STATUS_ACTIVE])
    ->all();

// 使用索引优化查询
$users = User::find()
    ->indexBy('id') // 使用id作为数组索引
    ->all();

缓存策略

class Product extends \yii\db\ActiveRecord
{
    public static function find()
    {
        return parent::find()->cache(3600); // 缓存1小时
    }
    
    public function afterSave($insert, $changedAttributes)
    {
        parent::afterSave($insert, $changedAttributes);
        // 清除相关缓存
        Yii::$app->cache->delete('product_list');
    }
}

高级特性应用

1. 行为(Behaviors)集成

class User extends \yii\db\ActiveRecord
{
    public function behaviors()
    {
        return [
            'timestamp' => [
                'class' => TimestampBehavior::class,
                'attributes' => [
                    ActiveRecord::EVENT_BEFORE_INSERT => ['created_at', 'updated_at'],
                    ActiveRecord::EVENT_BEFORE_UPDATE => ['updated_at'],
                ],
            ],
            'blameable' => [
                'class' => BlameableBehavior::class,
                'createdByAttribute' => 'created_by',
                'updatedByAttribute' => 'updated_by',
            ],
            'softDelete' => [
                'class' => SoftDeleteBehavior::class,
                'attribute' => 'deleted_at',
            ],
        ];
    }
}

2. 乐观锁实现

class Document extends \yii\db\ActiveRecord
{
    public function optimisticLock()
    {
        return 'version'; // 返回版本字段名
    }
    
    public function updateDocument($data)
    {
        $document = Document::findOne($id);
        $document->load($data);
        
        try {
            if ($document->save()) {
                return true;
            }
        } catch (StaleObjectException $e) {
            // 处理版本冲突
            Yii::$app->session->setFlash('error', '数据已被其他用户修改，请刷新后重试');
            return false;
        }
    }
}

常见问题与解决方案

1. 内存溢出处理

// 处理大量数据时使用批处理
$query = User::find()->where(['status' => User::STATUS_ACTIVE]);

foreach ($query->batch(1000) as $users) {
    foreach ($users as $user) {
        // 处理数据
    }
    // 定期释放内存
    unset($users);
    gc_collect_cycles();
}

2. 复杂查询优化

// 使用子查询优化复杂查询
$subQuery = Order::find()
    ->select('user_id, COUNT(*) as order_count')
    ->groupBy('user_id')
    ->having('order_count > 10');

$users = User::find()
    ->innerJoin(['o' => $subQuery], 'o.user_id = user.id')
    ->all();

3. 数据库兼容性

class BaseActiveRecord extends \yii\db\ActiveRecord
{
    public static function getDb()
    {
        // 根据环境返回不同的数据库连接
        if (YII_ENV_TEST) {
            return Yii::$app->dbTest;
        }
        return Yii::$app->db;
    }
}

通过遵循这些最佳实践，您可以构建出高性能、可维护且安全的ActiveRecord应用。记住，ActiveRecord虽然方便，但在复杂场景下需要合理使用，避免过度抽象导致的性能问题。

QueryBuilder构建复杂查询语句

Yii2的QueryBuilder是数据库操作的核心组件之一，它提供了强大而灵活的方式来构建复杂的SQL查询语句。与ActiveRecord相比，QueryBuilder提供了更底层的控制能力，特别适合处理复杂的业务逻辑和多表关联查询。

基础查询构建

QueryBuilder通过链式调用的方式构建查询，每个方法对应SQL语句的一个子句。让我们从最基本的查询开始：

use yii\db\Query;

// 简单SELECT查询
$query = (new Query())
    ->select(['id', 'name', 'email'])
    ->from('user')
    ->where(['status' => 1])
    ->orderBy('created_at DESC')
    ->limit(10);

// 生成的SQL: SELECT `id`, `name`, `email` FROM `user` WHERE `status`=1 ORDER BY `created_at` DESC LIMIT 10

复杂条件查询

QueryBuilder支持多种条件表达式，可以构建复杂的WHERE子句：

// 多条件组合
$query = (new Query())
    ->from('order')
    ->where([
        'and',
        ['status' => 'completed'],
        ['>=', 'total_amount', 1000],
        ['or',
            ['payment_method' => 'credit_card'],
            ['payment_method' => 'paypal']
        ],
        ['not', ['customer_id' => null]]
    ]);

// 使用BETWEEN条件
$query->andWhere(['between', 'created_at', '2023-01-01', '2023-12-31']);

// 使用IN子查询
$subQuery = (new Query())
    ->select('id')
    ->from('premium_customers');
$query->andWhere(['in', 'customer_id', $subQuery]);

多表关联查询

QueryBuilder的强大之处在于处理复杂的多表关联：

// 多表JOIN查询
$query = (new Query())
    ->select([
        'o.order_id', 
        'o.total_amount',
        'c.name as customer_name',
        'p.name as product_name'
    ])
    ->from(['o' => 'order'])
    ->innerJoin(['c' => 'customer'], 'c.id = o.customer_id')
    ->leftJoin(['oi' => 'order_item'], 'oi.order_id = o.id')
    ->leftJoin(['p' => 'product'], 'p.id = oi.product_id')
    ->where(['o.status' => 'completed'])
    ->groupBy('o.order_id')
    ->having(['>', 'COUNT(oi.id)', 1]);

聚合函数与分组查询

QueryBuilder支持各种聚合函数和复杂的分组操作：

// 复杂的聚合查询
$query = (new Query())
    ->select([
        'YEAR(created_at) as year',
        'MONTH(created_at) as month',
        'COUNT(*) as total_orders',
        'SUM(total_amount) as total_revenue',
        'AVG(total_amount) as avg_order_value'
    ])
    ->from('order')
    ->where(['status' => 'completed'])
    ->groupBy(['YEAR(created_at)', 'MONTH(created_at)'])
    ->having(['>', 'total_revenue', 10000])
    ->orderBy('year DESC, month DESC');

子查询的使用

QueryBuilder可以轻松处理各种子查询场景：

// 标量子查询
$maxOrderQuery = (new Query())
    ->select('MAX(total_amount)')
    ->from('order')
    ->where(['customer_id' => new Expression('c.id')]);

$query = (new Query())
    ->select(['c.name', 'max_order' => $maxOrderQuery])
    ->from(['c' => 'customer'])
    ->where(['exists', $maxOrderQuery]);

// EXISTS子查询
$highValueOrders = (new Query())
    ->select('id')
    ->from('order')
    ->where(['>', 'total_amount', 5000]);

$query = (new Query())
    ->from('customer')
    ->where(['exists', $highValueOrders]);

联合查询与复杂表达式

QueryBuilder支持UNION查询和复杂的SQL表达式：

// UNION查询
$query1 = (new Query())
    ->select(['id', 'name', 'type' => new Expression("'customer'")])
    ->from('customer');

$query2 = (new Query())
    ->select(['id', 'name', 'type' => new Expression("'supplier'")])
    ->from('supplier');

$unionQuery = $query1->union($query2);

// 使用CASE表达式
$query = (new Query())
    ->select([
        'id',
        'status',
        'status_label' => new Expression("CASE 
            WHEN status = 1 THEN 'Active'
            WHEN status = 2 THEN 'Inactive' 
            ELSE 'Unknown'
        END")
    ])
    ->from('user');

参数绑定与安全查询

QueryBuilder自动处理参数绑定，防止SQL注入：

// 安全的参数绑定
$minAmount = 100;
$maxAmount = 1000;
$categories = [1, 2, 3];

$query = (new Query())
    ->from('product')
    ->where(['between', 'price', $minAmount, $maxAmount])
    ->andWhere(['in', 'category_id', $categories])
    ->andWhere(['like', 'name', ':search', [':search' => '%apple%']]);

// 生成的SQL使用参数绑定，确保安全

性能优化技巧

对于复杂查询，QueryBuilder提供了多种性能优化选项：

// 使用索引提示
$query = (new Query())
    ->from('order USE INDEX (idx_customer_status)')
    ->where(['customer_id' => 123, 'status' => 'completed']);

// 分页优化
$query = (new Query())
    ->from('large_table')
    ->where(['status' => 1])
    ->orderBy('id')
    ->limit(20)
    ->offset(1000);

// 使用EXPLAIN分析查询
$explainQuery = (new Query())
    ->select(new Expression('EXPLAIN ' . $query->createCommand()->sql));

实际应用场景

让我们看几个实际业务中的复杂查询示例：

场景1：电商平台销售报表

$salesReport = (new Query())
    ->select([
        'c.name as category_name',
        'YEAR(o.created_at) as year',
        'MONTH(o.created_at) as month',
        'COUNT(DISTINCT o.id) as order_count',
        'SUM(oi.quantity * oi.unit_price) as total_sales',
        'COUNT(DISTINCT o.customer_id) as unique_customers'
    ])
    ->from(['o' => 'order'])
    ->innerJoin(['oi' => 'order_item'], 'oi.order_id = o.id')
    ->innerJoin(['p' => 'product'], 'p.id = oi.product_id')
    ->innerJoin(['c' => 'category'], 'c.id = p.category_id')
    ->where(['o.status' => 'completed'])
    ->andWhere(['between', 'o.created_at', '2023-01-01', '2023-12-31'])
    ->groupBy(['c.id', 'YEAR(o.created_at)', 'MONTH(o.created_at)'])
    ->orderBy('total_sales DESC');

场景2：用户行为分析

$userBehavior = (new Query())
    ->select([
        'u.id',
        'u.username',
        'COUNT(DISTINCT o.id) as total_orders',
        'SUM(o.total_amount) as total_spent',
        'MAX(o.created_at) as last_order_date',
        'AVG(DATEDIFF(o.created_at, LAG(o.created_at) OVER (PARTITION BY u.id ORDER BY o.created_at))) as avg_order_interval'
    ])
    ->from(['u' => 'user'])
    ->leftJoin(['o' => 'order'], 'o.user_id = u.id AND o.status = "completed"')
    ->where(['u.created_at' => '>', '2023-01-01'])
    ->groupBy('u.id')
    ->having(['>', 'total_orders', 1]);

调试与优化

QueryBuilder提供了方便的调试方法：

$query = (new Query())->from('user')->where(['status' => 1]);

// 获取生成的SQL
$sql = $query->createCommand()->sql;

// 获取绑定参数
$params = $query->createCommand()->params;

// 直接执行查询
$results = $query->all();

// 使用缓存
$query->cache(3600); // 缓存1小时

通过QueryBuilder，开发者可以构建几乎任何复杂度的SQL查询，同时保持代码的可读性和安全性。其链式调用语法使得复杂查询的构建变得直观且易于维护。

数据库迁移与版本控制

在现代Web应用开发中，数据库结构的演变与应用程序代码的变更同样重要。Yii2提供了强大的数据库迁移系统，允许开发者以版本控制的方式管理数据库结构的变化，确保开发、测试和生产环境之间的数据库一致性。

迁移的核心概念

数据库迁移是一种特殊的PHP类，继承自yii\db\Migration基类。每个迁移类代表一个数据库变更操作，包含up()方法用于应用变更，down()方法用于撤销变更。这种设计确保了数据库变更的可逆性。

mermaid

创建和执行迁移

创建新迁移

使用Yii命令行工具创建迁移文件：

# 创建新表迁移
yii migrate/create create_user_table

# 创建带字段的表迁移
yii migrate/create create_post_table --fields="title:string(255):notNull,content:text,created_at:datetime"

# 添加字段迁移
yii migrate/create add_status_to_post_table --fields="status:integer:defaultValue(0)"

生成的迁移文件遵循特定的命名约定：m<YYMMDD_HHMMSS>_<Name>.php，其中时间戳确保迁移的执行顺序。

迁移文件结构

典型的迁移类包含以下方法：

<?php

use yii\db\Migration;

class m150101_185401_create_user_table extends Migration
{
    public function safeUp()
    {
        $this->createTable('{{%user}}', [
            'id' => $this->primaryKey(),
            'username' => $this->string(64)->notNull()->unique(),
            'email' => $this->string(255)->notNull()->unique(),
            'password_hash' => $this->string(255)->notNull(),
            'status' => $this->smallInteger()->notNull()->defaultValue(10),
            'created_at' => $this->integer()->notNull(),
            'updated_at' => $this->integer()->notNull(),
        ]);

        // 创建索引
        $this->createIndex('idx-user-username', '{{%user}}', 'username');
        $this->createIndex('idx-user-email', '{{%user}}', 'email');
        $this->createIndex('idx-user-status', '{{%user}}', 'status');
    }

    public function safeDown()
    {
        $this->dropTable('{{%user}}');
    }
}

迁移操作API

Yii2迁移提供了丰富的数据库操作方法：

表操作

方法	描述	示例
`createTable()`	创建新表	`$this->createTable('user', [...])`
`dropTable()`	删除表	`$this->dropTable('user')`
`renameTable()`	重命名表	`$this->renameTable('user', 'users')`
`truncateTable()`	清空表数据	`$this->truncateTable('user')`

列操作

方法	描述	示例
`addColumn()`	添加列	`$this->addColumn('user', 'age', $this->integer())`
`dropColumn()`	删除列	`$this->dropColumn('user', 'age')`
`renameColumn()`	重命名列	`$this->renameColumn('user', 'name', 'username')`
`alterColumn()`	修改列定义	`$this->alterColumn('user', 'username', $this->string(100))`

索引和约束

方法	描述	示例
`createIndex()`	创建索引	`$this->createIndex('idx-username', 'user', 'username')`
`dropIndex()`	删除索引	`$this->dropIndex('idx-username', 'user')`
`addForeignKey()`	添加外键	`$this->addForeignKey('fk-user-profile', 'profile', 'user_id', 'user', 'id')`
`dropForeignKey()`	删除外键	`$this->dropForeignKey('fk-user-profile', 'profile')`

数据类型映射

Yii2使用抽象数据类型确保数据库无关性：

mermaid

常用数据类型方法：

// 主键类型
$this->primaryKey()        // 自增主键
$this->bigPrimaryKey()     // 大整数主键

// 数值类型
$this->integer()           // 整数
$this->bigInteger()        // 大整数
$this->smallInteger()      // 小整数
$this->tinyInteger()       // 微整数
$this->float()             // 浮点数
$this->double()            // 双精度
$this->decimal($p, $s)     // 十进制数

// 字符串类型
$this->string($length)     // 字符串
$this->text()              // 文本
$this->char($length)       // 定长字符串
$this->binary()            // 二进制数据

// 时间类型
$this->dateTime()          // 日期时间
$this->timestamp()         // 时间戳
$this->time()              // 时间
$this->date()              // 日期

// 其他类型
$this->boolean()           // 布尔值
$this->money()             // 货币
$this->json()              // JSON数据

迁移执行流程

Yii2使用特殊的migration表来跟踪已执行的迁移：

CREATE TABLE migration (
    version varchar(180) PRIMARY KEY,
    apply_time integer
)

迁移执行过程：

检查迁移历史表：确保migration表存在，不存在则创建
获取未执行迁移：对比文件系统中的迁移文件和数据库中的记录
按顺序执行迁移：根据文件名的时间戳顺序执行
记录执行结果：在migration表中记录已执行的迁移

高级迁移技巧

事务性迁移

对于支持事务的数据库，使用safeUp()和safeDown()方法：

public function safeUp()
{
    $this->createTable('post', [
        'id' => $this->primaryKey(),
        'title' => $this->string()->notNull(),
        'content' => $this->text(),
    ]);
    
    // 批量插入初始数据
    $this->batchInsert('post', ['title', 'content'], [
        ['欢迎使用Yii2', '这是第一篇博客文章'],
        ['迁移系统介绍', '详细讲解数据库迁移功能'],
    ]);
}

public function safeDown()
{
    $this->dropTable('post');
}

数据迁移

除了结构变更，迁移还可以用于数据操作：

public function safeUp()
{
    // 更新现有数据
    $this->update('user', ['status' => 1], 'last_login > :time', [':time' => time() - 3600]);
    
    // 插入默认数据
    $this->insert('config', [
        'name' => 'site_name',
        'value' => '我的网站',
        'created_at' => time(),
    ]);
}

public function safeDown()
{
    $this->delete('config', ['name' => 'site_name']);
    $this->update('user', ['status' => 0], '1=1');
}

多数据库支持

可以在迁移中指定不同的数据库连接：

class m150101_185401_create_log_table extends Migration
{
    public function init()
    {
        $this->db = 'logDb'; // 使用配置中的logDb组件
        parent::init();
    }
    
    public function safeUp()
    {
        $this->createTable('log', [
            'id' => $this->primaryKey(),
            'level' => $this->string(),
            'message' => $this->text(),
            'created_at' => $this->integer(),
        ]);
    }
    
    public function safeDown()
    {
        $this->dropTable('log');
    }
}

迁移最佳实践

保持迁移简单：每个迁移应该只完成一个明确的变更任务
编写可逆迁移：确保每个up()操作都有对应的down()撤销操作
测试迁移：在开发环境中充分测试迁移脚本
版本控制：将迁移文件纳入版本控制系统
文档化：在迁移文件中添加清晰的注释说明变更目的
避免业务逻辑：迁移应该只包含数据库结构变更，不包含业务逻辑

常见问题解决

迁移冲突处理

当多个开发者同时创建迁移时可能发生时间戳冲突：

# 查看迁移状态
yii migrate/status

# 重新生成迁移时间戳
yii migrate/mark 150101_185401_create_table

生产环境部署

生产环境部署时应谨慎执行迁移：

# 预检查迁移
yii migrate/check

# 交互式执行迁移
yii migrate --interactive=1

# 指定迁移数量
yii migrate/up 3  # 只执行3个迁移

迁移回滚

当需要撤销迁移时：

# 撤销最近一个迁移
yii migrate/down

# 撤销多个迁移
yii migrate/down 3  # 撤销3个迁移

# 完全重置数据库
yii migrate/fresh

通过Yii2的数据库迁移系统，团队可以高效协作，确保数据库结构的版本控制与应用程序代码同步，大大简化了多环境部署和团队协作的复杂度。

多数据库支持与性能优化技巧

Yii2框架提供了强大的多数据库支持和丰富的性能优化机制，让开发者能够轻松应对复杂的数据库应用场景。通过合理的配置和优化，可以显著提升应用的性能和可扩展性。

多数据库连接配置

Yii2支持同时连接多个不同类型的数据库，通过配置不同的数据库连接组件来实现。以下是一个典型的多数据库配置示例：

'components' => [
    'db' => [
        'class' => 'yii\db\Connection',
        'dsn' => 'mysql:host=localhost;dbname=main_db',
        'username' => 'root',
        'password' => '',
        'charset' => 'utf8mb4',
    ],
    'secondaryDb' => [
        'class' => 'yii\db\Connection',
        'dsn' => 'pgsql:host=localhost;dbname=analytics_db',
        'username' => 'postgres',
        'password' => '',
        'charset' => 'utf8',
    ],
    'redisCache' => [
        'class' => 'yii\redis\Connection',
        'hostname' => 'localhost',
        'port' => 6379,
        'database' => 0,
    ],
],

主从复制与读写分离

Yii2内置了主从复制支持，可以自动将读操作路由到从库，写操作路由到主库：

'db' => [
    'class' => 'yii\db\Connection',
    // 主库配置
    'dsn' => 'mysql:host=master.db;dbname=example',
    'username' => 'master',
    'password' => 'password',
    
    // 从库配置
    'slaves' => [
        ['dsn' => 'mysql:host=slave1.db;dbname=example'],
        ['dsn' => 'mysql:host=slave2.db;dbname=example'],
    ],
    
    // 从库通用配置
    'slaveConfig' => [
        'username' => 'slave',
        'password' => 'password',
        'attributes' => [
            PDO::ATTR_TIMEOUT => 10,
        ],
    ],
    
    // 启用读写分离
    'enableSlaves' => true,
],

数据库驱动支持矩阵

Yii2支持多种数据库管理系统，每种都有专门的Schema和QueryBuilder实现：

数据库类型	驱动名称	Schema类	主要特性
MySQL	mysql, mysqli	yii\db\mysql\Schema	事务、外键、全文索引
PostgreSQL	pgsql	yii\db\pgsql\Schema	JSONB、数组类型、高级索引
SQLite	sqlite, sqlite2	yii\db\sqlite\Schema	轻量级、文件数据库
SQL Server	sqlsrv, mssql, dblib	yii\db\mssql\Schema	企业级特性、Windows集成
Oracle	oci	yii\db\oci\Schema	高并发、企业级功能
CUBRID	cubrid	yii\db\cubrid\Schema	对象关系数据库

查询缓存优化

Yii2提供了多层次的缓存机制来优化数据库性能：

1. 查询结果缓存

// 使用查询缓存
$posts = Post::find()
    ->where(['status' => 1])
    ->cache(3600) // 缓存1小时
    ->all();

// 带依赖的缓存
$dependency = new \yii\caching\DbDependency([
    'sql' => 'SELECT MAX(updated_at) FROM post',
]);
$posts = Post::find()
    ->cache(3600, $dependency)
    ->all();

2. Schema元数据缓存

'db' => [
    'enableSchemaCache' => true,
    'schemaCacheDuration' => 3600, // 缓存1小时
    'schemaCache' => 'cache', // 使用缓存组件
    'schemaCacheExclude' => ['temp_table'], // 排除不需要缓存的表
],

批量操作性能优化

使用批量操作可以显著减少数据库往返次数：

// 批量插入
Yii::$app->db->createCommand()->batchInsert('user', ['name', 'email'], [
    ['user1', 'user1@example.com'],
    ['user2', 'user2@example.com'],
    ['user3', 'user3@example.com'],
])->execute();

// 批量更新
foreach ($users as $user) {
    Yii::$app->db->createCommand()
        ->update('user', ['status' => 1], ['id' => $user->id])
        ->execute();
}

// 使用事务包装批量操作
$transaction = Yii::$app->db->beginTransaction();
try {
    // 批量操作代码
    $transaction->commit();
} catch (\Exception $e) {
    $transaction->rollBack();
    throw $e;
}

连接池与持久连接

'db' => [
    'attributes' => [
        PDO::ATTR_PERSISTENT => true, // 启用持久连接
        PDO::ATTR_TIMEOUT => 30,      // 连接超时时间
        PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'utf8mb4'",
    ],
    'pool' => [
        'max' => 20,    // 最大连接数
        'min' => 5,     // 最小连接数
        'idle' => 300,  // 空闲连接超时时间(秒)
    ],
],

数据库监控与性能分析

Yii2提供了丰富的日志和监控功能：

// 启用数据库查询日志
'db' => [
    'enableLogging' => true,
    'enableProfiling' => true,
],

// 自定义日志目标
'log' => [
    'targets' => [
        [
            'class' => 'yii\log\DbTarget',
            'levels' => ['info', 'warning', 'error'],
            'categories' => ['yii\db\*'],
            'logTable' => 'system_log',
        ],
    ],
],

高级性能优化技巧

1. 索引优化

// 使用复合索引
class Post extends \yii\db\ActiveRecord
{
    public function indexes()
    {
        return [
            [
                'columns' => ['category_id', 'status', 'created_at'],
                'unique' => false,
                'name' => 'idx_category_status_date',
            ],
        ];
    }
}

2. 查询优化

// 避免N+1查询问题
// 不好的做法
$posts = Post::find()->all();
foreach ($posts as $post) {
    $author = $post->author; // 每次循环都执行一次查询
}

// 好的做法 - 使用with()预加载
$posts = Post::find()->with('author')->all();
foreach ($posts as $post) {
    $author = $post->author; // 已经预加载，不会产生额外查询
}

3. 分库分表策略

// 动态数据源路由
class DynamicDbManager extends \yii\base\Component
{
    public function getDb($shardKey)
    {
        $shardId = $this->getShardId($shardKey);
        return Yii::$app->get('db_' . $shardId);
    }
    
    private function getShardId($key)
    {
        // 根据业务逻辑计算分片ID
        return crc32($key) % 10;
    }
}

性能监控流程图

mermaid

通过合理配置多数据库支持和实施这些性能优化技巧，可以显著提升Yii2应用的数据库性能和可扩展性。关键在于根据实际业务需求选择合适的策略，并持续监控和优化数据库性能。

总结

Yii2框架提供了全面而强大的数据库操作解决方案，通过ActiveRecord模式实现了面向对象的数据库操作方式，让开发者能够以更直观的方式处理数据。QueryBuilder则为复杂查询提供了灵活且安全的构建方式，支持几乎所有SQL特性。结合完善的数据库迁移系统和多数据库支持机制，Yii2能够满足各种规模的应用程序需求。本文详细介绍了这些核心组件的原理、最佳实践和性能优化技巧，帮助开发者构建高性能、可维护且安全的数据库应用。掌握这些技术对于开发高质量的Yii2应用程序至关重要，能够显著提升开发效率和系统性能。

【免费下载链接】yii2 Yii 2: The Fast, Secure and Professional PHP Framework 项目地址: https://gitcode.com/gh_mirrors/yi/yii2

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考