package and depencies

vendor/symfony/http-foundation/JsonResponse.php

@@ -34,12 +34,9 @@ class JsonResponse extends Response
     protected $encodingOptions = self::DEFAULT_ENCODING_OPTIONS;
 
     /**
-     * @param mixed $data    The response data
-     * @param int   $status  The response status code
-     * @param array $headers An array of response headers
-     * @param bool  $json    If the data is already a JSON string
+     * @param bool $json If the data is already a JSON string
      */
-    public function __construct($data = null, int $status = 200, array $headers = [], bool $json = false)
+    public function __construct(mixed $data = null, int $status = 200, array $headers = [], bool $json = false)
     {
         parent::__construct('', $status, $headers);
 
@@ -47,36 +44,11 @@ class JsonResponse extends Response
             throw new \TypeError(sprintf('"%s": If $json is set to true, argument $data must be a string or object implementing __toString(), "%s" given.', __METHOD__, get_debug_type($data)));
         }
 
-        if (null === $data) {
-            $data = new \ArrayObject();
-        }
+        $data ??= new \ArrayObject();
 
         $json ? $this->setJson($data) : $this->setData($data);
     }
 
-    /**
-     * Factory method for chainability.
-     *
-     * Example:
-     *
-     *     return JsonResponse::create(['key' => 'value'])
-     *         ->setSharedMaxAge(300);
-     *
-     * @param mixed $data    The JSON response data
-     * @param int   $status  The response status code
-     * @param array $headers An array of response headers
-     *
-     * @return static
-     *
-     * @deprecated since Symfony 5.1, use __construct() instead.
-     */
-    public static function create($data = null, int $status = 200, array $headers = [])
-    {
-        trigger_deprecation('symfony/http-foundation', '5.1', 'The "%s()" method is deprecated, use "new %s()" instead.', __METHOD__, static::class);
-
-        return new static($data, $status, $headers);
-    }
-
     /**
      * Factory method for chainability.
      *
@@ -86,12 +58,10 @@ class JsonResponse extends Response
      *         ->setSharedMaxAge(300);
      *
      * @param string $data    The JSON response string
-     * @param int    $status  The response status code
+     * @param int    $status  The response status code (200 "OK" by default)
      * @param array  $headers An array of response headers
-     *
-     * @return static
      */
-    public static function fromJsonString(string $data, int $status = 200, array $headers = [])
+    public static function fromJsonString(string $data, int $status = 200, array $headers = []): static
     {
         return new static($data, $status, $headers, true);
     }
@@ -105,8 +75,11 @@ class JsonResponse extends Response
      *
      * @throws \InvalidArgumentException When the callback name is not valid
      */
-    public function setCallback(string $callback = null)
+    public function setCallback(string $callback = null): static
     {
+        if (1 > \func_num_args()) {
+            trigger_deprecation('symfony/http-foundation', '6.2', 'Calling "%s()" without any arguments is deprecated, pass null explicitly instead.', __METHOD__);
+        }
         if (null !== $callback) {
             // partially taken from https://geekality.net/2011/08/03/valid-javascript-identifier/
             // partially taken from https://github.com/willdurand/JsonpCallbackValidator
@@ -136,7 +109,7 @@ class JsonResponse extends Response
      *
      * @return $this
      */
-    public function setJson(string $json)
+    public function setJson(string $json): static
     {
         $this->data = $json;
 
@@ -146,24 +119,22 @@ class JsonResponse extends Response
     /**
      * Sets the data to be sent as JSON.
      *
-     * @param mixed $data
-     *
      * @return $this
      *
      * @throws \InvalidArgumentException
      */
-    public function setData($data = [])
+    public function setData(mixed $data = []): static
     {
         try {
             $data = json_encode($data, $this->encodingOptions);
         } catch (\Exception $e) {
-            if ('Exception' === \get_class($e) && str_starts_with($e->getMessage(), 'Failed calling ')) {
+            if ('Exception' === $e::class && str_starts_with($e->getMessage(), 'Failed calling ')) {
                 throw $e->getPrevious() ?: $e;
             }
             throw $e;
         }
 
-        if (\PHP_VERSION_ID >= 70300 && (\JSON_THROW_ON_ERROR & $this->encodingOptions)) {
+        if (\JSON_THROW_ON_ERROR & $this->encodingOptions) {
             return $this->setJson($data);
         }
 
@@ -176,10 +147,8 @@ class JsonResponse extends Response
 
     /**
      * Returns options used while encoding data to JSON.
-     *
-     * @return int
      */
-    public function getEncodingOptions()
+    public function getEncodingOptions(): int
     {
         return $this->encodingOptions;
     }
@@ -189,7 +158,7 @@ class JsonResponse extends Response
      *
      * @return $this
      */
-    public function setEncodingOptions(int $encodingOptions)
+    public function setEncodingOptions(int $encodingOptions): static
     {
         $this->encodingOptions = $encodingOptions;
 
@@ -201,7 +170,7 @@ class JsonResponse extends Response
      *
      * @return $this
      */
-    protected function update()
+    protected function update(): static
     {
         if (null !== $this->callback) {
             // Not using application/javascript for compatibility reasons with older browsers.