Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:122384
Message-ID: <0bd0a588-eb4c-4ea6-bc6f-837a38427f81@gmail.com>
Date: Thu, 15 Feb 2024 12:21:12 +0100
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: [PHP-DEV] Re: [RFC] OOP API for cURL extension
Content-Language: en-US
To: PHP internals <internals@lists.php.net>
References: <CAESVnVp11-EVBrhzSj16=Nd3fYE366piq6fG-9wV3+iH8TxchA@mail.gmail.com>
In-Reply-To: <CAESVnVp11-EVBrhzSj16=Nd3fYE366piq6fG-9wV3+iH8TxchA@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
From: dik.takken@gmail.com (Dik Takken)

On 14-02-2024 19:47, Sara Golemon wrote:
> Good afternoon folks, I'd like to open discussion on adding OOP APIs to the
> cURL extension.
> https://wiki.php.net/rfc/curl-oop
> 
> This has been a long standing bug-bear of mine, and I think its time has
> come.
> 
> try {
>    (new \CurlHandle)->setOpt(YOUR_VOTE, true)->exec();
> } catch (\CurlHandleException $ex) {
>    assert(false); // Why not?!
> }
> 
> -Sara
> 

I love the idea of an OOP API. Personally I use Python's Requests 
library a lot, it could offer some inspiration. I would really like to 
simply write:

     Curl::get('https://...', params: ['key' => 'value'])->json()
     Curl::post(...)
     ...

Some more specific exceptions may be nice too, to easily differentiate 
between errors you might want to retry (network errors) and programming 
errors.

Regards,
Dik