Documentación offline PHP master

mb_convert_encoding

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

mb_convert_encoding

Convertir una cadena de un codificación de caracteres a otra

Descripción#

mb_convert_encoding(array $string, string $to_encoding, [array $from_encoding]): array
```php

Convierte la `string` desde `from_encoding`, o la codificación interna actual, a `to_encoding`. Opcionalmente desde `from_encoding`. Si `string` es un `array`, todos sus valores `string` serán convertidos recursivamente.

## Parámetros

`string`  
La `string` o `array` a convertir.

`to_encoding`  
La codificación deseada del resultado.

`from_encoding`  
La codificación actual utilizada para interpretar la `string`. Múltiples codificaciones pueden ser especificadas en forma de array (`array`) o lista separada por comas. En este caso, la codificación correcta será adivinada utilizando el mismo algoritmo que `mb_detect_encoding`.

Si `from_encoding` es omitido o `null`, el parámetro [mbstring.internal_encoding](#ini.mbstring.internal-encoding) será utilizado si está definido, de lo contrario el parámetro [default_charset](#ini.default-charset) será utilizado.

Ver [codificaciones soportadas](#mbstring.supported-encodings) para los valores válidos de `to_encoding` y `from_encoding`.

## Valores devueltos

La `string` o `array` codificado en caso de éxito, o `false` si ocurre un error.

## Errores/Excepciones

A partir de PHP 8.0.0, una `ValueError` es lanzada si la valor de `to_encoding` o `from_encoding` es una codificación inválida. Anterior a PHP 8.0.0, una `E_WARNING` era emitida en su lugar.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.2.0 | `mb_convert_encoding` ya no devolverá las siguientes codificaciones no textuales: `"Base64"`, `"QPrint"`, `"UUencode"`, `"HTML entities"`, `"7 bit"` y `"8 bit"`. |
| 8.0.0 | `mb_convert_encoding` lanzará ahora una `ValueError` cuando `to_encoding` es pasado una codificación inválida. |
| 8.0.0 | `mb_convert_encoding` lanzará ahora una `ValueError` cuando `from_encoding` es pasado una codificación inválida. |
| 8.0.0 | `from_encoding` ahora es nullable. |
| 7.2.0 | Esta función ahora acepta un `array` como `string`. Anteriormente, solo las `string` eran soportadas. |

## Ejemplos

Ejemplo con `mb_convert_encoding`

```php

Véase también#

mb_detect_order, UConverter::transcode, iconv