Changeset 25346 for trunk/src/wp-includes/functions.php

Timestamp:

09/11/2013 07:22:05 AM (11 years ago)

Author:

dd32

Message:

Add a set of helpers to turn the behaviour of mbstring.func_overload off when needed. Fixes #25259

File:

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

trunk/src/wp-includes/functions.php

@@ -4131 +4131 @@
     return $charset;
 }
+
+/**
+ * Sets the mbstring internal encoding to a binary safe encoding whne func_overload is enabled.
+ *
+ * When mbstring.func_overload is in use for multi-byte encodings, the results from strlen() and
+ * similar functions respect the utf8 characters, causing binary data to return incorrect lengths.
+ *
+ * This function overrides the mbstring encoding to a binary-safe encoding, and resets it to the
+ * users expected encoding afterwards through the `reset_mbstring_encoding` function.
+ *
+ * It is safe to recursively call this function, however each `mbstring_binary_safe_encoding()`
+ * call must be followed up with an equal number of `reset_mbstring_encoding()` calls.
+ *
+ * @see reset_mbstring_encoding()
+ *
+ * @since 3.7.0
+ *
+ * @param bool $reset Whether to reset the encoding back to a previously-set encoding.
+ */
+function mbstring_binary_safe_encoding( $reset = false ) {
+    static $encodings = array();
+    static $overloaded = null;
+
+    if ( is_null( $overloaded ) )
+        $overloaded = function_exists( 'mb_internal_encoding' ) && ( ini_get( 'mbstring.func_overload' ) & 2 );
+
+    if ( false === $overloaded )
+        return;
+
+    if ( ! $reset ) {
+        $encoding = mb_internal_encoding();
+        array_push( $encodings, $encoding );
+        mb_internal_encoding( 'ISO-8859-1' );
+    }
+
+    if ( $reset && $encodings ) {
+        $encoding = array_pop( $encodings );
+        mb_internal_encoding( $encoding );
+    }
+}
+
+/**
+ * Resets the mbstring internal encoding to a users previously set encoding.
+ *
+ * @see mbstring_binary_safe_encoding()
+ *
+ * @since 3.7.0
+ */
+function reset_mbstring_encoding() {
+    mbstring_binary_safe_encoding( true );
+}