如何在Laravel中为PostgreSQL迁移指定自定义Schema

我来帮你搞定这个问题，只需要几个简单的配置和操作，就能让所有Laravel迁移默认加载到你的自定义PostgreSQL Schema中，具体步骤如下：

1. 修改数据库配置文件 #

打开config/database.php，找到pgsql连接的配置数组，添加一个schema字段，指定你的自定义Schema名称（通过环境变量配置更灵活）：

'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' => '',
    'prefix_indexes' => true,
    'schema' => env('DB_SCHEMA', 'your_custom_schema'), // 新增这一行
    'sslmode' => 'prefer',
],

2. 在.env文件中配置自定义Schema #

打开项目根目录的.env文件，添加DB_SCHEMA变量，填入你已经创建好的自定义Schema名称：

DB_SCHEMA=your_custom_schema_name

3. 确保自定义Schema存在（可选但推荐） #

如果你还没在PostgreSQL中手动创建Schema，可以通过Laravel迁移自动创建它：

首先生成一个专门创建Schema的迁移文件：

php artisan make:migration create_custom_schema

然后打开生成的迁移文件，替换内容为：

use Illuminate\Database\Migrations\Migration;
use Illuminate\Support\Facades\DB;

return new class extends Migration {
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        // 仅当Schema不存在时创建
        DB::statement('CREATE SCHEMA IF NOT EXISTS ' . env('DB_SCHEMA'));
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        // 回滚时删除Schema（CASCADE会删除该Schema下的所有表）
        DB::statement('DROP SCHEMA IF EXISTS ' . env('DB_SCHEMA') . ' CASCADE');
    }
};

执行这个迁移：

php artisan migrate

4. 后续迁移的注意事项 #

完成以上配置后，你新创建的所有迁移文件都会默认在DB_SCHEMA指定的自定义Schema中创建表。如果你的模型需要关联这些表，不需要额外指定Schema（Laravel会自动使用配置的默认Schema）；如果需要手动指定，也可以在模型中这样写：

protected $table = 'your_custom_schema.your_table_name';

这样就搞定啦，之后执行php artisan migrate时，所有表都会自动创建到你的自定义Schema里了~

内容的提问来源于stack exchange，提问作者Gabrielle-M