Eloquent需通过$casts显式声明范围类型（如'int4range'）或自定义Cast类处理PgSqlRange，WHERE条件须用whereRaw配合&&、@>等操作符，不可用whereBetween；插入更新应使用PgSqlRange::make()或DB::raw构造。
PostgreSQL 范围类型在 Eloquent 中怎么映射
PostgreSQL 的 int4range、tsrange、daterange 等范围类型，Eloquent 默认不识别——直接查会报错 SQLSTATE[22P02]: Invalid text representation。必须手动告诉 Laravel 这个字段是“范围”，否则模型取值时解析失败，存值时还会被转成字符串拼进 SQL。
实操建议：
- 在模型中用
$casts显式声明：'availability' => 'int4range'（对应 PostgreSQL 的int4range）或'schedule' => 'tsrange' - Laravel 10+ 原生支持部分范围类型，但仅限于 PostgreSQL 驱动 +
pgsql连接配置；MySQL 或 SQLite 下设了也无效 - 自定义 cast 类更稳妥：继承
Illuminate\Database\Eloquent\Casts\Cast，实现get/set，处理PgSqlRange对象与数组之间的转换
怎么写包含「重叠」和「包含」的 WHERE 条件
Eloquent 不提供 whereOverlaps() 或 whereContains() 这类方法，得用原始表达式拼 OVERLAPS、@>、 等 PostgreSQL 操作符。
常见错误现象：用 where('period', '&&', '[1,5)') 报错——因为 && 是操作符，不是比较运算符，不能走默认 where 构建逻辑。
正确做法：
- 用
whereRaw：->whereRaw("period && int4range(?, ?, '[]')", [1, 5]) - 查询某时间点是否在范围内：
->whereRaw("period @> ?", ['2024-06-15'::date])（注意日期要加类型标注或用PgSqlRange::point()封装） - 避免手拼字符串范围字面量（如
'[1,5)'），容易引号/转义出错；优先用int4range()函数构造
范围字段怎么安全地插入和更新
直接赋值数组（如 ['min' => 1, 'max' => 5]）或字符串（如 '[1,5)'）到模型属性，Eloquent 会原样塞进 SQL，PostgreSQL 可能拒绝解析或产生边界错误。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
关键点在于：范围值必须由 PostgreSQL 函数生成，或由 Eloquent cast 层统一转换。
- 插入前用
PgSqlRange::make(1, 5, '[]')（需安装laravel/framework >= 10.27或手动引入辅助类） - 若用自定义 cast，确保
set方法返回DB::raw("int4range($min, $max, '$bounds')")形式 - 更新时慎用
update()批量赋值——如果字段没进$fillable或没在$casts里，会被忽略或转成空字符串 - 范围上下界为 NULL 时（如
(,5)），必须传 PHPnull，不能传空字符串或'NULL'
为什么 whereBetween 对 range 字段无效
whereBetween('period', [$a, $b]) 本质是生成 period BETWEEN $a AND $b，而 PostgreSQL 的范围字段不支持直接和标量比大小。它会尝试把整个 range 当字符串或数字转，结果要么报错，要么永远不匹配。
真正等价的语义是「该范围是否包含 [$a, $b] 这个区间」或「是否与 [$a, $b] 重叠」：
- 要「完全包含」：
whereRaw("period @> int4range(?, ?, '[]')", [$a, $b]) - 要「有交集」：
whereRaw("period && int4range(?, ?, '[]')", [$a, $b]) - 想查「左端点 >= $a 且右端点 lower(period) >= ? AND upper(period) ，并注意
upper()对空上限返回 NULL，需额外判空
边界开闭（'[]' / '[)' / '(]' / '()'）影响结果，生产环境务必确认业务语义和数据库实际存储一致。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
