Convertir un comando cURL a PHP: guía completa 2026

Aprende a transformar tus comandos cURL en código PHP nativo o Guzzle. Método, ejemplos concretos GET/POST/Auth y herramienta de conversión automática gratuita.

¿Por qué convertir cURL a PHP?

Cuando desarrollas una integración con una API de terceros, la documentación casi siempre ofrece ejemplos en forma de comandos cURL. Es práctico para probar en una terminal, pero en cuanto toca integrar la llamada en una aplicación PHP, hay que traducir a mano cada opción: método HTTP, cabeceras, cuerpo de la petición, autenticación, timeout, etc.

Esta traducción es repetitiva y propensa a errores: olvidar CURLOPT_RETURNTRANSFER, gestionar mal la codificación del body JSON, confundir CURLOPT_POST y CURLOPT_CUSTOMREQUEST... Nuestro conversor automatiza este paso y genera código PHP limpio con un clic.

💡 Conversión instantánea: Usa nuestro 🔄 Conversor cURL → PHP para obtener tu código PHP (cURL nativo o Guzzle) en unos segundos.

Anatomía de un comando cURL

Antes de convertir, conviene entender qué significa cada flag de cURL:

Opción cURLFunciónEquivalente PHP
-X POSTMétodo HTTPCURLOPT_CUSTOMREQUEST
-H 'Clave: Valor'Cabecera HTTPCURLOPT_HTTPHEADER
-d '{...}'Cuerpo de la peticiónCURLOPT_POSTFIELDS
-u user:passAutenticación BasicCURLOPT_USERPWD
-LSeguir redireccionesCURLOPT_FOLLOWLOCATION
-kIgnorar el certificado SSLCURLOPT_SSL_VERIFYPEER => false
--max-time 30Timeout en segundosCURLOPT_TIMEOUT
-A 'Agent'User-AgentCURLOPT_USERAGENT
-b 'cookie=val'CookiesCURLOPT_COOKIE
--compressedDescompresión gzipCURLOPT_ENCODING => ''

Ejemplo 1: petición GET con cabecera de autenticación

Comando cURL

curl -X GET "https://api.ejemplo.com/users/42" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.TOKEN"

Código PHP con cURL nativo equivalente

<?php
$url = 'https://api.ejemplo.com/users/42';

$headers = [
    'Accept: application/json',
    'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.TOKEN',
];

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL            => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => $headers,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    throw new Exception('Error de cURL: ' . curl_error($ch));
}

curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Fíjate en el uso de curl_setopt_array() en lugar de varias llamadas separadas a curl_setopt(): es más legible y ligeramente más eficiente.

Ejemplo 2: petición POST con body JSON

Es el caso más habitual en integraciones con API REST modernas (Stripe, SendGrid, OpenAI, etc.).

Comando cURL

curl -X POST "https://api.ejemplo.com/articulos" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -d '{"titulo": "Mi artículo", "publicado": true}'

Código PHP con cURL nativo

<?php
$url  = 'https://api.ejemplo.com/articulos';
$body = json_encode([
    'titulo'    => 'Mi artículo',
    'publicado' => true,
]);

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer TOKEN',
];

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => $headers,
    CURLOPT_POSTFIELDS     => $body,
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Con Guzzle

<?php
require_once 'vendor/autoload.php';
use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://api.ejemplo.com/articulos', [
    'headers' => [
        'Authorization' => 'Bearer TOKEN',
    ],
    'json' => [
        'titulo'    => 'Mi artículo',
        'publicado' => true,
    ],
]);

$data = json_decode($response->getBody()->getContents(), true);
var_dump($data);

La opción 'json' de Guzzle añade automáticamente la cabecera Content-Type: application/json y serializa el array PHP: no hace falta ningún json_encode() manual.

Ejemplo 3: formulario POST (application/x-www-form-urlencoded)

Comando cURL

curl -X POST "https://ejemplo.com/login" \
  -d "username=admin&password=secret123"

Código PHP

<?php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://ejemplo.com/login',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => 'username=admin&password=secret123',
    CURLOPT_HTTPHEADER     => ['Content-Type: application/x-www-form-urlencoded'],
]);
$response = curl_exec($ch);
curl_close($ch);

Si prefieres pasar un array asociativo a CURLOPT_POSTFIELDS, PHP lo codificará automáticamente como multipart/form-data, que es distinto de application/x-www-form-urlencoded. Para forzar este último formato, pasa siempre una cadena de texto.

Ejemplo 4: autenticación Basic (-u)

Comando cURL

curl -X GET "https://api.ejemplo.com/datos" \
  -u "usuario:contrasena"

Código PHP

<?php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://api.ejemplo.com/datos',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_USERPWD        => 'usuario:contrasena',
]);
$response = curl_exec($ch);
curl_close($ch);

PHP convierte CURLOPT_USERPWD en la cabecera Authorization: Basic <base64> automáticamente. También puedes hacerlo a mano con base64_encode('user:pass') si prefieres mantener el control explícito.

Buenas prácticas en PHP para peticiones HTTP

1. Comprueba siempre los errores de cURL

<?php
$response = curl_exec($ch);
if (curl_errno($ch)) {
    $error = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException('Error de cURL: ' . $error);
}
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode >= 400) {
    throw new RuntimeException("La API ha respondido con el código HTTP $httpCode");
}

2. Nunca desactives SSL en producción

La opción -k (o CURLOPT_SSL_VERIFYPEER => false) desactiva la verificación del certificado SSL. Puede sacarte de un apuro en desarrollo local, pero abre la puerta a ataques man-in-the-middle en producción. Si tienes problemas con SSL, la solución correcta es actualizar el bundle de certificados CA:

<?php
// Buena práctica: apuntar al bundle CA actualizado
curl_setopt($ch, CURLOPT_CAINFO, '/ruta/a/cacert.pem');

3. Reutiliza los handles de cURL

Si haces varias peticiones al mismo servidor, reutilizar el handle con curl_reset() es más eficiente que llamar a curl_init() cada vez: la conexión TCP/TLS puede reutilizarse gracias al keep-alive.

4. Gestiona los timeouts

<?php
curl_setopt_array($ch, [
    CURLOPT_TIMEOUT        => 30,   // timeout total en segundos
    CURLOPT_CONNECTTIMEOUT => 10,   // solo timeout de conexión
]);

cURL nativo vs. Guzzle vs. file_get_contents: ¿cuál elegir?

CriteriocURL nativoGuzzlefile_get_contents
DependenciasExtensión cURL de PHPComposer + paqueteallow_url_fopen
APIVerbosa pero completaFluida y modernaMinimalista
AsíncronoNo (curl_multi_exec)Sí (Promises)No
Gestión de erroresManualExcepciones automáticasBásica
MiddlewaresNoSí (retry, log, caché...)No
Ideal paraProyectos sin ComposerProyectos modernosScripts sencillos

Cómo obtener un comando cURL desde tu navegador

Puedes exportar cualquier petición HTTP que haga tu navegador como comando cURL, algo muy útil para depurar o reproducir una llamada a una API:

  1. Abre las DevTools (F12)
  2. Ve a la pestaña Red (Network)
  3. Realiza la acción que lanza la petición
  4. Haz clic derecho sobre la petición en la lista → Copiar → Copiar como cURL
  5. Pega el comando en nuestro conversor cURL → PHP

Esta técnica funciona en Chrome, Firefox y Edge. Es especialmente valiosa para reproducir llamadas autenticadas con cookies o tokens de sesión.

🎯 ¡Convierte tus comandos cURL ahora!

Nuestra herramienta genera al instante:

  • ✅ PHP con cURL nativo (curl_init / curl_setopt_array)
  • ✅ Guzzle HTTP (con json, form_params, multipart)
  • ✅ file_get_contents con stream_context
  • ✅ Detección automática de JSON, form-data y Basic Auth

🔄 Conversor cURL → PHP gratis

Última actualización: marzo de 2026. Ejemplos probados con PHP 8.2 y Guzzle 7.x.

🔍 Palabras clave:
curl to php convertir curl a php curl php guzzle curl_exec php petición HTTP php curl php ejemplo pasar curl a php

📖 Artículos relacionados

Herramientas

Calculadora de edad online: mucho más que un simple cálculo

Cómo calcular tu edad exacta en días, semanas y horas, saber cuándo es tu próximo cumpleaños y ...

📋 09/05/2026
Herramientas

Cómo calcular el área de un círculo 2026: fórmula, ejemplos y aplicaciones prácticas

Guía completa para calcular el área de un círculo en 2026: fórmula A = π × r², ejemplos detal...

📋 28/02/2026
Herramientas

Codificación Base64 2026: codificar y decodificar en Base64 fácilmente

Guía completa de la codificación Base64: cómo codificar y decodificar texto, archivos e imágenes...

📋 28/01/2026