Skip to content

Latest commit

 

History

History
160 lines (102 loc) · 6.6 KB

i18n.md

File metadata and controls

160 lines (102 loc) · 6.6 KB

Internacionalización (i18n) en PHP

La internacionalización (i18n) en PHP es esencial cuando deseas que una aplicación sea accesible para usuarios de diferentes idiomas y regiones. Implementarla de manera efectiva implica varias etapas: detección del idioma o configuración regional del usuario (locale), almacenamiento y manejo de archivos de traducción, y herramientas para gestionar estos elementos.

Detección del locale del usuario

El locale define las preferencias de idioma y formato de cada usuario. En PHP, la detección del locale se puede hacer de varias maneras:

Basado en el navegador: PHP permite detectar el idioma preferido del navegador usando $_SERVER['HTTP_ACCEPT_LANGUAGE']. Este encabezado contiene un listado de idiomas preferidos.

    function detectUserLocale() {
        $lang = substr($_SERVER['HTTP_ACCEPT_LANGUAGE'], 0, 2); // Detecta el idioma principal
        $supportedLanguages = ['en', 'es', 'fr', 'de']; // Idiomas soportados por la app

        // Verifica si el idioma detectado es compatible con los soportados
        if (in_array($lang, $supportedLanguages)) {
            return $lang;
        } else {
            return 'en'; // Idioma predeterminado
        }
    }
    $locale = detectUserLocale();

Basado en la configuración del usuario: Si los usuarios están registrados en la aplicación, puedes almacenar la preferencia de idioma en su perfil. Esto permite recordar el idioma seleccionado cuando el usuario inicia sesión.

Basado en la URL o parámetros: Para sitios multiidioma, un parámetro en la URL (como ?lang=es) o un subdominio (es.tusitio.com) es útil para establecer el idioma y facilita el SEO.

Configuración del locale en PHP

PHP utiliza el sistema de locale para adaptar ciertas funciones, como el formato de fechas, moneda, etc., al idioma del usuario. Esto se configura con la función setlocale():

setlocale(LC_ALL, "es_ES.UTF-8"); // Configura el locale en español de España

Este ajuste es útil para formatos automáticos, pero no traduce el texto de la aplicación. Para eso, debemos emplear archivos de traducción.

Archivos de Traducción y Almacenamiento de Mensajes

Existen varios enfoques para almacenar los textos de traducción en PHP:

Archivos PO y MO (gettext)

PHP tiene soporte para gettext, una biblioteca de internacionalización ampliamente utilizada. Usa archivos .po (Portable Object) para almacenar las traducciones y .mo (Machine Object) para su uso en producción, después de compilarse.

  • Instalación y configuración de gettext: Necesitarás asegurarte de que el servidor tenga soporte para gettext. Puedes verificarlo con phpinfo().

  • Estructura de archivos gettext: Los archivos .po deben tener una estructura de carpetas organizada por idioma.

locales/
├── es_ES/
│   └── LC_MESSAGES/
│       └── messages.po
└── en_US/
    └── LC_MESSAGES/
        └── messages.po

Uso de gettext en PHP:

    putenv("LC_ALL=es_ES.UTF-8"); // Define el locale a usar
    setlocale(LC_ALL, "es_ES.UTF-8");
    bindtextdomain("messages", "./locales"); // Carpeta de localización
    textdomain("messages"); // Archivo de texto a usar

    echo _("Hello, World!"); // Esto buscará la traducción de "Hello, World!" en `messages.po`

Archivos PHP o JSON personalizados

Para aplicaciones ligeras, podrías usar archivos .php o .json como contenedores de traducciones, estructurados en un array clave-valor.

Ejemplo con archivos PHP:

// en.php
return [
    "greeting" => "Hello, World!",
];

// es.php
return [
    "greeting" => "¡Hola, Mundo!",
];

Uso en el código PHP:

$lang = 'es'; // Esto podría venir de la detección de idioma o configuración del usuario
$translations = include "$lang.php";
echo $translations["greeting"];

Herramientas para Gestionar Archivos de Traducción

  • Poedit: Poedit es un editor visual para archivos .po, que facilita la creación y actualización de archivos de traducción.

  • gettext CLI: Para compilar archivos .po en .mo, puedes usar la línea de comandos:

    msgfmt -o locales/es_ES/LC_MESSAGES/messages.mo locales/es_ES/LC_MESSAGES/messages.po

Frameworks de terceros: Algunos frameworks PHP, como Laravel, ofrecen sus propias soluciones de internacionalización con archivos de traducción organizados.

Consideraciones Importantes

Formato de Fechas, Números y Monedas: setlocale ayuda a configurar el formato regional para fechas, monedas y otros datos. Además, la función IntlDateFormatter::format() permite adaptar estos formatos a las preferencias regionales.

// Set up a locale, e.g., English (US)
$locale = 'en_US';

// Define date and time formats
$dateType = IntlDateFormatter::LONG;   // Full date, like "December 31, 2023"
$timeType = IntlDateFormatter::SHORT;  // Short time, like "4:30 PM"

// Optional: Specify a timezone, e.g., "America/New_York"
$timezone = 'America/New_York';

// Create the IntlDateFormatter instance
$dateFormatter = new IntlDateFormatter($locale, $dateType, $timeType, $timezone);

// Define a timestamp or DateTime object to format
$timestamp = time();  // Current timestamp

// Format the timestamp
$formattedDate = $dateFormatter->format($timestamp);

echo $formattedDate;  // Outputs formatted date, e.g., "December 31, 2023, 4:30 PM"

  • RTL y LTR (Dirección de Texto): Para idiomas que se escriben de derecha a izquierda (RTL), como el árabe, deberás ajustar el diseño para reflejar esta diferencia. Los archivos de traducción también pueden incluir variables específicas para estilos de texto.

  • Caché de Traducciones: La carga y procesamiento de archivos de traducción puede afectar el rendimiento. Considera implementar un sistema de caché en memoria (como Memcached o Redis) para almacenar las traducciones.

  • Uso de bibliotecas y frameworks: Aparte de gettext, existen bibliotecas como Symfony Translator que simplifican el proceso de internacionalización en PHP, permitiendo más flexibilidad en el manejo de archivos y soporte para varios formatos de traducción.

Ejemplo Completo de Implementación

Para implementar todas estas partes, aquí tienes un flujo básico:

  • Detecta el idioma del usuario con $_SERVER['HTTP_ACCEPT_LANGUAGE'] o con una configuración manual.
  • Configura el locale y carga las traducciones usando gettext o un archivo PHP personalizado.
  • Integra el sistema de traducción en el flujo de la aplicación y ajusta formatos de fecha y moneda según el locale.

Este flujo asegurará una experiencia adaptada para cada usuario, con traducciones consistentes y formato adecuado para su idioma y región.