Laravel控制器中自定义数据数组并输出JSON格式问题求助

我在Laravel控制器里创建Document Eloquent实例并赋值后，直接echo这个实例能得到JSON格式的结果：

$document = new Document();
$document->title = $request['title'];
$document->description = $request['description'];
echo $document; // 输出: {"title":"asdfasdf","description":"asdfasdfsadf"}

但当我尝试自定义一个数组并直接echo时，却无法得到相同的JSON格式：

$data = array( "title" => "hello", "description" => "test test test" );
echo $data; // 输出不是预期的JSON

想知道怎么让自定义数组也能输出同样的JSON格式，求帮助。

原因分析 #

Laravel的Eloquent模型（比如你的Document类）之所以能直接echo输出JSON，是因为它底层实现了JsonSerializable接口，并且重写了__toString()方法，在这个方法里自动完成了JSON序列化的逻辑。而普通的PHP数组并没有这个特性，直接echo数组只会输出字符串Array（在某些PHP版本下甚至会抛出错误）。

解决方法 #

这里有几种简单的方式可以让你的自定义数据输出预期的JSON格式：

1. 使用PHP内置的json_encode()函数 #

这是最直接的解决方案，用PHP原生函数把数组转为JSON字符串：

$data = array( "title" => "hello", "description" => "test test test" );
echo json_encode($data); // 输出: {"title":"hello","description":"test test test"}

2. 转为Laravel Collection实例 #

Laravel的Collection集合类同样支持直接echo输出JSON，因为它也实现了对应的序列化接口：

$data = collect([
    "title" => "hello",
    "description" => "test test test"
]);
echo $data; // 输出符合预期的JSON格式

3. 给自定义对象添加序列化逻辑（如果用对象而非数组的话） #

如果你希望自己定义的对象也能像Eloquent模型那样直接echo输出JSON，可以参考Eloquent的实现，给类添加__toString()方法：

class CustomData {
    public $title;
    public $description;

    public function __toString()
    {
        return json_encode([
            'title' => $this->title,
            'description' => $this->description
        ]);
    }
}

$data = new CustomData();
$data->title = "hello";
$data->description = "test test test";
echo $data; // 输出JSON格式结果

内容的提问来源于stack exchange，提问作者Ronald Torres