Руководство по настройке пакета веб-почты SquirrelMail версии 1.4.4 Григорий Мохин, <mok на kde.ru> 30 января 2004 г. С изменениями от 17 февраля 2005 г.

Что такое SquirrelMail?

Установка SquirrelMail

$ ./configure --(ваши опции) \
       --with-gettext --enable-mbstring=all --with-iconv --with-recode

$ ./configure --disable-all \
       --enable-session --with-pcre-regex --with-gettext 

Локали для SquirrelMail 1.4.4

• UTF-8
• KOI8-R
• CP1251

Первичная настройка SquirrelMail

$ ./configure

# chown nobody.nobody data
# chmod 700 data
# mkdir attach
# chown nobody.nobody attach
# chmod 700 attach

1. DSN for Address Book   : mysql://squirreluser:pass@localhost/sqmail
2. Table for Address Book : address

3. DSN for Preferences    : mysql://squirreluser:pass@localhost/sqmail
4. Table for Preferences  : userprefs
5. Field for username     : user
6. Field for prefs key    : prefkey
7. Field for prefs value  : prefval

Доводка SquirrelMail и настройка русского языка

• Вопрос 1 – Белка не отвечает.
  Ответ: что-то не так настроили. Проверьте, правильно ли вы настроили веб-сервер и поддержку php.



• Вопрос 2 – Белка отвечает не по-русски, а по-английски.
  Ответ: не так настроили язык.
  Пояснение. Проверьте, правильно ли настроена локаль. У Белки может быть два режима работы с интерфейсом, отличающимся от английского: с использованием функций gettext и с использованием их программных заменителей, если PHP собран без поддержки gettext. Во втором режиме всё работает без дополнительного шаманства, но медленнее. Первый режим несравненно шустрее, но ему требуется, чтобы система поддерживала локаль, используемую для перевода. Не все дистрибутивы поддерживают русскую локаль UTF-8, поэтому это надо проверить:

  $ locale -a | grep ru
  

  и в случае отсутствия в списке ru_RU.UTF-8 собрать её самому:

  # localedef ru_RU.UTF-8 -i ru_RU -fUTF-8
  

  После этого может потребоваться перезапустить веб-сервер, чтобы новая локаль стала доступна PHP. Использование локали UTF-8 позволит читать и писать письма на любом языке и создавать папки на сервере IMAP также на любом языке. К сожалению, не все почтовые клиенты понимают юникод, поэтому некоторые из ваших адресатов со старыми почтовыми программами будут удивлены приходом письма на незнакомом языке.



• Вопрос 3 – хочу Белку по-русски в KOI8-R или cp-1251.
  Ответ: пожалуйста. Особенно это необходимо тем, у кого уже работает Белка более старых версий, и параметры пользователей сохранены в восьмибитной кодировке. Поскольку КОИ является преобладающей кодировкой в российской почтовой переписке, её пока что можно использовать с наименьшими проблемами для себя и пользователей.
  Для этого нужно:
  • или самому перекодировать русский файл перевода, который лежит в locale/ru_RU/LC_MESSAGES:

    $ msgconv -t koi8-r squirrelmail.po или $ msgconv -t cp-1251 squirrelmail.po, 
    

    или скачать уже готовые файлы по ссылкам, приведённым выше. При использовании gettext po-файл нужно скомпилировать:

    $ msgfmt squirrelmail.po -o squirrelmail.mo
    

    В архиве есть готовые собранные mo-файлы для Белки и некоторых модулей. Возможно, надо будет перезапустить веб-сервер.
  
  
  • найти в файле functions/i18n.php строки:

    $languages['ru_RU']['NAME']    = 'Russian';
    $languages['ru_RU']['CHARSET'] = 'utf-8';
    $languages['ru_RU']['LOCALE'] = 'ru_RU.UTF-8';
    $languages['ru']['ALIAS'] = 'ru_RU';
    

    и заменить их на ту локаль, в которой вы хотите работать, например:

    $languages['ru_RU']['NAME']    = 'Russian';
    $languages['ru_RU']['CHARSET'] = 'koi8-r';
    $languages['ru_RU']['LOCALE'] = 'ru_RU.KOI8-R';
    $languages['ru']['ALIAS'] = 'ru_RU';
    

  • изменить в файле конфигурации default charset на KOI8-R.


• Вопрос 4 – Что такое lossy encoding?
  Ответ: это опция перекодировки писем (пункт 10-3), часть символов которых отсутствует в текущей (8-битной) кодировке. Проблема состоит в том, что при использовании восьмибитных кодировок могут приходить письма, символы для которых принципиально отсутствуют в KOI8-R, поскольку на их месте стоят русские буквы. Таковы, например, почти все западноевропейские "умляуты". Остаётся два варианта: принудительно считать их восьмибитными русскими символами, и тогда Sebastiàn превращается в СебастьЮна (SebastiЮn), или включить перекодировку с потерями, чтобы Sebastiàn отображался со знаком вопроса на месте чужих символов (Sebasti?n). Выбирайте сами, что вам ближе, или работайте в UTF-8 и забудьте об этой проблеме раз и навсегда. Кстати говоря, для перекодировки русских писем эта проблема не возникает, потому что все буквы cp-1251 взаимно однозначно отображаются в буквы KOI8-R. Белка это знает и перекодирует русские письма правильно при любой системной кодировке.



• Вопрос 5 – Как сделать, чтобы имена папок отображались по-русски?
  Отвечает Tomas Kuliavas <tokul на users.sourceforge.net>: Для обычных папок (не служебных, то есть не INBOX, Sent, Trash и Drafts) достаточно собрать PHP с поддержкой mbstring, как описано выше. Имена служебных папок следует задать в файле конфигурации Белки в UTF-7. Найдите там следующие переменные:

  $trash_folder  = 'INBOX.Trash';
  $sent_folder   = 'INBOX.Sent';
  $draft_folder  = 'INBOX.Drafts';
  

  и замените их на:

  $trash_folder  = 'INBOX.&BBoEPgRABDcEOAQ9BDA-';
  $sent_folder   = 'INBOX.&BB4EQgQ,BEAEMAQyBDsENQQ9BD0ESwQ1-';
  $draft_folder  = 'INBOX.&BCcENQRABD0EPgQyBDgEOgQ4-';
  

  то есть на русские названия Корзина, Отправленные и Черновики в UTF7-IMAP. Для желающих: "Входящие" в этой кодировке пишется как &BBIERQQ+BDQETwRJBDgENQ-.



• Вопрос 6 – Можно ли использовать Russian Apache?
  Отвечает Tomas Kuliavas: можно, но не рекомендуется. Для того чтобы русский апач не портил кодировки Белки, необходимо отключить функции преобразования кодировок. Опция CharsetDefault портит кодировки, отправляемые Белкой, и перекодирует сам текст.

Настройка модуля шифрования GPG для SquirrelMail