Changeset 55760 for trunk/src/wp-includes/formatting.php

Timestamp:

05/16/2023 02:16:39 PM (19 months ago)

Author:

audrasjb

Message:

I18N: Introduce sanitization function for locale.

Introduce the sanitize_locale_name() for sanitizing user input of locales.

Props xknown, timothyblynjacobs, ocean90, peterwilsoncc.

File:

• trunk/src/wp-includes/formatting.php (modified) (1 diff)

trunk/src/wp-includes/formatting.php

@@ -2435 +2435 @@
 
 /**
+ * Strips out all characters not allowed in a locale name.
+ *
+ * @since 6.2.1
+ *
+ * @param string $locale_name The locale name to be sanitized.
+ * @return string The sanitized value.
+ */
+function sanitize_locale_name( $locale_name ) {
+    // Limit to A-Z, a-z, 0-9, '_', '-'.
+    $sanitized = preg_replace( '/[^A-Za-z0-9_-]/', '', $locale_name );
+
+    /**
+     * Filters a sanitized locale name string.
+     *
+     * @since 6.2.1
+     *
+     * @param string $sanitized   The sanitized locale name.
+     * @param string $locale_name The locale name before sanitization.
+     */
+    return apply_filters( 'sanitize_locale_name', $sanitized, $locale_name );
+}
+
+/**
  * Converts lone & characters into `&` (a.k.a. `&`)
  *