PHP怎么处理Eloquent Casts自定义转换_Laravel复杂属性处理【技巧】-php教程-PHP中文网

自定义 Cast 类必须实现 Castable 接口或继承 CastsAttributes 抽象类，否则报错；$casts 中须用 ::class 语法；带参 Cast 需通过 Castable 的 castUsing() 实现；Cast 内应无状态、不访问模型关系或未初始化属性。

php怎么处理eloquent casts自定义转换_laravel复杂属性处理【技巧】

自定义 Cast 类必须实现 `Castable` 接口或继承 `Cast`

直接写一个普通类当 Cast 会报错：Class "App\Casts\CustomJson" is not a valid cast。Laravel 要求自定义 Cast 必须显式声明可被识别——要么实现 Castable 接口（返回真实 Cast 类），要么继承 Illuminate\Contracts\Database\Eloquent\CastsAttributes（即 Cast 抽象类）。

推荐用后者，更直观可控：

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;

class CustomJson implements CastsAttributes
{
    public function get($model, string $key, $value, array $attributes)
    {
        return json_decode($value, true) ?: [];
    }

    public function set($model, string $key, $value, array $attributes): string
    {
        return json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    }
}

注意：set() 方法必须返回 string（或 null），否则 Eloquent 会静默丢弃该字段值，且不报错。

`$casts` 数组里写的是类名字符串，不是实例

在 Model 中配置时，$casts 的值是类的完整命名空间字符串，不是对象、不是 new 实例，也不是 class 关键字：

protected $casts = [
    'metadata' => CustomJson::class,
    'options' => 'array', // 内置 cast 可用字符串
];

常见错误包括：

写成 'metadata' => new CustomJson() → Laravel 会尝试调用 __toString()，报错
写成 'metadata' => CustomJson（缺 ::class）→ PHP 未定义常量
写成 'metadata' => 'App\Casts\CustomJson' → 虽然能运行，但不推荐：硬编码字符串易出错，且 IDE 无法跳转

带参数的 Cast 需用 `Castable` 接口 + `castUsing()`

如果需要动态传参（比如指定 JSON 解码深度、是否关联数组），不能靠构造函数注入——Eloquent 实例化 Cast 时不传参。正确方式是让模型属性指向一个实现 Castable 的“代理类”：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

use Illuminate\Contracts\Database\Eloquent\Castable;
use Illuminate\Contracts\Database\Eloquent\CastsAttributes;

class JsonWithDepth implements Castable
{
    public function __construct(public int $depth = 512) {}

    public function castUsing(array $arguments): string
    {
        return JsonDepthCast::class;
    }
}

// 然后在 Model 中：
protected $casts = [
    'payload' => JsonWithDepth::class.':1024',
];

这里 ':1024' 会被作为 $arguments 传入 castUsing()，你可以解析并返回不同行为的 Cast 类。注意：冒号后内容是字符串，需手动 (int) 转换。