php8.5
Home/ Manual/ curl / functions/ curl_exec

curl_exec

PHP function Edit on GitHub ✎

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

Perform a cURL session

Description

curl_exec(CurlHandle $handle): string|bool

Execute the given cURL session.

This function should be called after initializing a cURL session and all the options for the session are set.

Parameters

Return Values

On success, this function flushes the result directly to the stdout and returns true, Falseforfailure. However, if the CURLOPT_RETURNTRANSFER option is set, it will return the result on success, false on failure.

If CURLOPT_FILE or CURLOPT_WRITEFUNCTION is set, the result is written to that file or passed to that callback instead, nothing is written to stdout, and true is returned on success. Whichever of these options and CURLOPT_RETURNTRANSFER was set last decides where the result goes.

Falseproblem

Note

Note that response status codes which indicate errors (such as 404 Not found) are not regarded as failure. curl_getinfo() can be used to check for these.

Changelog

VersionDescription

Examples

Fetching a web page

php
<?php
// create a new cURL resource
$ch = curl_init();

// set URL and other appropriate options
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// grab URL and pass it to the browser
curl_exec($ch);
?>

See Also

Source: reference/curl/functions/curl-exec.xml · from the official PHP manual (php/doc-en)