[RFC]: Add a ResultData object as Result data

RFC

Q	A
Proposed Version(s)	1.x.x
BC Break?	Yes/No/Maybe

Goal

Provide a structured class to use when providing extra details about a executed check.

Background

I'm looking into using this package to generate an API health endpoint, for that we'd need more data besides the fact that a check was successful. In previous PRs I already added some data to some checks, but got a review point to see if we can make this more structured/typed.

The idea is to add a ResultData object so Checks can provide extra data in a set format.

Considerations

Big question is, are the current Check's data returns covered by BC? DiskUsage::check()->getData is now always an int, even though it's typed to mixed|null.

If we were to have a class available, these checks couldn't just switch over. Otherwise users of this package, who currently assume it's an int, will suddenly get something else.

Proposal(s)

Add a new ResultData object into Laminas\Diagnostics\Result, or Laminas\Diagnostics\Result\Data. Preferably not simply key + value, but:

key (uptime / responseTime / connections / utilization)
value
valueType (second, milisecond, percentage)

Quick proposal:

$data = new ResultData();
$data->addDetail(uptime, 500, seconds);

return new Success("Connected successfully", $data);

Appendix

I got this as review point in a previous PR: https://github.com/laminas/laminas-diagnostics/pull/57#discussion_r1020012800. The PR was merged already (thanks for that), but I didn't want to 'forget about it'.

laminas / laminas-diagnostics