Saltar a contenido

iconv: Módulo iconv de NGINX

Instalación

Puedes instalar este módulo en cualquier distribución basada en RHEL, incluyendo, pero no limitado a:

  • RedHat Enterprise Linux 7, 8, 9 y 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 y Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-iconv

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-iconv

Habilita el módulo añadiendo lo siguiente en la parte superior de /etc/nginx/nginx.conf:

load_module modules/ngx_http_iconv_module.so;

Este documento describe nginx-module-iconv v0.14 lanzado el 15 de mayo de 2016.

Descripción

Este es un módulo de nginx que utiliza libiconv para convertir caracteres de diferentes codificaciones. Trae el comando 'set_iconv' a nginx.

Este módulo depende del módulo ngx_devel_kit (NDK).

Uso

set_iconv

sintaxis: set_iconv <variable_destino> <variable_origen> from=<codificación_origen> to=<codificación_destino>

por defecto: ninguno

fase: reescritura

iconv_buffer_size

sintaxis: iconv_buffer_size <tamaño>

por defecto: iconv_buffer_size <pagesize>

iconv_filter

sintaxis: iconv_filter from=<codificación_origen> to=<codificación_destino>

por defecto: ninguno

fase: filtro_de_salida

Aquí hay un ejemplo básico:

 #nginx.conf

 location /foo {
     set $src '你好'; #en UTF-8
     set_iconv $dst $src from=utf8 to=gbk; #ahora $dst contiene 你好 en GBK
 }

 #todo lo generado desde /foo será convertido de utf8 a gbk
 location /bar {
     iconv_filter from=utf-8 to=gbk;
     iconv_buffer_size 1k;
     #manejador de contenido aquí
 }

Registro de cambios

Los registros de cambios de este módulo son parte de los registros de cambios del paquete OpenResty. Por favor, consulta http://openresty.org/#Changes

Véase También

GitHub

Puedes encontrar consejos de configuración adicionales y documentación para este módulo en el repositorio de GitHub para nginx-module-iconv.