PostgreSQL (Постгресс) и Yii: полное руководство по подключению и работе с базой данных

Фреймворк Yii и база данных PostgreSQL (Постгресс) — отличное сочетание для создания производительных и безопасных веб-приложений. В этой статье мы рассмотрим, как подключить PostgreSQL (Постгресс) к Yii, работать с Active Record, использовать чистые SQL-запросы и управлять транзакциями.

1. Зачем использовать PostgreSQL (Постгресс) с Yii

PostgreSQL (Постгресс) — мощная реляционная база данных с поддержкой транзакций, JSON, массивов и сложных индексов. Yii позволяет удобно работать с базой через Active Record и Query Builder. Вместе они дают:

• Простую работу с таблицами через модели Yii
• Безопасные SQL-запросы с защитой от инъекций
• Возможность использовать уникальные функции PostgreSQL (Постгресс), включая JSON и массивы
• Удобное управление схемой через миграции Yii

2. Подключение PostgreSQL (Постгресс) в Yii

В Yii конфигурация подключения находится в файле config/db.php:

 'yii\db\Connection',
    'dsn' => 'pgsql:host=localhost;port=5432;dbname=mydatabase',
    'username' => 'postgres',
    'password' => 'mypassword',
    'charset' => 'utf8',
];
?>

После этого Yii сможет работать с базой данных PostgreSQL (Постгресс) через Active Record и чистые SQL-запросы.

3. Модели Active Record для PostgreSQL (Постгресс)

Пример модели для таблицы users:

Примеры работы с моделью:

$user = new User();
$user->name = 'Иван';
$user->email = 'ivan@example.com';
$user->save();

// Получение пользователей
$users = User::find()->where(['active' => 1])->all();

4. Чистые SQL-запросы к PostgreSQL (Постгресс)

4.1. Простая выборка

$rows = Yii::$app->db->createCommand('SELECT * FROM users WHERE active = :active')
    ->bindValue(':active', 1)
    ->queryAll();

4.2. Запрос с JSON-полем

$products = Yii::$app->db->createCommand("
    SELECT * 
    FROM products 
    WHERE data->>'category' = :category
")
->bindValue(':category', 'electronics')
->queryAll();

4.3. Вставка данных

Yii::$app->db->createCommand("
    INSERT INTO orders (user_id, total, created_at) 
    VALUES (:user_id, :total, NOW())
")
->bindValues([':user_id' => 123, ':total' => 1500])
->execute();

4.4. Транзакции с SQL

$transaction = Yii::$app->db->beginTransaction();
try {
    Yii::$app->db->createCommand("
        UPDATE users SET balance = balance - :amount WHERE id = :id
    ")->bindValues([':amount' => 500, ':id' => 123])->execute();

    Yii::$app->db->createCommand("
        INSERT INTO transactions (user_id, amount, created_at) 
        VALUES (:id, :amount, NOW())
    ")->bindValues([':id' => 123, ':amount' => 500])->execute();

    $transaction->commit();
} catch (\Exception $e) {
    $transaction->rollBack();
    throw $e;
}

5. Миграции и управление схемой PostgreSQL (Постгресс)

Создание таблицы users через миграцию Yii:

createTable('users', [
            'id' => $this->primaryKey(),
            'name' => $this->string()->notNull(),
            'email' => $this->string()->notNull()->unique(),
            'created_at' => $this->timestamp()->defaultExpression('CURRENT_TIMESTAMP')
        ]);
    }

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

6. Рекомендации и лучшие практики

• Использовать Active Record для стандартных операций и чистые SQL-запросы для сложных задач PostgreSQL (Постгресс)
• Применять подготовленные выражения для защиты от SQL-инъекций
• Регулярно делать резервное копирование базы
• Использовать индексы и оптимизировать запросы
• Следить за обновлениями Yii и PostgreSQL (Постгресс)

7. FAQ — Часто задаваемые вопросы

1. Можно ли использовать Yii с другими СУБД?
Да, Yii поддерживает MySQL, MariaDB, SQLite, SQL Server и PostgreSQL (Постгресс).

2. Нужно ли включать расширение PDO_PGSQL?
Да, убедитесь, что на сервере установлено расширение PDO_PGSQL для работы с PostgreSQL (Постгресс).

3. Как работать с JSON-полями в PostgreSQL (Постгресс) через Yii?
Используйте нативные функции PostgreSQL и Query Builder Yii. Например, data->>’category’ позволяет фильтровать по JSON-полю.

4. Можно ли использовать транзакции?
Да, Yii поддерживает транзакции PostgreSQL (Постгресс) через метод beginTransaction().

5. В чем преимущество использования PostgreSQL (Постгресс) с Yii?
Сочетание даёт безопасность, производительность, удобство работы с Active Record и мощные возможности SQL Postgres.