在API Platform（Symfony 6）中自定义cURL选项调用接口的问题

问题背景 #

我正在使用Symfony 6搭配API Platform开发项目，调用第三方短信服务接口时需要自定义cURL选项，但不清楚配置位置与方式。给定的cURL调用命令如下：

curl --location --request POST 'https://wsd.server-test-enviroment.es/v1/sms/sendSMS' \
--header 'x-api-key: c3f4f6bc-f12a-433b-9026-ebbf6cc7933c' \
--form 'destinatarios="666777888"' \
--form 'mensaje="Test"'
-k  

我通过POST方式调用服务时需替换对应参数，作为首次接触cURL和Symfony的新手，编写了如下控制器代码但疑似存在错误，希望得到指导：

class SMSController extends AbstractController
{
    public function __invoke(Request $request): JsonResponse
    {   
        $sms = json_decode($request->getContent(), true);
        $client = HttpClient::create();

        $data = [
            'destinatarios' => $sms['destinatarios'],
            'mensaje' => $sms['mensaje']
        ];

         //opciones del cURL
            $options = [
                'headers' => [
                    'x-api-key' => 'c3f4f6bc-f12a-433b-9026-ebbf6cc7933c',
                ],
                'body' => $data,
                'verify_peer' => false //  ignorar la verificación SSL
            ];

        // Realiza la solicitud HTTP
        $respuesta = $client->request('POST', 'https://wsd.server-test-enviroment.es/v1/sms/sendSMS', $options);

        // Obtiene el contenido de la respuesta
        $content = $respuesta->getContent();


        return new JsonResponse($content);
    }
}

问题分析 #

1. 表单数据格式不匹配：原cURL命令使用--form提交multipart/form-data格式的数据，但代码用body传递数组时，Symfony HttpClient默认会将其序列化为JSON格式，和接口要求的表单格式不符。
2. SSL验证参数错误：Symfony HttpClient中禁用SSL证书验证的正确参数是verify，而非单独的verify_peer。设置verify => false等价于cURL的-k选项。
3. 请求参数安全问题：直接使用$sms['destinatarios']和$sms['mensaje']未做存在性检查，若请求中缺少这些参数会触发未定义索引错误。
4. 返回值处理错误：getContent()返回的是字符串，直接传入JsonResponse会将其转义为JSON字符串，导致返回格式不符合预期。

正确实现代码 #

use Symfony\Contracts\HttpClient\HttpClientInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\JsonResponse;

class SMSController extends AbstractController
{
    public function __invoke(Request $request, HttpClientInterface $client): JsonResponse
    {   
        // 解析请求内容并做安全检查
        $sms = json_decode($request->getContent(), true) ?? [];
        $destinatarios = $sms['destinatarios'] ?? '';
        $mensaje = $sms['mensaje'] ?? '';

        if (empty($destinatarios) || empty($mensaje)) {
            return new JsonResponse(['error' => '缺少必要参数'], 400);
        }

        // 配置请求选项
        $options = [
            'headers' => [
                'x-api-key' => 'c3f4f6bc-f12a-433b-9026-ebbf6cc7933c',
            ],
            // 使用multipart选项提交表单数据，对应cURL的--form
            'multipart' => [
                [
                    'name' => 'destinatarios',
                    'contents' => $destinatarios
                ],
                [
                    'name' => 'mensaje',
                    'contents' => $mensaje
                ]
            ],
            // 禁用SSL证书验证，对应cURL的-k选项
            'verify' => false
        ];

        // 发送请求
        $respuesta = $client->request('POST', 'https://wsd.server-test-enviroment.es/v1/sms/sendSMS', $options);

        // 将接口响应转为数组后返回
        $content = $respuesta->toArray();

        return new JsonResponse($content);
    }
}

补充说明 #

• 建议通过依赖注入注入HttpClientInterface而非直接create()，更符合Symfony的最佳实践，也便于测试。
• 生产环境中尽量不要禁用SSL验证（verify => false），若测试环境证书问题，可配置可信证书路径替代。
• 可添加异常捕获逻辑，处理请求超时、接口返回错误码等情况，提升接口健壮性。

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