curl_multi_setopt - PHP code example

Using the PHP Function Curl_Multi_Setopt

PHP has built-in functions for performing common programming tasks. These functions allow you to get things done without having to write a bunch of complicated code. Whether you need to download files, create an image, or even check if a website is up and running, these functions do the trick.

One of the most useful PHP cURL functions is curl_multi_setopt. This function lets you set options for multiple cURL requests at the same time. It can be very helpful when you're transferring large amounts of data and want to minimize the amount of time it takes for your web app to finish downloading or uploading.

This function accepts two arguments: a normal cURL handle and the cURL options that you want to apply. You can specify the number of requests that you want to make, as well as the maximum transfer speed that you'll allow for each request. You can also choose to close all the cURL connections after the final request is finished.

If you're using this function to transfer large amounts of data, you should use a script execution timeout limit to prevent your program from running out of memory. You can also specify a default transfer rate to be used for all the cURL transfers.

Another option that you can use with this function is the cURLOPT_NOBODY option, which prevents the transfer of body information for the HTTP response. This is a good option to use when you're transferring HTML documents and other formats.

curl_multi_setopt example

$multiHandle = \curl_multi_init();

        if (false === $multiHandle) {
            throw new \RuntimeException('Can not initialize curl multi handle.');
        }

        $this->_mh = $multiHandle;

        foreach ($this->options as $option => $value) {
            // A warning is raised in case of a wrong option.             curl_multi_setopt($this->_mh, $option, $value);
        }

        return $this->_mh;
    }

    public function __destruct()
    {
        if (isset($this->_mh)) {
            \curl_multi_close($this->_mh);
            unset($this->_mh);
        }
    }

public function __construct(int $maxHostConnections, int $maxPendingPushes)
    {
        self::$curlVersion ??= curl_version();

        $this->handle = curl_multi_init();
        $this->dnsCache = new DnsCache();
        $this->reset();

        // Don't enable HTTP/1.1 pipelining: it forces responses to be sent in order         if (\defined('CURLPIPE_MULTIPLEX')) {
            curl_multi_setopt($this->handle, \CURLMOPT_PIPELINING, \CURLPIPE_MULTIPLEX);
        }
        if (\defined('CURLMOPT_MAX_HOST_CONNECTIONS')) {
            $maxHostConnections = curl_multi_setopt($this->handle, \CURLMOPT_MAX_HOST_CONNECTIONS, 0 < $maxHostConnections ? $maxHostConnections : \PHP_INT_MAX) ? 0 : $maxHostConnections;
        }
        if (\defined('CURLMOPT_MAXCONNECTS') && 0 < $maxHostConnections) {
            curl_multi_setopt($this->handle, \CURLMOPT_MAXCONNECTS, $maxHostConnections);
        }

        // Skip configuring HTTP/2 push when it's unsupported or buggy, see https://bugs.php.net/77535         if (0 >= $maxPendingPushes) {
            return;
        }