PHP Conference Nagoya 2025

mb_encoding_aliases

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

mb_encoding_aliasesGet aliases of a known encoding type

Description

mb_encoding_aliases(string $encoding): array

Returns an array of aliases for a known encoding type.

Parameters

encoding

The encoding type being checked, for aliases.

Return Values

Returns a numerically indexed array of encoding aliases.

Errors/Exceptions

Throws a ValueError if encoding is unknown.

Changelog

Version Description
8.0.0 If the encoding is unknown, a ValueError is now thrown; previously an E_WARNING was emitted, and the function returned false.

Examples

Example #1 mb_encoding_aliases() example

<?php
$encoding
= 'ASCII';
$known_encodings = mb_list_encodings();

if (
in_array($encoding, $known_encodings)) {

$aliases = mb_encoding_aliases($encoding);
print_r($aliases);

} else {

echo
"Unknown ($encoding) encoding.\n";

}
?>

The above example will output something similar to:

Array
(
    [0] => ANSI_X3.4-1968
    [1] => iso-ir-6
    [2] => ANSI_X3.4-1986
    [3] => ISO_646.irv:1991
    [4] => US-ASCII
    [5] => ISO646-US
    [6] => us
    [7] => IBM367
    [8] => cp367
    [9] => csASCII
)

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top