Laravel 5 中应使用 GuzzleHttp\Client::patch() 发送 PATCH 请求,需显式设置 Content-Type: application/json 及 Authorization 头,配合 'json' 选项传参;不可用 Laravel 5 尚未引入的 Http facade;服务端须配置路由 Route::patch() 并确保 Web 服务器允许 PATCH 方法。

在 Laravel 5 中,原生的 Http 或 GuzzleHttp\Client 并不直接支持 PATCH 方法(尤其是旧版 Guzzle 6.2 之前),但实际发送 PATCH 请求完全可行——关键是正确设置请求方法和 Content-Type,并确保服务端能识别。
使用 GuzzleHttp\Client 发送 PATCH 请求
Laravel 5 默认使用 Guzzle 6.x,它支持 PATCH 方法。推荐用 GuzzleHttp\Client 实例调用 patch() 方法:
- 确保已安装
guzzlehttp/guzzle(Laravel 5.1+ 通常已自带) - 发送时显式指定
Content-Type: application/json(尤其传 JSON 数据时) - 注意:Laravel 的
Httpfacade(Illuminate\Support\Facades\Http)在 Laravel 5 中尚未引入(它是 Laravel 7+ 的特性),所以 Laravel 5 必须用 Guzzle 原生方式
示例代码:
$client = new \GuzzleHttp\Client();
try {
$response = $client->patch('https://api.example.com/users/123', [
'headers' => [
'Authorization' => 'Bearer your-token',
'Content-Type' => 'application/json',
],
'json' => [
'name' => 'New Name',
'email' => 'new@example.com'
]
]);
$data = json_decode($response->getBody(), true);
} catch (\GuzzleHttp\Exception\RequestException $e) {
\Log::error('PATCH request failed: ' . $e->getMessage());
}
用 cURL 手动发送 PATCH(不依赖 Guzzle)
如果因环境限制不能用 Guzzle,可直接用 PHP 原生 curl,关键点是设置 CURLOPT_CUSTOMREQUEST = 'PATCH',并手动传数据(如 JSON):
- 必须设
CURLOPT_CUSTOMREQUEST为'PATCH'(不能只改POST+ method 字段) - 用
CURLOPT_POSTFIELDS传原始 JSON 字符串,并配Content-Type: application/json - 记得启用
CURLOPT_RETURNTRANSFER获取响应体
示例:
$url = 'https://api.example.com/users/123';
$data = json_encode(['status' => 'active']);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Content-Length: ' . strlen($data),
'Authorization: Bearer your-token'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
}
后端接收 PATCH 请求的注意事项
Laravel 5 路由和控制器默认支持 PATCH,但需确认几点:
- 路由定义中明确使用
Route::patch(),例如:Route::patch('/users/{id}', 'UserController@update'); - HTML 表单无法直接发 PATCH(浏览器只支持 GET/POST),前端需用 JS(如 Axios、Fetch)或后端 cURL
- 若前端用表单模拟 PATCH,Laravel 支持通过
_method=PATCH配合 POST 提交(需加@method('PATCH')Blade 指令和@csrf)
常见问题排查
如果 PATCH 请求返回 405 Method Not Allowed 或 404:
- 检查 Apache/Nginx 是否拦截了 PATCH 方法(部分旧版服务器默认禁用,需在配置中显式允许)
- 确认 Laravel 路由缓存是否过期(执行
php artisan route:clear) - 查看中间件是否误拦截非 GET/POST 请求(如某些 CORS 或权限中间件)
- 用
curl -X PATCH -I [url]测试服务端是否响应 200/204,排除跨域或服务器配置问题











