Laravel RESTful API嵌套资源URL如何传递Null值？

我懂你遇到的这个麻烦——想让嵌套路由里的foo参数支持可选、传递null，但默认的resource路由配置和控制器写法没法直接实现。下面是一步步的解决思路：

1. 调整路由定义 #

默认的Route::resource('foo.bar.categories', ...)生成的嵌套路由中，foo参数是必填项，所以得手动修改路由，把foo设为可选参数。

你可以直接替换resource路由，手动定义POST请求的路由规则：

// routes/api.php（或web.php，根据你的API类型选择）
Route::post('/foo/{foo?}/bar/{bar}/categories', [CategoriesController::class, 'store'])
    ->name('foo.bar.categories.store');

如果还需要保留resource生成的其他路由（比如index、show等），可以先定义resource，再在后面覆盖store路由（确保覆盖的路由在resource之后，优先级更高）。

2. 修正控制器方法的参数 #

Laravel的路由模型绑定默认会在参数为空/不存在时返回404页面，而不是传递null。要让模型参数支持null，得在类型声明前加上?，而不是用= null的默认值写法：

use App\Models\Foo;
use App\Models\Bar;
use Illuminate\Http\Request;

public function store(?Foo $foo, Bar $bar, Request $request) {
    // 现在$foo会是两种情况：路由中foo参数为空时是null，有值时是对应的Foo实例
    if ($foo) {
        // 处理存在foo关联的业务逻辑
    } else {
        // 处理foo为null的场景
    }
    
    // 其他业务代码
}

3. 修正请求URL的写法 #

你的示例URL /foo/bar/1/categories 会把bar当作foo的参数值、1当作bar的参数值，这大概率不是你想要的效果。如果要传递null给foo，正确的URL应该是：

• /foo//bar/1/categories（foo参数留空）
• 或者如果你想直接省略/foo/部分，可以修改路由为：

  Route::post('/{foo?}/bar/{bar}/categories', [CategoriesController::class, 'store'])
      ->name('foo.bar.categories.store');
  

  这样直接用/bar/1/categories访问时，$foo就会是null。

关键注意点 #

• 路由里的可选参数必须放在必填参数的前面（这里foo?在bar前面，符合规则）。
• 路由模型绑定的nullable参数必须用?Type $param的写法，Type $param = null的写法不会触发nullable的路由模型绑定规则，只会在参数未传递时用默认值，但路由模型绑定会先尝试查找模型，找不到就返回404。

内容的提问来源于stack exchange，提问作者Navid Adelpour