About jsonSerialize()

About jsonSerialize()

PHP documentation mentions: Returns data which can be serialized by json_encode()

processObject() should return the result of jsonSerialize() without processing:

private static function processObject(object $data)
{
    if ($data instanceof JsonSerializable) {
        return $data->jsonSerialize();
    }
    ...
}

But this will break BC.

If it is requered to pre-process data for JsonSerializable, this should be done inside jsonSerialize():

class SomeClass implements JsonSerializable
{
    ...
    public function jsonSerialize(): mixed
    {
        return Json:process($this->data);
    }
    ...
}

Read src/Json.php around processObject() and the linked jsonSerialize() implementation, then compare that behavior with PHP's JsonSerializable contract. Trace the existing processing path and its backward-compatibility implications; done means the intended behavior and BC decision are settled and covered for the chosen outcome.