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']
+);

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']
+);

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']
+);

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']
+);

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']
+);

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']
+);

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']
+);

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']
+);