squirrelmail 1.4 インストールメモ
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

# インストール方法
#---------------------------------------------------------------------------------------------

squirrelmail は本家のソースを日本語化するため、日本人有志達が日本語化パッチをwww.squirrelmail.jp にて提供しています。squirrelmail 日本語版をインストールするには、本家1.4.3 のソースと、日本語化パッチをダウンロードします。

# su root

# cd /usr/local/src
# wget squirrelmail-1.4.3a.tar.gz
# wget squirrelmail-1.4.3a-ja-20041014-patch.gz
# wget sec_remove_ja_JP.png

# tar zxvf squirrelmail-1.4.3a.tar.gz

squirrelmail を解凍後、日本語パッチ当て、インストール作業を行います。

# cd squirrelmail-1.4.3a
# zcat ../squirrelmail-1.4.3a-ja--20041014-patch.gz | patch -p1
cp ../sec_remove_ja_JP.png ./image
# cd po
# ./compilepo ja_JP

squirrelmail はPHP スクリプトで構成されているので、squirrelmail のPHP スクリプトをブラウザでアクセスできる場所へと移動します。

# cd /usr/local/src
# cp -pr squirrelmail-1.4.3a [ドキュメントルート]/webmail

squirrelmail では、一時データをディフォルトで.[ドキュメントルート]/webmail/data ディレクトリに記憶します。誰でも閲覧されては困るので、権限と.htaccess を設定します。また、添付ファイルを扱うために、添付ファイル記憶用のディレクトリも作成します。

# cd [ドキュメントルート]
# chown -R root:root ./webmail
# chmod -R 703 ./webmail/data
# mkdir ./webmail/attach
# chmod -R 703 ./webmail/attach

最後に、ディフォルトのsquirrelmail のPHP スクリプトでは、セッション一時ファイルを/tmp に、PHP スクリプトからのエラーメッセージをブラウザに出力します。[ドキュメントルート]/webmail 直下に.htaccess を設けてこれらの設定を制御するとよいかもしれません。

# 基本設定
#---------------------------------------------------------------------------------------------

squirrelmail ではPERL で記述された設定スクリプトが用意されています。コンソールから、次のコマンドを入力することでsquirrelmail を設定することができます。

# cd [ドキュメントルート]/webmail
# ./configure

おおむね、日本語環境で快適なウェブメール環境を構築するには次の設定項目をセットします。

Organization Preferences → Organization Name               | ウェブメール名称をセット
Organization Preferences → Default Language                | ja_JP にセット
Organization Preferences → Provider link                   | トップURL をセット
Organization Preferences → Provider name                   | トップURL のリンク名称をセット

Server Settings → Domain                                   | 各自環境に合わせる
Server Settings → Update IMAP Settings → Server software  | courier にセット
General Options → Default Charset                          | iso-2022-jp にセット
General Options → Data Directory                           | [DOCROOT]/webmail/data にセット
General Options → Attachment Directory                     | [DOCROOT]/webmail/attach にセット

# 後付けプラグインの設定
#---------------------------------------------------------------------------------------------

squirrelmail ではプラグインを導入することで様々な機能を追加することができます。プラグインはインターネット上で公開されており、日本語対応されたプラグインも多数公開されています。

● インストール済みプラグインの確認方法

インストール済みプラグインは./configure → Plugins を実行することで確認できます。

Available Plugins   | 利用することができるプラグイン一覧
Installed Plugins   | 現在有効なプラグイン一覧

● プラグインのインストール方法

1. インターネット上からインストールしたいプラグインファイル(xxxxx.tar.gz) をダウンロードしま
   す。
2. [ドキュメントルート]/webmail/plugins 直下にプラグインファイルを移動し、展開します。

上記手順でプラグインをインストールしたら、後はsquirrelmail の設定コマンドでプラグインを有効にします。

[ドキュメントルート]/webmail にて./configure → Plugins を実行後、インストールしたいプラグイン番号を入力してください。その後、入力した番号に相当するプラグインが有効となります。

● 主なプラグインの説明

mail_fetch               | 外部POP3 サーバーのメールをsquirrelmail に取り込む
message_details          | 受信したメールの詳細情報を別画面で表示する
delete_move_next         | メッセージ表示画面において新規に削除用リンクを追加する
address_add              | メッセージ表示画面において送信者をアドレス帳に加えるリンクを追加
                           する
filter                   | メールの自動振り分けを行う

※ 注記 )

メールの自動振り分けはwebmail の内部で行われます。.qmail などに自動振り分けのルールが記載される訳ではないので注意すること

# カスタム設定
#---------------------------------------------------------------------------------------------

● ログインユーザーごとに接続先IMAP サーバーを変更する対応

[ドキュメントルート]/webmail/functions/imap_general.php の [sqimap_login] 関数のうち、$imap_server_address をセットする箇所を以下のように変更します。

// $username より接続先IMAP サーバー$imap_server_address をセットする
$server = explode( "@", $username );
$imap_server_address = $server[1];

● ログインユーザーごとに接続先SMTP サーバーを変更する対応

[ドキュメントルート]/webmail/src/compose.php の [deliverMessage] 関数のうち、$smtpServerAddress をセットする箇所を以下のように変更します。

// $username より接続先SMTP サーバー$smtpServerAddress をセットする     
$server = explode( "@", $username );
$smtpServerAddress = $server[1];

● オプションメニューの項目を調整する

[ドキュメントルート]/include/options/display.php の [load_optpage_data_display] 関数を調整する