PHP cURL proxy setup, with Guzzle

Steps

1. Confirm the curl extension is loaded

   php -m prints every loaded extension. When curl is absent from that list, install the package for your PHP build or uncomment extension=curl in php.ini, then look again.

   php -m | grep -i curl

2. Point a cURL handle at the proxy

   CURLOPT_PROXY holds http://HOST:PORT and CURLOPT_PROXYUSERPWD holds USERNAME:PASSWORD. The two timeouts cap how long PHP waits to reach the proxy and how long the whole transfer may run. The script echoes the address api.ipify.org saw.

   <?php
   $ch = curl_init('https://api.ipify.org?format=json');
   curl_setopt_array($ch, [
       CURLOPT_PROXY => 'http://HOST:PORT',
       CURLOPT_PROXYUSERPWD => 'USERNAME:PASSWORD',
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_CONNECTTIMEOUT => 10,
       CURLOPT_TIMEOUT => 30,
   ]);
   
   $body = curl_exec($ch);
   if ($body === false) {
       echo 'cURL error ', curl_errno($ch), ': ', curl_error($ch), PHP_EOL;
   } else {
       echo $body, PHP_EOL;
   }

3. Know when CURLOPT_HTTPPROXYTUNNEL matters

   For an https URL, cURL opens a CONNECT tunnel through the proxy by itself, the site’s TLS runs end to end, and this option changes nothing. Setting it to true forces a tunnel for plain http URLs too. Leave it out and those requests reach the proxy as ordinary HTTP, which suits most jobs.

4. Make the same call with Guzzle

   Guzzle reads one proxy URL with the login inside it, while connect_timeout and timeout play the part of the two cURL timeouts. When the password contains @, : or /, run it through rawurlencode before building the URL.

   <?php
   require __DIR__ . '/vendor/autoload.php';
   
   use GuzzleHttp\Client;
   
   $client = new Client([
       'proxy' => 'http://USERNAME:PASSWORD@HOST:PORT',
       'connect_timeout' => 10,
       'timeout' => 30,
   ]);
   
   $response = $client->get('https://api.ipify.org?format=json');
   echo $response->getBody(), PHP_EOL;

5. Take turns across your static IPs

   ISP and datacenter services rent you a set of fixed addresses. Save them in proxies.txt, one per line as HOST:PORT:USERNAME:PASSWORD, and the loop gives each request to the next line along. Replace the repeated ipify URL with the pages you fetch.

   <?php
   $proxies = file('proxies.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
   $urls = array_fill(0, 6, 'https://api.ipify.org');
   
   foreach ($urls as $i => $url) {
       [$host, $port, $user, $pass] = explode(':', trim($proxies[$i % count($proxies)]), 4);
   
       $ch = curl_init($url);
       curl_setopt_array($ch, [
           CURLOPT_PROXY => "$host:$port",
           CURLOPT_PROXYUSERPWD => "$user:$pass",
           CURLOPT_RETURNTRANSFER => true,
           CURLOPT_CONNECTTIMEOUT => 10,
           CURLOPT_TIMEOUT => 30,
       ]);
   
       $body = curl_exec($ch);
       echo $host, ' -> ', $body === false ? curl_error($ch) : $body, PHP_EOL;
   }

Common errors and fixes

Which line to pick

For PHP scrapers and price checks against sites that accept server traffic, datacenter IPs are the low-cost start, and the rotation loop spreads the work over each IP you rent. Move to residential once requests from server ranges get blocked, and choose ISP when one address has to stay signed in for weeks.

Other setup guides

Not sure what a word means? The glossary explains it in plain English.