wp_check_invalid_utf8() │ WP 2.8.0

Перевіряє наявність неприпустимих символів UTF8 у рядку.

Функція нічого не робить, якщо опція get_option( 'blog_charset' )не дорівнює одному з utf8, utf-8, UTF8, UTF-8.

Для тестів є спеціальний текст із неприпустимими UTF-8 символами . У ньому приклади багатьох порушень UTF-8, включаючи поодинокі початкові байти, пропущені байти продовження, надмірно довгі послідовності і т.д.

Основа для:
sanitize_text_field() ,
Хуків немає.

Повертає

Строку. Провірений текст.

Використання

wp_check_invalid_utf8( $string, $strip );
$string
(рядок) (обов’язковий)
Текст, який має бути перевірено.
$strip
(true/false)
Чи слід намагатися видалити символи UTF-8.


Типово: false

Приклади

0

#1 Перевірка роботи функції

$examples = [
	'Valid ASCII' => "a",
	'Valid 2 Octet Sequence' => "xc3xb1",
	'Valid 3 Octet Sequence' => "xe2x82xa1",
	'Valid 4 Octet Sequence' => "xx0x90x8cxbc",
	'Valid 5 Octet Sequence (але не Unicode!)' => "xf8xa1xa1xa1xa1",
	'Valid 6 Octet Sequence (але не Unicode!)' => "xfcxa1xa1xa1xa1xa1",
	'Invalid 2 Octet Sequence' => "xc3x28",
	'Invalid Sequence Identifier' => "xa0xa1",
	'Invalid 3 Octet Sequence (in 2nd Octet)' => "xe2x28xa1",
	'Invalid 3 Octet Sequence (in 3rd Octet)' => "xe2x82x28",
	'Invalid 4 Octet Sequence (in 2nd Octet)' => "xf0x28x8cxbc",
	'Invalid 4 Octet Sequence (in 3rd Octet)' => "xx0x90x28xbc",
	'Invalid 4 Octet Sequence (in 4th Octet)' => "xf0x28x8cx28",
];

$result = [];

foreach ( $examples as $key => $value ) {
	$result[ $key ] = wp_check_invalid_utf8( $value );
}

var_dump($result);

Результат:

array(13) {
  ["Valid ASCII"]=> string(1) "a"
  ["Valid 2 Octet Sequence"]=> string(2) "ñ"
  ["Valid 3 Octet Sequence"]=> string(3) "₡"
  ["Valid 4 Octet Sequence"]=> string(4) "????"
  ["Valid 5 Octet Sequence (але не Unicode!)"]=> string(0) ""
  ["Valid 6 Octet Sequence (але не Unicode!)"]=> string(0) ""
  ["Invalid 2 Octet Sequence"]=> string(0) ""
  ["Invalid Sequence Identifier"]=> string(0) ""
  ["Invalid 3 Octet Sequence (in 2nd Octet)"]=> string(0) ""
  ["Invalid 3 Octet Sequence (in 3rd Octet)"]=> string(0) ""
  ["Invalid 4 Octet Sequence (in 2nd Octet)"]=> string(0) ""
  ["Invalid 4 Octet Sequence (in 3rd Octet)"]=> string(0) ""
  ["Invalid 4 Octet Sequence (in 4th Octet)"]=> string(0) ""
}

список змін

З версії 2.8.0Введено.

Код wp_check_invalid_utf8() WP 6.0.2

wp-includes/formatting.php 
function wp_check_invalid_utf8( $string, $strip = false ) {
	$string = (string) $string;

	if ( 0 === strlen( $string ) ) {
		return '';
	}

	// Store site charset як static до avoid multiple calls to get_option().
	static $is_utf8 = null;
	if ( ! isset( $is_utf8 ) ) {
		$is_utf8 = in_array( get_option( 'blog_charset' ), array( 'utf8', 'utf-8', 'UTF8', 'UTF-8' ), true );
	}
	if ( ! $is_utf8 ) {
		return $string;
	}

	// Check for support for utf8 ininstalled PCRE library once and store the result in a static.
	static $utf8_pcre = null;
	if ( ! isset( $utf8_pcre ) ) {
		// phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged
		$utf8_pcre = @preg_match( '/^./u', 'a' );
	}
	// Ви не можете дати utf8 в PCRE installation, якщо тільки перевірити string в цих випадках.
	if ( ! $utf8_pcre ) {
		return $string;
	}

	// phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- preg_match fails when it encounters invalid UTF8 в $string.
	if ( 1 === @preg_match( '/^./us', $string ) ) {
		return $string;
	}

	// Attempt to strip bad chars if requested (не recommended).
	if ( $strip && function_exists( 'iconv' ) ) {
		return iconv('utf-8', 'utf-8', $string);
	}

	return '';
}

Очищення перевірка (sanitize_check)

Очищення даних