Php/docs/function.curl-exec
curl_exec
(PHP 4 >= 4.0.2, PHP 5, PHP 7)
curl_exec — 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.
Return Values
Returns TRUE
on success or FALSE
on failure. However, if the CURLOPT_RETURNTRANSFER
option is set, it will return
the result on success, FALSE
on failure.
Warning
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.
Changelog
Version | Description |
---|---|
8.0.0 | handle expects a CurlHandle
instance now; previously, a resource was expected. |
Examples
Example #1 Fetching a web page
<?php// create a new cURL resource$ch = curl_init();// set URL and other appropriate optionscurl_setopt($ch, CURLOPT_URL, "http://www.example.com/%22);curl_setopt($ch, CURLOPT_HEADER, 0);// grab URL and pass it to the browsercurl_exec($ch);// close cURL resource, and free up system resourcescurl_close($ch);?>