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);