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