feat: [CURLRequest] add option for Proxy

[kenjis]

Description

• add request option proxy

Checklist:

• Securely signed commits
• [] Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[datamweb]

I think proxy should be an array that can set CURLOPT_PROXY, CURLOPT_PROXYTYPE , CURLOPT_PROXYPORT and etc.

[kenjis]

It seems Guzzle does not have such options.
https://docs.guzzlephp.org/en/stable/request-options.html#proxy

[ddevsr]

Can flexible option with basic below?

[
    'proxy' => [
        'host' => '127.0.0.1:1337',
        'type' => 'sock5', // sock5 or sock4 or default with CURLPROXY_HTTP
        'auth' => 'user:pass', // or array
    ]
]

[datamweb]

Can flexible option with basic below?

It seems not. Document Guzzle gives an example as below:

$client->request('GET', '/', [
    'proxy' => [
        'http'  => 'http://localhost:8125', // Use this proxy with "http"
        'https' => 'http://localhost:9124', // Use this proxy with "https",
        'no' => ['.mit.edu', 'foo.com']    // Don't use a proxy with these
    ]
]);

However, I think the documents of this PR should clearly indicate how to set these things.

[kenjis]

@ddevsr

This class is modeled after the Guzzle HTTP Client library since it is one of the more widely used libraries. Where possible, the syntax has been kept the same so that if your application needs something a little more powerful than what this library provides, you will have to change very little to move over to use Guzzle.
https://codeigniter4.github.io/CodeIgniter4/libraries/curlrequest.html

I think CURLRequest is a lightweight Guzzle, and if you need more functionality, use Guzzle.
Therefore, we should avoid extensions of our own.

[ddevsr]

Btw dont forget adding note for auth like http://username:[email protected]:10

[jozefrebjak]

@kenjis thanks for this. I really need this as soon as possible in my app.

[kenjis]

@ddevsr If someone needs it, s/he can implement and send a PR.