Saltar al contenido

setlocale()

La función de PHP setlocale() establece la información de localización actual para un script. Es útil para adaptar la salida a diferentes idiomas y convenciones culturales.

Sintaxis de PHP de setlocale()

php
string setlocale ( int $category , string $locale [, string ...$locales ] )

La función acepta los siguientes parámetros:

  • $category: Especifica qué categoría de localización se debe establecer. Las constantes comunes incluyen LC_ALL (todas las categorías), LC_COLLATE (comparación de cadenas), LC_CTYPE (clasificación de caracteres) y LC_TIME (formato de fecha/hora).
  • $locale: Especifica la cadena de localización que se aplicará.
  • ...$locales: Opcional. Permite especificar varias cadenas de localización. PHP las probará en orden hasta que una tenga éxito.

Ejemplo de PHP setlocale()

php
<?php
$result = setlocale(LC_ALL, 'en_US.utf8');
if ($result !== false) {
    echo "Locale set successfully to: $result";
} else {
    echo "Failed to set locale.";
}
?>

En este ejemplo, setlocale() intenta establecer la localización en inglés (Estados Unidos) con codificación UTF-8. La función devuelve la nueva cadena de localización en caso de éxito, o false en caso de fallo. Comprobar el valor devuelto garantiza que la localización se aplicó correctamente.

La función setlocale() es una herramienta útil para adaptar scripts de PHP a diferentes idiomas y convenciones culturales. Afecta a varias operaciones, incluidas las comparaciones de cadenas, el formato de números y la salida de fecha/hora.

Práctica

¿Cuál es el propósito de la función setlocale() en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.