Laravel и PostgreSQL: Полное руководство по настройке и использованию

Laravel отлично работает с PostgreSQL — одной из самых популярных реляционных баз данных. В этом руководстве мы рассмотрим настройку соединения, миграции, типы данных, работу с JSON и специфические возможности PostgreSQL в Laravel.

Подключение Laravel к PostgreSQL

Для начала убедитесь, что установлен драйвер pdo_pgsql на сервере PHP.

В файле .env настройте соединение:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=laravel_db
DB_USERNAME=postgres
DB_PASSWORD=your_password

В config/database.php подключение уже настроено:

'pgsql' => [
    'driver' => 'pgsql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '5432'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
    'schema' => 'public',
    'sslmode' => 'prefer',
],

Миграции и типы данных PostgreSQL

Laravel поддерживает основные типы данных PostgreSQL:

• integer, bigInteger, smallInteger
• string, text
• boolean
• json, jsonb — для хранения JSON
• uuid — уникальные идентификаторы
• timestamps — created_at и updated_at
• decimal, float — для чисел с плавающей точкой

Пример миграции с PostgreSQL:

php artisan make:migration create_products_table --create=products

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateProductsTable extends Migration
{
    public function up()
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->decimal('price', 10, 2);
            $table->jsonb('metadata')->nullable();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('products');
    }
}

Работа с JSONB

PostgreSQL поддерживает jsonb, что позволяет хранить сложные структуры данных.

$product = Product::create([
    'name' => 'Телефон',
    'price' => 499.99,
    'metadata' => ['color' => 'черный', 'memory' => '128GB']
]);

// Поиск по JSONB
$blackPhones = Product::where('metadata->color', 'черный')->get();

Особенности PostgreSQL в Laravel

• Уникальные индексы: $table->unique([‘column1′,’column2’]);
• Enum: $table->enum(‘status’, [‘active’, ‘inactive’]);
• Full-text search: через tsvector и pg_trgm extension
• UUID: $table->uuid(‘id’)->primary();

Использование транзакций

Для обеспечения целостности данных:

DB::transaction(function () {
    $user = User::create(['name' => 'Ivan']);
    $user->posts()->create(['title' => 'Post 1']);
});

Оптимизация запросов

• Используйте with() для жадной загрузки отношений
• Добавляйте индексы на поля для фильтрации и сортировки
• Используйте jsonb_path_query и функции PostgreSQL для сложного поиска по JSON
• Для больших таблиц используйте пагинацию и лимиты

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

1. Какие версии PostgreSQL поддерживает Laravel?

Laravel официально поддерживает PostgreSQL 9.6 и выше.

2. Можно ли использовать JSONB вместо отдельных колонок?

Да, JSONB отлично подходит для хранения динамических или редко используемых полей.

3. Как подключить UUID как primary key?

Используйте $table->uuid(‘id’)->primary(); и в модели добавьте public $incrementing = false; и protected $keyType = 'string';.

4. Поддерживает ли Laravel транзакции PostgreSQL?

Да, через DB::transaction() можно безопасно выполнять несколько операций.

5. Можно ли использовать специфические функции PostgreSQL через Eloquent?

Да, через DB::raw() или кастомные запросы можно использовать любые функции PostgreSQL.

Вывод

Laravel и PostgreSQL работают вместе максимально эффективно. Используя HasMany, JSONB, транзакции, UUID и индексы, вы можете создавать быстрые и гибкие приложения с надежной базой данных. PostgreSQL предоставляет расширенные возможности, которые полностью интегрируются с Eloquent ORM и Laravel Query Builder.