Aller au contenu

iconv: module iconv de NGINX

Installation

Vous pouvez installer ce module dans toute distribution basée sur RHEL, y compris, mais sans s'y limiter :

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

Activez le module en ajoutant ce qui suit en haut de /etc/nginx/nginx.conf :

load_module modules/ngx_http_iconv_module.so;

Ce document décrit nginx-module-iconv v0.14 publié le 15 mai 2016.

Description

C'est un module nginx qui utilise libiconv pour convertir des caractères de différents encodages. Il apporte la commande 'set_iconv' à nginx.

Ce module dépend du module ngx_devel_kit (NDK).

Utilisation

set_iconv

syntaxe : set_iconv <destination_variable> <from_variable> from=<from_encoding> to=<to_encoding>

par défaut : aucun

phase : réécriture

iconv_buffer_size

syntaxe : iconv_buffer_size <size>

par défaut : iconv_buffer_size <pagesize>

iconv_filter

syntaxe : iconv_filter from=<from_encoding> to=<to_encoding>

par défaut : aucun

phase : filtre de sortie

Voici un exemple de base :

 #nginx.conf

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

 #tout ce qui est généré depuis /foo sera converti de utf8 à gbk
 location /bar {
     iconv_filter from=utf-8 to=gbk;
     iconv_buffer_size 1k;
     #gestionnaire de contenu ici
 }

Journal des modifications

Les journaux des modifications de ce module font partie des journaux des modifications du bundle OpenResty. Veuillez consulter Voir http://openresty.org/#Changes

Voir aussi

GitHub

Vous pouvez trouver des conseils de configuration supplémentaires et de la documentation pour ce module dans le dépôt GitHub pour nginx-module-iconv.