PHP8.3에는 새로운 기능이 있습니다! (json_validate 함수 설명)

이 기사에서는 php8.3에 대한 최신 관련 정보를 제공합니다. 주로 PHP8.3에 json_validate라는 함수가 추가된다는 점을 소개합니다. 그것을 사용하는 방법? 함께 살펴보시고, 모두에게 도움이 되었으면 좋겠습니다.

PHP 8.3 미리보기: `json_validate` 함수

PHP 8.3은 수신 문자열이 합법적인 JSON 문자열인지 확인하기 위해 json_validate라는 함수를 추가합니다.

현재 JSON 문자열의 유효성을 검사하는 일반적인 방법은 이를 디코딩하고 예외를 포착하여 확인하는 것입니다. 그러나 어떤 경우에는 특정 콘텐츠를 얻을 필요가 없고 해당 콘텐츠가 합법적인지 확인하기만 하면 됩니다. 새로운 json_validate 함수는 문자열을 디코딩하지 않고 구문 분석만 하기 때문에 json_decode보다 메모리와 리소스를 덜 소비합니다.

함수 서명

/**
 * 验证传入的字符串是否为合法 JSON 字符串
 *
 * @param string $json 准备验证的字符串
 * @param int $depth 最大嵌套深度，必须大于 0
 * @param int $flags 标志掩码，用于指定行为
 * @return bool $json 是合法 JSON 字符串时返回 true，否则返回 false
 */
function json_validate(string $json, int $depth = 512, int $flags = 0): bool {}

Flags Flags

json_validate의 세 번째 매개변수는 함수의 동작을 지정하는 데 사용되는 플래그입니다. 현재 사용 가능한 유일한 플래그는 JSON_INVALID_UTF8_IGNORE입니다.

이 플래그는 PHP 7.2에서 json_decode의 플래그 상수로 추가되었으며 해당 문자열에서 UTF-8 문자를 무시하는 데 사용되었습니다.

json_validate('[1, 2, 3]', flags: JSON_INVALID_UTF8_IGNORE); // true

json_validate("[\"\xc1\xc1\",\"a\"]"); // false
json_validate("[\"\xc1\xc1\",\"a\"]", flags: JSON_INVALID_UTF8_IGNORE); // true

오류 처리

json_validate 자체는 오류 코드를 반환하지 않습니다. 특정 오류 정보를 얻으려면 json_last_error 및 json_last_error_msg를 사용하면 됩니다.

json_validate(""); // false

json_last_error(); // 4
json_last_error_msg(); // "Syntax error"

json_validate("null"); // true

json_last_error(); // 0
json_last_error_msg(); // "No error"

예

문자열을 확인하고 예외를 발생시킵니다

if (json_validate($_GET['json']) === false) {
    throw new \JsonException(json_last_error_msg(), json_last_error());
}

이전 확인 방법을 교체합니다

- $value = json_decode($_GET['json'], flags: JSON_THROW_ON_ERROR);
+ if (!json_validate($_GET['json'])) {
+   throw new \JsonException(json_last_error_msg(), json_last_error());
+ }
+ $value = json_decode($_GET['json']);

Polyfill 선제적 적응

PHP 8.3에 미리 적응하고 싶다면 , 원활하게 8.3이 출시되자마자 json_validate로 전환하면 이전 버전의 json_validate 효과를 모방하는 함수를 수동으로 정의할 수 있습니다.

if (!function_exists('json_validate')) {  
  function json_validate(string $json, int $depth = 512, int $flags = 0): bool {  
  if ($flags !== 0 && $flags !== \JSON_INVALID_UTF8_IGNORE) {  
  throw new \ValueError('json_validate(): Argument #3 ($flags) must be a valid flag (allowed flags: JSON_INVALID_UTF8_IGNORE)');  
  }  
  if ($depth <= 0 ) {  
  throw new \ValueError(&#39;json_validate(): Argument #2 ($depth) must be greater than 0&#39;);  
  }  
  \json_decode($json, null, $depth, $flags);  
  return \json_last_error() === \JSON_ERROR_NONE;  
  }  
}

이 함수는 여전히 내부적으로 json_decode를 사용하기 때문에 실제로 성능 향상은 없고 json_validate와 유사한 인터페이스만 제공합니다.

추천 학습: "PHP 비디오 튜토리얼"

위 내용은 PHP8.3에는 새로운 기능이 있습니다! (json_validate 함수 설명)의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!