Laravel 5.7中JSONResource的toArray方法声明兼容错误求助

问题描述 #

本地Laravel 10环境运行正常的代码，部署到Laravel 5.7虚拟主机时出现以下错误：

Declaration of App\Http\Resources\DataResource::toArray(Illuminate\Http\Request $request) should be compatible with Illuminate\Http\Resources\Json\JsonResource::toArray($request)

原因分析 #

Laravel 5.7版本的JsonResource类中，toArray方法的参数没有声明类型提示，而你的代码中给参数添加了Illuminate\Http\Request类型约束，导致方法签名与父类不兼容，触发PHP的方法兼容性报错。

解决步骤 #

1. 修正DataResource的toArray方法 #

去掉参数的类型提示，保持与Laravel 5.7父类方法签名一致。如果需要IDE代码提示，可以在方法内部添加类型注释：

修改后的DataResource.php代码：

<?php

namespace App\Http\Resources;

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

class DataResource extends JsonResource
{
    public function toArray($request)
    {
        // 可选：添加类型注释以获得IDE代码提示
        /** @var Request $request */
        return parent::toArray($request);
    }
}

2. 修正集合返回方式（可选但推荐） #

Laravel 5.7中返回资源集合时，应该使用::collection()方法而非直接实例化资源类，否则可能导致数据结构不符合预期：

修改后的UserController.php中showUser方法：

public function showUser()
{
    $users = User::get();
    return DataResource::collection($users);
}

内容的提问来源于stack exchange，提问作者Merry Ricard