Add a curl example in PHP example section

[cuu508]

Suggested here: https://twitter.com/smknstd/status/1272818956076810247

Aside from the code sample, it will need some accompanying information–

• is curl support typically built in with PHP, or does it need to be installed / enabled separately?
• in the "20 retries, 5 second timeouts" example, what is the maximum amount of time it can use up?
• is there a risk of curl code throwing exceptions? Should the snippet perhaps be wrapped in try..catch?

I'm very out of touch of today's PHP, so would appreciate any help.

[SuperSandro2000]

is curl support typically built in with PHP, or does it need to be installed / enabled separately?

curl is a very common used php module but not installed when you install php on Debian.

in the "20 retries, 5 second timeouts" example, what is the maximum amount of time it can use up?

my uneducated guess would around about a minute.

is there a risk of curl code throwing exceptions? Should the snippet perhaps be wrapped in try..catch?

Nope but it could fail to connect in the same ways curl could which is not checked by this code.

https://stackoverflow.com/a/11297495/4446318

[smknstd]

There is a php-curl module (https://www.php.net/manual/en/book.curl.php) but my example use a complete different library: https://github.com/php-curl-class/php-curl-class that looked convenient to me (install through composer + retry option).

is there a risk of curl code throwing exceptions?

no the library chose a different pattern php-curl-class/php-curl-class#403

What I was trying to say by "updating the doc", was not something specific to php but maybe a section on those options (timeout + retry) in general. Then each langage specific page could give insight on how to do it. It could be great to mention multiple solutions, for php I'd keep mentionning "file_get_contents" but adding "curl" + options

[smknstd]

If you need snippet :

use Curl\Curl;

$curl = new Curl();
$curl->setRetry(20);
$curl->setTimeout(5);
$curl->get('https://hc-ping.com/your-uuid-here');     

[cuu508]

What I was trying to say by "updating the doc", was not something specific to php but maybe a section on those options (timeout + retry) in general. Then each langage specific page could give insight on how to do it.

That's a good idea! I've started work on the general page. Current version live here: https://healthchecks.io/docs/reliability_tips/

I'm confident I can also update Python examples, but for other languages help is very welcome.

[smknstd]

the new page is great. Tried to update the php example here #395, hope it will help ...

[cuu508]

@smknstd thanks for the PR, looks good!

I noticed just now that PHP samples have no syntax highlighting. Related issue: Python-Markdown/markdown#334 I will keep an eye on python-markdown releases.