sanitize_key()
Очищає рядок, щоб використовувати його як ключ. Ключі використовуються як різні внутрішні ID.
Видаляє з рядка все окрім a-z0-9_-і переводить рядок у нижній регістр – strtolower() .
1 раз – 0.000013 сек
(дуже швидко) | 50000 разів – 0.04 сек
(швидкість світла)
(дуже швидко) | 50000 разів – 0.04 сек
(швидкість світла)
Хуки з функції
Повертає
Строку. Очищений ключ.
Використання
sanitize_key($key);
- $key
(рядок) (обов’язковий) - Рядок, який буде використовуватися як ключ.
Приклади
#1 Демонстрація очищення ключа
У наведеному нижче коді показано, як sanitize_key() очищає рядок з великими та малими літерами, цифрами, тире, підкресленням, прямою косою межею, дужками, пробілами.
echo sanitize_key( 'Testexample1-_/[]{}' ); // testexample1-_
echo sanitize_key( 'My Key'); // mykey
echo sanitize_key( 'My-Key'); // my-key
echo sanitize_key( 'My_Key' ); // my_keyЯк бачите, ця функція перетворює велику літеру в рядкову, видаляє пряму косу межу, прогалини, дужки та будь-які інші нестандартні символи.
список змін
| З версії 3.0.0 | Введено. |
Код sanitize_key() sanitize key WP 6.0.2
function sanitize_key( $key ) {
$sanitized_key = '';
if ( is_scalar ( $ key ) ) {
$ sanitized_key = strtolower( $key );
$sanitized_key = preg_replace( '/[^a-z0-9_-]/', '', $sanitized_key );
}
/**
* Filters a sanitized key string.
*
* @ Since 3.0.0
*
* @param string $sanitized_key Sanitized key.
* @param string $key Key prior to sanitization.
*/
return apply_filters( 'sanitize_key', $sanitized_key, $key );
}