mbstring_binary_safe_encoding( bool $reset = false )

Description

Parameters

$resetbooloptional

Whether to reset the encoding back to a previously-set encoding. Default false.Default: false

Used by · 13

• WP_Filesystem_Direct::put_contents()Writes a string to a file.
• WP_Filesystem_FTPext::put_contents()Writes a string to a file.
• WP_Filesystem_ftpsockets::dirlist()Gets details for files in a directory or a specific file.
• WP_Filesystem_ftpsockets::get_contents()Reads entire file into a string.
• WP_Filesystem_ftpsockets::put_contents()Writes a string to a file.
• WP_Http::request()Send an HTTP request to a URI.
• _unzip_file_pclzip()Attempts to unzip an archive using the PclZip library.
• reset_mbstring_encoding()Resets the mbstring internal encoding to a users previously set encoding.
• seems_utf8()Checks to see if a string is utf8 encoded.
• utf8_uri_encode()Encodes the Unicode values to be used in the URI.
• verify_file_signature()Verifies the contents of a file against its ED25519 signature.
• wp_read_image_metadata()Gets extended image metadata, exif or iptc as available.

Source

View on Trac ↗View on GitHub ↗

7778function mbstring_binary_safe_encoding( $reset = false ) {7779	static $encodings  = array();7780	static $overloaded = null;7781 7782	if ( is_null( $overloaded ) ) {7783		if ( function_exists( 'mb_internal_encoding' )7784			&& ( (int) ini_get( 'mbstring.func_overload' ) & 2 ) // phpcs:ignore PHPCompatibility.IniDirectives.RemovedIniDirectives.mbstring_func_overloadDeprecated7785		) {7786			$overloaded = true;7787		} else {7788			$overloaded = false;7789		}7790	}7791 7792	if ( false === $overloaded ) {7793		return;7794	}7795 7796	if ( ! $reset ) {7797		$encoding = mb_internal_encoding();7798		array_push( $encodings, $encoding );7799		mb_internal_encoding( 'ISO-8859-1' );7800	}7801 7802	if ( $reset && $encodings ) {7803		$encoding = array_pop( $encodings );7804		mb_internal_encoding( $encoding );7805	}7806}

History

Introduced in 3.7.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.