Pular para conteúdo

iconv: Módulo iconv do NGINX

Instalação

Você pode instalar este módulo em qualquer distribuição baseada em RHEL, incluindo, mas não se limitando a:

  • RedHat Enterprise Linux 7, 8, 9 e 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 e 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

Ative o módulo adicionando o seguinte no topo de /etc/nginx/nginx.conf:

load_module modules/ngx_http_iconv_module.so;

Este documento descreve o nginx-module-iconv v0.14 lançado em 15 de maio de 2016.

Descrição

Este é um módulo do nginx que usa libiconv para converter caracteres de diferentes codificações. Ele traz o comando 'set_iconv' para o nginx.

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

Uso

set_iconv

sintaxe: set_iconv <variável_destino> <variável_origem> from=<codificação_origem> to=<codificação_destino>

padrão: nenhum

fase: rewrite

iconv_buffer_size

sintaxe: iconv_buffer_size <tamanho>

padrão: iconv_buffer_size <pagesize>

iconv_filter

sintaxe: iconv_filter from=<codificação_origem> to=<codificação_destino>

padrão: nenhum

fase: output-filter

Aqui está um exemplo básico:

 #nginx.conf

 location /foo {
     set $src '你好'; #em UTF-8
     set_iconv $dst $src from=utf8 to=gbk; #agora $dst contém 你好 em GBK
 }

 #tudo gerado de /foo será convertido de utf8 para gbk
 location /bar {
     iconv_filter from=utf-8 to=gbk;
     iconv_buffer_size 1k;
     #manipulador de conteúdo aqui
 }

Changelog

Os registros de alterações deste módulo fazem parte dos registros de alterações do pacote OpenResty. Por favor, veja Veja http://openresty.org/#Changes

Veja Também

GitHub

Você pode encontrar dicas adicionais de configuração e documentação para este módulo no repositório do GitHub para nginx-module-iconv.