Laravel HTTP 客户端与 PHP API 的 JSON 响应处理教程

<?php
// 模拟一些处理逻辑
$zipname = 'processed_images_' . time() . '.zip'; // 假设生成了一个 zip 文件名

$response_data = [
    'status' => http_response_code(), // 获取当前 HTTP 状态码
    'zip name' => basename($zipname),
    'link' => 'http://localhost/imageresizer/zip/' . basename($zipname)
];

header("Content-Type: application/json"); // 明确告知客户端响应内容是 JSON
echo json_encode($response_data); // 将数据编码为 JSON 字符串并输出
?>

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;
use Illuminate\Http\Request; // 如果在控制器中使用

class ImageProcessingController extends Controller
{
    public function processImage(Request $request)
    {
        $p = 'img.jpg';
        // 使用 Storage facade 获取文件路径，更安全和规范
        $path = Storage::path('public/images/' . $p);

        // 确保文件存在
        if (!Storage::exists('public/images/' . $p)) {
            dd('文件不存在: ' . $path);
        }

        try {
            // 发送带有文件和表单数据的 POST 请求
            $response = Http::attach(
                'new_file',
                file_get_contents($path),
                'new_file.jpg' // 指定上传的文件名
            )->post('http://localhost/imageresizer/service.php', [
                // 确保数组结构与 PHP API 预期一致
                'sizes' => [
                    ['new_width' => 400, 'new_height' => 200],
                    ['new_width' => 300, 'new_height' => 500]
                ]
            ]);

            // 检查响应是否成功 (HTTP 状态码 2xx)
            if ($response->successful()) {
                $jsonResponse = $response->json(); // 核心：使用 json() 方法解析响应体

                // 访问解析后的 JSON 数据
                $status = $jsonResponse['status'] ?? '未知状态';
                $zipName = $jsonResponse['zip name'] ?? '未知文件名'; // 注意键名与 PHP API 返回的一致
                $link = $jsonResponse['link'] ?? '未知链接';

                dd([
                    'message' => 'API 请求成功并解析数据',
                    'status' => $status,
                    'zip_name' => $zipName,
                    'link' => $link,
                    'raw_json_data' => $jsonResponse // 原始解析后的数组
                ]);

            } elseif ($response->failed()) {
                // 处理请求失败 (HTTP 状态码 4xx 或 5xx)
                dd('API 请求失败:', [
                    'status_code' => $response->status(),
                    'error_body' => $response->body() // 获取原始响应体以便调试
                ]);
            } else {
                // 其他非成功非失败情况 (例如重定向，但在 API 场景不常见)
                dd('API 响应异常:', $response->status(), $response->body());
            }

        } catch (\Illuminate\Http\Client\RequestException $e) {
            // 捕获 HTTP 客户端请求异常，例如连接超时
            dd('HTTP 请求异常:', $e->getMessage(), $e->response ? $e->response->body() : '无响应体');
        } catch (\Exception $e) {
            // 捕获其他通用异常
            dd('请求过程中发生通用异常:', $e->getMessage());
        }
    }
}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse; // 可以选择导入，但非必需

class MyApiController extends Controller
{
    /**
     * 处理并返回 JSON 格式的数据。
     *
     * @param Request $request
     * @return JsonResponse
     */
    public function getData(Request $request): JsonResponse
    {
        // 假设这里进行了数据查询或业务逻辑处理
        $data = [
            'message' => '数据获取成功',
            'user_id' => $request->user()->id ?? null, // 示例：获取当前用户ID
            'items' => [
                ['id' => 1, 'name' => 'Item A'],
                ['id' => 2, 'name' => 'Item B']
            ],
            'timestamp' => now()->toDateTimeString()
        ];

        // 使用 response()->json() 返回 JSON 响应
        // 第一个参数是数据数组，第二个参数是 HTTP 状态码
        return response()->json($data, 200);
    }

    /**
     * 返回一个带有错误信息的 JSON 响应。
     *
     * @return JsonResponse
     */
    public function errorResponse(): JsonResponse
    {
        return response()->json([
            'message' => '请求参数无效',
            'errors' => [
                'field_name' => ['此字段是必填项']
            ]
        ], 422); // 422 Unprocessable Entity 常用作验证错误
    }
}