PostgreSQL数组字段在Eloquent中需用whereRaw配合@>、&&或ANY操作符查询，$casts可自动转换读取值但不影响写入和查询逻辑。
PostgreSQL 数组字段在 Eloquent 中怎么查？
直接用 where() 查 PostgreSQL 的数组字段（如 text[]、integer[]）会失败——Eloquent 默认把数组当普通字符串或 JSON 处理，根本不会生成 @>、 或 <code>ANY() 这类 PostgreSQL 原生数组操作符。
必须绕过 Eloquent 的默认行为，用原生 SQL 片段或 whereRaw() 显式调用 PostgreSQL 数组函数：
-
WHERE column @> ARRAY[?]：判断数组是否包含指定元素（推荐用于「包含某值」场景） -
WHERE ? = ANY(column)：等价于上一条，但兼容性略好，尤其在参数绑定时更稳定 -
WHERE column && ARRAY[?]：判断是否有交集（适合「包含任一值」多选查询）
示例：查 tags 是 text[] 类型、包含 'php' 的记录：
$posts = Post::whereRaw("? = ANY(tags)", ['php'])->get();
用 Accessor + Cast 能不能让数组自动转 PHP 数组？
可以，但仅限读取；写入和查询仍不生效。Laravel 的 $casts 支持 array，对 PostgreSQL 的数组字段也适用：
立即学习“PHP免费学习笔记（深入）”；
protected $casts = [
'permissions' => 'array', // 对应 permissions integer[]
];
这样 $model->permissions 会自动从 {1,2,3} 字符串转成 [1,2,3]，但注意：
- 数据库存的是 PostgreSQL 原生数组格式（如
{admin,editor}），不是 JSON 字符串 -
save()时，Eloquent 会把 PHP 数组['a','b']自动转成ARRAY['a','b']插入——这步是 Laravel 底层做的，没问题 - 但
where('permissions', ['admin'])依然无效：它生成的是= '["admin"]'字符串比较，不是数组包含逻辑
批量查多个数组值（比如「包含 A 或 B」）怎么写？
别用 whereIn()——它对数组字段完全无意义。正确做法是用 &&（重叠操作符）配合 ARRAY[?]：
$tags = ['php', 'laravel'];
$posts = Post::whereRaw("tags && ARRAY[?]", [$tags])->get();
注意点：
-
ARRAY[?]只接受一个参数，所以要把整个 PHP 数组传进去，Laravel 会自动展开为ARRAY['php','laravel'] - 如果用
whereRaw("tags @> ARRAY[?]", $tags)，会报错：参数数量不匹配（@>右侧只能是一个数组，不是多个标量） - 想查「同时包含 A 和 B」，得用
@>：whereRaw("tags @> ARRAY[?]", [['php','laravel']])（注意里层是数组套数组）
迁移里怎么定义 PostgreSQL 数组字段？
不能只写 $table->json('data') 或 $table->text('tags')。要用 pgsql 专用语法：
Schema::create('posts', function (Blueprint $table) {
$table->id();
$table->text('title');
$table->string('status')->default('draft');
$table->json('metadata'); // JSON 字段（可选）
$table->string('tags')->array(); // Laravel 9.2+ 支持的语法，生成 text[]
// 或手动指定：
// $table->string('tags', 100)->nullable()->array();
});
关键细节：
-
->array()是 Laravel 对 PostgreSQL 的封装，底层执行的是text[]，不是 JSON - 如果用老版本 Laravel（->raw('text[]') 或用
DB::statement()执行ALTER TABLE... - 数组字段不支持
index直接创建，要显式用DB::statement("CREATE INDEX ... ON ... USING GIN (tags);")加 GIN 索引，否则查询极慢
GIN 索引不是可选项，是必要项——没它，@> 和 && 查询基本等于全表扫描。
