iconv

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

iconv Function synopsis

iconv(
    string $from_encoding,
    string $to_encoding,
    string $string
  ): string|false

Parameters

$from_encoding

Typestring

The current encoding used to interpret $string.

$to_encoding

Typestring

The desired encoding of the result.

$string

Typestring

The string to be converted.

Return value

Typestring|false

Returns the converted string, or false on failure.

Changes to the iconv Function

PHP 8.0

  • Return type added: string|false
  • Parameter name of parameter #1 changed: $in_charset to $from_encoding
  • Parameter type added for parameter #1 ($from_encoding): string
  • Parameter name of parameter #2 changed: $out_charset to $to_encoding
  • Parameter type added for parameter #2 ($to_encoding): string
  • Parameter name of parameter #3 changed: $str to $string
  • Parameter type added for parameter #3 ($string): string
  iconv(
-     $in_charset,
+     string $from_encoding,
-     $out_charset,
+     string $to_encoding,
-     $str
+     string $string
-   )
+   ): string|false

iconv 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