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，排除跨域或服务器配置问题
