Better PHP

Ejemplos básicos con curl

Una vez compilado PHP con soporte para cURL, puede empezar a usar las funciones cURL. La idea básica detrás de las funciones cURL es que se inicializa una sesión cURL usando curl_init(), luego pueden definirse todas las opciones para la transferencia con la función curl_setopt(), y finalmente, puede ejecutarse la sesión con curl_exec().

A continuación se muestra un ejemplo sencillo que utiliza las funciones cURL para enviar una petición POST:

Ejemplo #1 Uso del módulo cURL de PHP para enviar una petición POST

<?php
$data = ['foo' => 'bar', 'baz' => 48];
$url = "http://www.example.com/handler.php";

$ch = curl_init($url);

// indicar a CURL que devuelva la respuesta en lugar de enviarla a la salida estándar
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// definir los datos POST, el método correspondiente y las cabeceras
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));

// enviar la petición y obtener la respuesta
$response = curl_exec($ch);

if(curl_error($ch)) {
    // gestionar el error, o simplemente
    throw new RuntimeException(curl_error($ch));
}

Otro ejemplo que utiliza las funciones cURL para enviar una petición POST con JSON en bruto:

Ejemplo #2 Uso del módulo cURL de PHP para enviar una petición POST con JSON

<?php
$post_data = ['foo' => 'bar', 'baz' => 48];
$url = "http://www.example.com/api/endpoint";

$ch = curl_init($url);

// indicar a CURL que devuelva la respuesta en lugar de enviarla a la salida estándar
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// definir los datos POST y el método correspondiente
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));

// definir la cabecera necesaria
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

// enviar la petición y obtener la respuesta
$response = curl_exec($ch);

if(curl_error($ch)) {
    // gestionar el error, o simplemente
    throw new RuntimeException(curl_error($ch));
}

A continuación se muestra otro ejemplo que utiliza las funciones cURL para recuperar la página de inicio del sitio example.com en un fichero:

Ejemplo #3 Uso del módulo cURL para recuperar la página de inicio de example.com

<?php

$ch = curl_init("http://www.example.com/");
$fp = fopen("example_homepage.txt", "w");

curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);

curl_exec($ch);
if(curl_error($ch)) {
    fwrite($fp, curl_error($ch));
}
fclose($fp);

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

Roberto Braga ¶

11 years ago

It is important to notice that when using curl to post form data and you use an array for CURLOPT_POSTFIELDS option, the post will be in multipart format

<?php
$params=['name'=>'John', 'surname'=>'Doe', 'age'=>36];
$defaults = array(
CURLOPT_URL => 'http://myremoteservice/', 
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $params,
);
$ch = curl_init();
curl_setopt_array($ch, ($options + $defaults));
?>
This produce the following post header:

--------------------------fd1c4191862e3566
Content-Disposition: form-data; name="name"

Jhon
--------------------------fd1c4191862e3566
Content-Disposition: form-data; name="surnname"

Doe
--------------------------fd1c4191862e3566
Content-Disposition: form-data; name="age"

36
--------------------------fd1c4191862e3566--

Setting CURLOPT_POSTFIELDS as follow produce a standard post header

CURLOPT_POSTFIELDS => http_build_query($params),

Which is:
name=John&surname=Doe&age=36

This caused me 2 days of debug while interacting with a java service which was sensible to this difference, while the equivalent one in php got both format without problem.

＋add a note