sanitize_email() WP 1.5.0

Очищає рядок залишає в ньому тільки символи, допустимі в email адресі.

Отримане ім’я ділиться на дві частини до і після @local@domain

  • У “local” допускаються символи:a-z A-Z 0-9 ! # $ % & ' * + / = ? ^ _ ` { | } ~ . -
  • У «domain»a-z 0-9 - .
1 раз – 0.0002048 сек
(швидко) | 50000 разів – 0.25 сек
(дуже швидко) |
PHP 7.4.8, WP 5.6

Хуки з функції

Повертає

Строку. Очищена електронна адреса або порожній рядок, якщо адреса неправильна.

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

$email = sanitize_email($email);
$email
(рядок) (обов’язковий)
Email адреса, яку потрібно очистити.

Приклади

0

#1 Очистимо рядок, який має бути email адресою

$email = "pROverka!#$%&'*+/=?^_`{|}~.---<>©[email protected]";

echo sanitize_email($email);

// Отримаємо: proverka!#$%&'*+/=?^_`{|}[email protected]

список змін

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

Код sanitize_email() WP 6.0.2

function sanitize_email( $email ) {
	// Test for the minimum length the email can be.
	if ( strlen ( $ email ) < 6 ) {
		/**
		 * Filters a sanitized email address.
		 *
		 * Цей filter is evaluated under several contexts, including 'email_too_short',
		 * 'email_no_at', 'local_invalid_chars', 'domain_period_sequence', 'domain_period_limits',
		 * 'domain_no_periods', 'domain_no_valid_subs', або no context.
		 *
		 * @ Since 2.8.0
		 *
		 * @param string $sanitized_email sanitized email address.
		 * @param string $email За адресою електронної пошти, як на sanitize_email().
		 * @param string|null $message Message to pass to the user. null if email is sanitized.
		 */
		return apply_filters( 'sanitize_email', '', $email, 'email_too_short' );
	}

	// Test for an @ character after the first position.
	if ( strpos( $email, '@', 1 ) === false ) {
		/** Цей filter is documented в wp-includes/formatting.php */
		return apply_filters( 'sanitize_email', '', $email, 'email_no_at' );
	}

	// Split out the local and domain parts.
	list ($ local, $ domain) = explode ( '@', $ email, 2);

	// LOCAL PART
	// Test for invalid characters.
	$local = preg_replace( '/[^a-zA-Z0-9!#$%&'*+/=?^_`{|}~.-]/', '', $local );
	if ( '' === $local ) {
		/** Цей filter is documented в wp-includes/formatting.php */
		return apply_filters( 'sanitize_email', '', $email, 'local_invalid_chars' );
	}

	// DOMAIN PART
	// Test for sequences of periods.
	$domain = preg_replace( '/.{2,}/', '', $domain );
	if ( '' === $domain ) {
		/** Цей filter is documented в wp-includes/formatting.php */
		return apply_filters( 'sanitize_email', '', $email, 'domain_period_sequence' );
	}

	// Test for leading and trailing periods and whitespace.
	$domain = trim( $domain, "tnrx0B.");
	if ( '' === $domain ) {
		/** Цей filter is documented в wp-includes/formatting.php */
		return apply_filters( 'sanitize_email', '', $email, 'domain_period_limits' );
	}

	// Split the domain into subs.
	$subs = explode('.', $domain);

	// Assume the domain will have at least two subs.
	if ( 2 > count( $subs ) ) {
		/** Цей filter is documented в wp-includes/formatting.php */
		return apply_filters( 'sanitize_email', '', $email, 'domain_no_periods' );
	}

	// Create an array that will contain valid subs.
	$new_subs = array();

	// Loop through each sub.
	foreach ( $subs as $sub ) {
		// Test for leading and trailing hyphens.
		$sub = trim( $sub, "tnrx0B-");

		// Test for invalid characters.
		$sub = preg_replace( '/[^a-z0-9-]+/i', '', $sub );

		// Якщо є будь-який left, add it до valid subs.
		if ( '' !== $sub ) {
			$new_subs[] = $sub;
		}
	}

	// If there aren't 2 or more valid subs.
	if ( 2 > count( $new_subs ) ) {
		/** Цей filter is documented в wp-includes/formatting.php */
		return apply_filters( 'sanitize_email', '', $email, 'domain_no_valid_subs' );
	}

	// Join valid subs in new domain.
	$domain = implode('.', $new_subs);

	// Put the email back together.
	$sanitized_email = $local. '@'. $domain;

	// Congratulations, your email made it!
	/** Цей filter is documented в wp-includes/formatting.php */
	return apply_filters( 'sanitize_email', $sanitized_email, $email, null);
}