(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
curl_exec — Perform a cURL session
Execute the given cURL session.
This function should be called after initializing a cURL session and all the options for the session are set.
On success, this function flushes the result directly to the
stdout and returns true, or false on failure.
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.
This function may
return Boolean false, but may also return a non-Boolean value which
evaluates to false. Please read the section on Booleans for more
information. Use the ===
operator for testing the return value of this
function.
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.
| Version | Description |
|---|---|
| 8.0.0 |
handle expects a CurlHandle
instance now; previously, a resource was expected.
|
Example #1 Fetching a web page
<?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);
?>