Перейти к содержанию

iconv: Модуль iconv для NGINX

Установка в Debian/Ubuntu

Эти документы относятся к APT пакету nginx-module-iconv, предоставляемому репозиторием GetPageSpeed Extras.

  1. Настройте APT репозиторий, как описано в настройке APT репозитория.
  2. Установите модуль:
sudo apt-get update
sudo apt-get install nginx-module-iconv
Показать дистрибутивы и архитектуры 
| Дистрибутив | Сuite             | Компонент   | Архитектуры   |
|-------------|-------------------|-------------|-----------------|
| debian      | bookworm          | main        | amd64, arm64    |
| debian      | bookworm-mainline | main        | amd64, arm64    |
| debian      | trixie            | main        | amd64, arm64    |
| debian      | trixie-mainline   | main        | amd64, arm64    |
| ubuntu      | focal             | main        | amd64, arm64    |
| ubuntu      | focal-mainline    | main        | amd64, arm64    |
| ubuntu      | jammy             | main        | amd64, arm64    |
| ubuntu      | jammy-mainline    | main        | amd64, arm64    |
| ubuntu      | noble             | main        | amd64, arm64    |
| ubuntu      | noble-mainline    | main        | amd64, arm64    |

Название

iconv-nginx-module

Описание

Это модуль nginx, который использует libiconv для преобразования символов различных кодировок. Он добавляет команду 'set_iconv' в nginx.

Этот модуль зависит от модуля ngx_devel_kit(NDK).

Использование

set_iconv

синтаксис: set_iconv <destination_variable> <from_variable> from=<from_encoding> to=<to_encoding>

по умолчанию: нет

фаза: перезапись

iconv_buffer_size

синтаксис: iconv_buffer_size <size>

по умолчанию: iconv_buffer_size <pagesize>

iconv_filter

синтаксис: iconv_filter from=<from_encoding> to=<to_encoding>

по умолчанию: нет

фаза: фильтр-вывод

Вот базовый пример:

 #nginx.conf

 location /foo {
     set $src '你好'; #в UTF-8
     set_iconv $dst $src from=utf8 to=gbk; #теперь $dst содержит 你好 в GBK
 }

 #всё, что генерируется из /foo, будет преобразовано из utf8 в gbk
 location /bar {
     iconv_filter from=utf-8 to=gbk;
     iconv_buffer_size 1k;
     #обработчик контента здесь
 }

Журнал изменений

Журналы изменений этого модуля являются частью журналов изменений OpenResty bundle. Пожалуйста, смотрите на http://openresty.org/#Changes

См. также