curl_setopt_array - PHP code example

The php Function Curl_Setopt_Array

The php function curl_setopt_array sets options in a cURL transfer session. The function takes an array of options as input, and sets the values for each option in turn. The return value is the cURL resource handle, or FALSE on errors.

PHP 7.6 introduces new cURL options including CURLOPT_FOLLOWLOCATION, CURLOPT_SSL_VERIFYPEER, and CURLOPT_PROXYAUTH. Previously, these options could only be set with the curl_setopt() function. These new cURL options can also be set with the new curl_setopt_array() function, which makes setting multiple options easier.

Using the new cURL options requires PHP to be compiled with libcurl 7.62 or higher. PHP will automatically use the latest version of libcurl if possible, but some operating systems may still need to be updated before the new functions are available.

For example, CURLOPT_FOLLOWLOCATION enables cURL to follow HTTP redirections. This is useful if you need to download files from a server that uses a different URL than the original file.

CURLOPT_COOKIEJAR allows you to specify the name of the cookie file to write, while CURLOPT_GSSNEGOTIATE and CURLOPT_NTLM enable you to set an authentication method that cURL will try to negotiate with the server. You can also set the maximum number of seconds a connection will be allowed to last with the CURLOPT_TIMECONDITION option. If you have a slow internet connection, this option lets you limit the transfer speed that cURL will try to send. If the transfer is below this threshold for too long, a transfer error will be generated.

curl_setopt_array example

$this->applyHandlerOptions($easy, $conf);
        $this->applyHeaders($easy, $conf);
        unset($conf['_headers']);

        // Add handler options from the request configuration options         if (isset($options['curl'])) {
            $conf = \array_replace($conf, $options['curl']);
        }

        $conf[\CURLOPT_HEADERFUNCTION] = $this->createHeaderFn($easy);
        $easy->handle = $this->handles ? \array_pop($this->handles) : \curl_init();
        curl_setopt_array($easy->handle, $conf);

        return $easy;
    }

    public function release(EasyHandle $easy): void
    {
        $resource = $easy->handle;
        unset($easy->handle);

        if (\count($this->handles) >= $this->maxHandles) {
            \curl_close($resource);
        }

/** * Does the actual work of initializing cURL, setting the options, * and grabbing the output. * * @codeCoverageIgnore */
    protected function sendRequest(array $curlOptions = []): string
    {
        $ch = curl_init();

        curl_setopt_array($ch, $curlOptions);

        // Send the request and wait for a response.         $output = curl_exec($ch);

        if ($output === false) {
            throw HTTPException::forCurlError((string) curl_errno($ch), curl_error($ch));
        }

        curl_close($ch);

        return $output;
    }

curl_multi_add_handle($multi->handle, $ch);

        $this->canary = new Canary(static function D) use ($ch, $multi, $id) {
            unset($multi->pauseExpiries[$id], $multi->openHandles[$id], $multi->handlesActivity[$id]);
            curl_setopt($ch, \CURLOPT_PRIVATE, '_0');

            if ($multi->performing) {
                return;
            }

            curl_multi_remove_handle($multi->handle, $ch);
            curl_setopt_array($ch, [
                \CURLOPT_NOPROGRESS => true,
                \CURLOPT_PROGRESSFUNCTION => null,
                \CURLOPT_HEADERFUNCTION => null,
                \CURLOPT_WRITEFUNCTION => null,
                \CURLOPT_READFUNCTION => null,
                \CURLOPT_INFILE => null,
            ]);

            if (!$multi->openHandles) {
                // Schedule DNS cache eviction for the next request                 $multi->dnsCache->evictions = $multi->dnsCache->evictions ?: $multi->dnsCache->removals;