kknongchang_2506/app/Module/GameItems_obsolete/Casts/JsonCast.php

<?php

namespace App\Module\GameItems\Casts;

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

/**
 * JSON类型转换器
 *
 * 通用的JSON类型转换器，用于将数据库中存储的JSON字符串转换为PHP数组，以及将PHP数组转换回JSON字符串。
 * 该类提供了基础的JSON序列化和反序列化功能，可用于处理各种JSON格式的数据。
 * 包含了对空值、无效JSON的处理，以及对中文等Unicode字符的支持。
 */
class JsonCast implements CastsAttributes
{
    /**
     * 将取出的数据转换为对应的类型
     *
     * @param  Model  $model
     * @param  string  $key
     * @param  mixed  $value
     * @param  array  $attributes
     * @return array|null
     */
    public function get($model, string $key, $value, array $attributes)
    {
        if (is_null($value)) {
            return [];
        }

        $decoded = json_decode($value, true);
        return is_array($decoded) ? $decoded : [];
    }

    /**
     * 将给定的值转换为存储格式
     *
     * @param  Model  $model
     * @param  string  $key
     * @param  mixed  $value
     * @param  array  $attributes
     * @return string|null
     */
    public function set($model, string $key, $value, array $attributes)
    {
        if (is_null($value)) {
            return null;
        }

        if (is_array($value) || is_object($value)) {
            return json_encode($value, JSON_UNESCAPED_UNICODE);
        }

        if (is_string($value) && $this->isJson($value)) {
            return $value;
        }

        return json_encode([], JSON_UNESCAPED_UNICODE);
    }

    /**
     * 判断字符串是否为有效的JSON
     *
     * @param  string  $value
     * @return bool
     */
    protected function isJson($value)
    {
        if (!is_string($value)) {
            return false;
        }

        json_decode($value);
        return json_last_error() === JSON_ERROR_NONE;
    }
}