Home >Backend Development >PHP Tutorial >PHP4 User Manual: Function-CURL-curl_setopt_PHP Tutorial
TABLE border=0 cellPadding=0 cellSpacing=0 height="100%" width="100%">
(PHP 4 >= 4.0.2)
curl_setopt -- Settings for CURL calls An option
description
bool curl_setopt (int ch, string option, mixed value)
The curl_setopt() function will set options for a CURL session. The option parameter is the setting you want, and value is the value given by this option.
The values of the following options will be used as long integers (specified in the option parameter):
CURLOPT_INFILESIZE: When you upload a file to the remote site, this option tells PHP the size of the file you are uploading.
CURLOPT_VERBOSE: If you want CURL to report every unexpected event, set this option to a non-zero value.
CURLOPT_HEADER: If you want to include a header in the output, set this option to a non-zero value.
CURLOPT_NOPROGRESS: If you do not want PHP to display a progress bar for CURL transfers, set this option to a non-zero value.
Note: PHP automatically sets this option to a non-zero value, you should only change this option for debugging purposes.
CURLOPT_NOBODY: If you do not want to include the body part in the output, set this option to a non-zero value.
CURLOPT_FAILONERROR: If you want PHP not to display when an error occurs (HTTP code return greater than or equal to 300), set this option to a non-zero value. The default behavior is to return a normal page and ignore the code.
CURLOPT_UPLOAD: If you want PHP to prepare for uploading, set this option to a non-zero value.
CURLOPT_POST: If you want PHP to do a regular HTTP POST, set this option to a non-zero value. This POST is of the ordinary application/x-www-from-urlencoded type, mostly used by HTML forms.
CURLOPT_FTPLISTONLY: Set this option to a non-zero value and PHP will list the directory names for FTP.
CURLOPT_FTPAPPEND: Set this option to a non-zero value and PHP will apply the remote file instead of overwriting it.
CURLOPT_NETRC: Set this option to a non-zero value and PHP will look in your ~./netrc file for the username and password of the remote site you want to connect to.
CURLOPT_FOLLOWLOCATION: Set this option to a non-zero header (like "Location: ") and the server will send it as part of the HTTP header (note that this is recursive, PHP will send a header of the form "Location: " head).
CURLOPT_PUT: Set this option to a non-zero value to upload a file using HTTP. To upload this file you must set the CURLOPT_INFILE and CURLOPT_INFILESIZE options.
CURLOPT_MUTE: Set this option to a non-zero value and PHP will be completely silent for the CURL function.
CURLOPT_TIMEOUT: Set a long integer as the maximum number of seconds.