Laravel PostgreSQL Enhanced 使用教程

Laravel PostgreSQL Enhanced 使用教程

laravel-postgresql-enhancedSupport for many missing PostgreSQL specific features项目地址:https://gitcode.com/gh_mirrors/la/laravel-postgresql-enhanced

项目介绍

laravel-postgresql-enhanced 是一个为 Laravel 框架提供增强功能的扩展包，专门针对 PostgreSQL 数据库。这个扩展包由 tpetry 维护，旨在为 Laravel 开发者提供许多 PostgreSQL 特有的功能，如零停机迁移、扩展视图、部分索引等。

项目快速启动

安装

你可以通过 Composer 安装这个包：

composer require tpetry/laravel-postgresql-enhanced

配置

安装完成后，你需要在 Laravel 项目中进行一些配置。首先，确保你的数据库配置文件 config/database.php 中已经配置了 PostgreSQL 连接。

'connections' => [
    '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',
    ],
],

使用示例

以下是一个简单的使用示例，展示了如何在模型中使用 RefreshDataOnSave 特性：

use Illuminate\Database\Eloquent\Model;
use Tpetry\PostgresqlEnhanced\Eloquent\Concerns\RefreshDataOnSave;

class Example extends Model
{
    use RefreshDataOnSave;

    protected $fillable = ['text'];
}

$example = Example::create(['text' => 'test']);
dump($example); // ['id' => 1, 'text' => 'test', 'text_uppercase' => 'TEST']

$example->fill(['text' => 'test2'])->save();
dump($example); // ['id' => 1, 'text' => 'test2', 'text_uppercase' => 'TES2T']

应用案例和最佳实践

零停机迁移

对于需要 24/7 运行的应用程序，迁移必须不影响可用性。PostgreSQL 提供了许多功能来执行无停机时间的架构更改。以下是一个零停机迁移的示例：

use Tpetry\PostgresqlEnhanced\Schema\Blueprint;
use Tpetry\PostgresqlEnhanced\Support\Facades\Schema;

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('email')->unique();
    $table->timestamps();
});

最佳实践

1. 使用部分索引：在某些情况下，使用部分索引可以显著提高查询性能。
2. 利用 PostgreSQL 特有的数据类型：如 hstore、xml 等。
3. 避免长时间锁定表：在执行迁移时，确保不会长时间锁定表。

典型生态项目

Laravel 生态系统

laravel-postgresql-enhanced 是 Laravel 生态系统中的一个重要组成部分，它与其他 Laravel 包和工具（如 nunomaduro/larastan）很好地集成在一起，提供了更强大的静态分析和代码质量保证。

相关项目

1. Larastan：一个 Laravel 的静态分析工具，可以帮助你发现代码中的潜在问题。
2. PHPStan：一个通用的 PHP 静态分析工具，Larastan 是基于 PHPStan 构建的。

通过这些工具和扩展包，你可以更高效地开发和维护基于 Laravel 和 PostgreSQL 的应用程序。

laravel-postgresql-enhancedSupport for many missing PostgreSQL specific features项目地址:https://gitcode.com/gh_mirrors/la/laravel-postgresql-enhanced