mb_convert_encoding

Function • Params and return types changed in PHP 8.0

Convert a string from one character encoding to another.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

mb_convert_encoding Function synopsis

mb_convert_encoding(
    array|string $string,
    string $to_encoding,
    array|string|null $from_encoding = null
  ): array|string|false

Parameters

$string

Typearray|string

The string or array to be converted.

$to_encoding

Typestring

The desired encoding of the result.

$from_encoding

OptionalTypearray|string|nullDefault valuenull

The current encoding used to interpret $string. Multiple encodings may be specified as an array or comma separated list, in which case the correct encoding will be guessed using the same algorithm as mb_detect_encoding.

Return value

Typearray|string|false

The encoded string or array on success, or false on failure.

Changes to the mb_convert_encoding Function

PHP 8.0

  • Return type added: array|string|false
  • Parameter name of parameter #1 changed: $str to $string
  • Parameter type added for parameter #1 ($string): array|string
  • Parameter name of parameter #2 changed: $to to $to_encoding
  • Parameter type added for parameter #2 ($to_encoding): string
  • Parameter name of parameter #3 changed: $from to $from_encoding
  • Parameter type added for parameter #3 ($from_encoding): array|string|null
  • Parameter default value added for position #3 ($from_encoding): null
  mb_convert_encoding(
-     $str,
+     array|string $string,
-     $to,
+     string $to_encoding,
-     $from
+     array|string|null $from_encoding = null
-   )
+   ): array|string|false

mb_convert_encoding Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes