feat: [CURLRequest] add option for Proxy

system/HTTP/CURLRequest.php

@@ -550,6 +550,12 @@ protected function setCURLOptions(array $curlOptions = [], array $config = [])
             }
         }
 
+        // Proxy
+        if (isset($config['proxy'])) {
+            $curlOptions[CURLOPT_HTTPPROXYTUNNEL] = true;
+            $curlOptions[CURLOPT_PROXY]           = $config['proxy'];
+        }
+
         // Debug
         if ($config['debug']) {
             $curlOptions[CURLOPT_VERBOSE] = 1;

tests/system/HTTP/CURLRequestDoNotShareOptionsTest.php

@@ -559,6 +559,20 @@ public function testSSLWithBadKey()
         ]);
     }
 
+    public function testProxyuOption()
+    {
+        $this->request->request('get', 'http://example.com', [
+            'proxy' => 'http://localhost:3128',
+        ]);
+
+        $options = $this->request->curl_options;
+
+        $this->assertArrayHasKey(CURLOPT_PROXY, $options);
+        $this->assertSame('http://localhost:3128', $options[CURLOPT_PROXY]);
+        $this->assertArrayHasKey(CURLOPT_HTTPPROXYTUNNEL, $options);
+        $this->assertTrue($options[CURLOPT_HTTPPROXYTUNNEL]);
+    }
+
     public function testDebugOptionTrue()
     {
         $this->request->request('get', 'http://example.com', [

tests/system/HTTP/CURLRequestTest.php

@@ -542,6 +542,20 @@ public function testSSLWithBadKey()
         ]);
     }
 
+    public function testProxyuOption()
+    {
+        $this->request->request('get', 'http://example.com', [
+            'proxy' => 'http://localhost:3128',
+        ]);
+
+        $options = $this->request->curl_options;
+
+        $this->assertArrayHasKey(CURLOPT_PROXY, $options);
+        $this->assertSame('http://localhost:3128', $options[CURLOPT_PROXY]);
+        $this->assertArrayHasKey(CURLOPT_HTTPPROXYTUNNEL, $options);
+        $this->assertTrue($options[CURLOPT_HTTPPROXYTUNNEL]);
+    }
+
     public function testDebugOptionTrue()
     {
         $this->request->request('get', 'http://example.com', [

user_guide_src/source/changelogs/v4.4.0.rst

@@ -95,9 +95,10 @@ Libraries
 - **Validation:** Added ``Validation::getValidated()`` method that gets
   the actual validated data. See :ref:`validation-getting-validated-data` for details.
 - **Images:** The option ``$quality`` can now be used to compress WebP images.
-
 - **Uploaded Files:** Added ``UploadedFiles::getClientPath()`` method that returns
   the value of the `full_path` index of the file if it was uploaded via directory upload.
+- **CURLRequest:** Added a request option ``proxy``. See
+  :ref:`CURLRequest Class <curlrequest-request-options-proxy>`.
 
 Helpers and Functions
 =====================

user_guide_src/source/libraries/curlrequest.rst

@@ -296,6 +296,17 @@ has been disabled. Any files that you want to send must be passed as instances o
         ``form_params`` for ``application/x-www-form-urlencoded`` requests, and ``multipart`` for ``multipart/form-data``
         requests.
 
+.. _curlrequest-request-options-proxy:
+
+proxy
+=====
+
+.. versionadded:: 4.4.0
+
+You can set a proxy by passing an associative array as the ``proxy`` option:
+
+.. literalinclude:: curlrequest/035.php
+
 query
 =====
 

user_guide_src/source/libraries/curlrequest/035.php

@@ -0,0 +1,7 @@
+<?php
+
+$client->request(
+    'GET',
+    'http://example.com',
+    ['proxy' => 'http://localhost:3128']
+);