feat: add option to change default behaviour of JSONFormatter max depth

app/Config/Format.php

@@ -61,4 +61,13 @@ class Format extends BaseConfig
         'application/xml'  => 0,
         'text/xml'         => 0,
     ];
+
+    /**
+     * --------------------------------------------------------------------------
+     * JSON Formatters Depth
+     * --------------------------------------------------------------------------
+     *
+     * Additional options to adjust default depth JSON Encode.
+     */
+    public int $jsonDepthOptions = 512;
 }

system/Format/JSONFormatter.php

@@ -41,7 +41,7 @@ public function format($data)
             $options |= JSON_PRETTY_PRINT;
         }
 
-        $result = json_encode($data, $options, 512);
+        $result = json_encode($data, $options, $config->jsonDepthOptions ?? 512);
 
         if (! in_array(json_last_error(), [JSON_ERROR_NONE, JSON_ERROR_RECURSION], true)) {
             throw FormatException::forInvalidJSON(json_last_error_msg());

user_guide_src/source/changelogs/v4.7.0.rst

@@ -85,6 +85,7 @@ Changes
 *******
 
 - **Cookie:** The ``CookieInterface::EXPIRES_FORMAT`` has been changed to ``D, d M Y H:i:s \G\M\T`` to follow the recommended format in RFC 7231.
+- **Format:** The ``Format::$jsonDepthOptions`` options to change default behavior JSON Encode.
 
 ************
 Deprecations

user_guide_src/source/outgoing/api_responses.rst

@@ -49,6 +49,8 @@ format both XML and JSON responses:
 
 .. literalinclude:: api_responses/003.php
 
+.. note:: Since ``v4.7.0``, you can change the default JSON formatting depth by editing **app/Config/Format.php**. The ``$jsonDepthOptions`` value defines the maximum depth, with a default of ``512``.
+
 This is the array that is used during :doc:`Content Negotiation </incoming/content_negotiation>` to determine which
 type of response to return. If no matches are found between what the client requested and what you support, the first
 format in this array is what will be returned.