¿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.
Anatomía de un comando cURL
Antes de convertir, conviene entender qué significa cada flag de cURL:
| Opción cURL | Función | Equivalente PHP |
|---|---|---|
-X POST | Método HTTP | CURLOPT_CUSTOMREQUEST |
-H 'Clave: Valor' | Cabecera HTTP | CURLOPT_HTTPHEADER |
-d '{...}' | Cuerpo de la petición | CURLOPT_POSTFIELDS |
-u user:pass | Autenticación Basic | CURLOPT_USERPWD |
-L | Seguir redirecciones | CURLOPT_FOLLOWLOCATION |
-k | Ignorar el certificado SSL | CURLOPT_SSL_VERIFYPEER => false |
--max-time 30 | Timeout en segundos | CURLOPT_TIMEOUT |
-A 'Agent' | User-Agent | CURLOPT_USERAGENT |
-b 'cookie=val' | Cookies | CURLOPT_COOKIE |
--compressed | Descompresión gzip | CURLOPT_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?
| Criterio | cURL nativo | Guzzle | file_get_contents |
|---|---|---|---|
| Dependencias | Extensión cURL de PHP | Composer + paquete | allow_url_fopen |
| API | Verbosa pero completa | Fluida y moderna | Minimalista |
| Asíncrono | No (curl_multi_exec) | Sí (Promises) | No |
| Gestión de errores | Manual | Excepciones automáticas | Básica |
| Middlewares | No | Sí (retry, log, caché...) | No |
| Ideal para | Proyectos sin Composer | Proyectos modernos | Scripts 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:
- Abre las DevTools (F12)
- Ve a la pestaña Red (Network)
- Realiza la acción que lanza la petición
- Haz clic derecho sobre la petición en la lista → Copiar → Copiar como cURL
- 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
Última actualización: marzo de 2026. Ejemplos probados con PHP 8.2 y Guzzle 7.x.