LL: add class InvalidEncodingException and flag VALIDATE_UTF8_ENCODING

bin/jsonlint

@@ -88,7 +88,7 @@ function getFlags(
     $flags = 0;
     if($allowComments){ $flags |= JsonParser::ALLOW_COMMENTS; }
     if($detectKeyConflicts){ $flags |= JsonParser::DETECT_KEY_CONFLICTS; }
-    // TODO if($validateUTF8Encoding){ $flags |= JsonParser::VALIDATE_UTF8_ENCODING; }
+    if($validateUTF8Encoding){ $flags |= JsonParser::VALIDATE_UTF8_ENCODING; }
     return $flags;
 }
 
@@ -142,6 +142,6 @@ function showUsage($programPath)
     echo '  -h, --help      Show this message'.PHP_EOL;
     echo '  --allow-comments Cause jsonlint to enable syntax for comments similar to JSON5.'.PHP_EOL;
     echo '  --detect-key-conflicts Cause jsonlint to detect key conflicts in objects.'.PHP_EOL;
-    // TODO echo '  --validate-utf8-encoding Cause jsonlint to validate that the whole file is valid UTF-8 encoding.'.PHP_EOL;
+    echo '  --validate-utf8-encoding Cause jsonlint to validate that the whole file is valid UTF-8 encoding.'.PHP_EOL;
     exit(0);
 }

src/Seld/JsonLint/InvalidEncodingException.php

@@ -0,0 +1,50 @@
+<?php
+
+/*
+ * This file is part of the JSON Lint package.
+ *
+ * (c) Jordi Boggiano <j.boggiano@seld.be>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Seld\JsonLint;
+
+/**
+ * @author Laurent Lyaudet <laurent.lyaudet@gmail.com>
+ */
+class InvalidEncodingException extends ParsingException
+{
+    /**
+     * @var array{key: string, line: int}
+     */
+    protected $details;
+
+    /**
+     * @param string $message
+     * @param string $key
+     * @phpstan-param array{line: int} $details
+     */
+    public function __construct($message, $key, array $details)
+    {
+        $details['key'] = $key;
+        parent::__construct($message, $details);
+    }
+
+    /**
+     * @return string
+     */
+    public function getKey()
+    {
+        return $this->details['key'];
+    }
+
+    /**
+     * @phpstan-return array{key: string, line: int}
+     */
+    public function getDetails()
+    {
+        return $this->details;
+    }
+}