phpBB-2.0.21++.zip 

同じ phpBB カスタム版を使用したいという奇特な方は勝手に DL して適当に使ってください。バグ報告があれば受け付けますが、ユーザサポートなどはありません。phpBB++ の詳細は phpBB++ 管理者ガイドをご覧ください。

• Feeds Syndicator

phpBB 全体、各フォーラム、各トピック別の RSS/Atom フィードを出力する MOD です。RSS Content Syndicator を参考にして作ったものですが、使い方も機能も出力も全く別物になっています。この MOD には設定なども結構あるので別途解説します。

• Admin Userlist++

管理者がユーザを一括管理するための MOD です。Admin Userlist をベースに、テンプレートの整理や日本語対応を行った上で、ファイルを UP するだけで使えるようにしたものです。admin_userlist ディレクトリ配下のファイル(readme.txt 以外)を phpBB のディレクトリにコピーして、管理画面の「ユーザリスト」を使ってください。

• Visual Confirmation for Guests

スクリプトによる自動スパム対策 MOD です。phpBB のユーザ登録時に確認コードを求める機能がありますが、ゲストユーザによる投稿時にも確認コードを求めるようになります。

guest_confirmation.patch にまとめているので、patch コマンドを使って導入してください。確認コード(視覚的コード)の入力を求めるかどうかの設定はユーザ登録のものと連動します。

• Page Generation Time

ページの末尾に生成時間と SQL クエリ実行回数を出力します。付加を確認するためのデバッグくらいにしか役立ちませんが、使いたければ page_gentime.patch を適用してください。設定などはありません。

• Smart Login Redirect

ログインボタンを押してログインした際に、フォーラムのトップではなくログイン前のページへとリダイレクトさせます。地味ですがこの手の配慮は大事にしたいところです。好みに応じて smart_login_redirect.patch を適用してください。設定などはありません。

現時点で同梱している MOD は以上です。今後も他の MOD を追加したり、phpBB++ の標準機能についても個別の MOD として分離していくかもしれません。

• 文字エンコーディング

phpBB++ 標準では UTF-8 を使うので、Shift_JIS や EUC-JP などを採用している他の phpBB から移行する場合には既存データを変換しないと文字化けします。mysqldump (または phpMyAdmin のエクスポート機能)で出力した SQL 文の文字エンコーディングを変換してから mysql コマンドでリストアすれば OK です(phpBB 管理画面のバックアップ機能は非推奨)。

なお、フィールド長を修正していなかったために既にデータが文字化けしている(多バイト文字の途中で切れている)場合などには上手くいかないことがあります。そのような場合は先に問題のデータを修正するか、フィールド毎に文字コードを変換していくスクリプトを書くとか、適当に対処してください。

• データベーススキーマ

見逃しがちなのがデータベーススキーマの変更です。「インストール」で書いたとおり、MySQL 4.0 以前では char/varchar フィールド長の単位が byte です。MySQL 4.0 以前を使う場合、既存データが UTF-8 かつ既に修正済みでない限り、フィールド長の修正が必要です。

install/schemas/mysql_schema.sql ファイルなどを参考に、mysqldump 出力の CREAT TABLE 文を書き換えてください。

また、スパム対策機能のために phpbb_disallow テーブルには次のフィールドを追加定義しています。CREAT TABLE 文に追加するか、リストア後に phpMyAdmin などで追加してください。無論こちらは MySQL 4.1 以降でも必要です。

disallow_subject varchar(255) default NULL,
disallow_message text default NULL,

• 追加フィールド

更に見逃しやすいのが環境設定の追加フィールドです。「インストール」で書いたとおり、phpbb_config テーブルに独自機能の設定を追加しています。mysqldump 出力に次のような INSERT 文を追加するか、phpMyAdmin などで追加してください。

INSERT INTO phpbb_config (config_name, config_value) VALUES ('trashbox_forum_id', '');
INSERT INTO phpbb_config (config_name, config_value) VALUES ('max_links_per_post', '30');
INSERT INTO phpbb_config (config_name, config_value) VALUES ('max_links_per_post_by_anonymous', '20');
INSERT INTO phpbb_config (config_name, config_value) VALUES ('favicon_path', '');

• mysqldump/mysql コマンド

最後に一応 mysqldump/mysql コマンドの使用例を書いておきます。

mysqldump -u USERNAME -p --add-drop-table --skip-extended-insert --default-character-set=binary DBNAME > phpbb-backup.sql

これで DBNAME データベース中の全データが SQL の INSERT 文としてバックアップされます。-add-drop-table, --extended-insert, --default-character-set の指定については必要に応じて適当に。

SQL ファイルが得られたら、必要に応じて上記の通り文字エンコーディングの変換、テーブル接頭辞やテーブルスキーマ定義の変更、不足フィールドの追加をしてから、次のように mysql に読み込ませます。

mysql -u USERNAME -p DBNAME < phpbb-backup.sql

以上、分かっていれば簡単だが分かっていないと色々はまる、移行作業の注意事項でした。

なのですが、追加機能の設定を変更したり、同梱 MOD を導入したりする人のため、いくつか注意点を書いておきます。

• phpBB++ 独自設定項目

使用する文字エンコーディングは lang_main.php の $lang['ENCODING'] で指定しますが、phpBB++ では通知メールだけ別のものを $lang['MAIL_ENCODING'] で指定できます。但し、これらの設定の変更は推奨できません。

スパム対策として導入した投稿中のリンク数制限については、登録ユーザとゲストユーザにんついてそれぞれ phpbb_config テーブルの max_links_per_post と max_links_per_post_by_anonymous 行で指定します。

スパムなどを記録用に残す「ごみ箱フォーラム」を定義するには、そのフォーラムをプライベートフォーラムにした上で、phpbb_config テーブルの trashbox_forum_id 行でフォーラム ID を指定します。

なお、「ごみ箱フォーラム」はモデレータがトピックを移動する時のデフォルト移動先フォーラムになります。また、「ごみ箱フォーラム」のトピックにゲストユーザがアクセスするとログイン要求ではなくトピックが存在しないというエラーが表示されるようになります。 

• 同梱 MOD のインストール

パッチ形式で同梱している MOD は通常のパッチ同様、必要に応じて次のようにして導入してください。

patch -p1 -d phpBB-2.0.21++ < guest_confirmation.patch

Feeds Syndicator などについては単一パッチファイルではなく追加ファイル群を個別のディレクトリに納めています。readme を確認し、パッチについては適用し、それ以外のファイルは phpBB++ のディレクトリにコピーしてください。

個別 MOD の機能や設定方法については別途改めて解説します。

• MySQL における日本語

念のためここで軽く MySQL 管理者の常識を。(^^;

使用する MySQL のバージョンが 4.0 以前である場合、char/varchar 型フィールドの長さを確認してください。UTF-8 では日本語は一文字 3byte ですが、Mysql 4.0 以前では char/varchar 型フィールド長が byte 単位であり、標準 phpBB スキーマの 3倍必要です。

MySQL 4.1 以降ではフィールド長がちゃんと文字単位になりましたが、コマンド、ライブラリ、データベースそれぞれの文字エンコーディング設定には注意が必要です。my.cnf で default-character-set が正しく指定されているか(mysqldump には binary が便利かも)、既存データベースの collation に間違いはないかなど確認しておきましょう。

最後に余談。phpMyAdmin などでは collation を「照会順序」と書いてますが、日本語としては「照合規則」の方が良いと思います。問い合わせるのではなく比較するのだし、順序づけだけが目的ではありませんから。

2006年 7月時点で最新バージョンである phpBB-2.0.21 と phpBB-2.0.21++ の違いはこんな感じです。

• メール文字化けを始めとする日本語処理のバグ修正
• 日本語使用時も問題ないようにデータベーススキーマを修正
• 基本的な UI については独自の日本語訳を使用
• 通知メールだけ異なる文字エンコーディングを指定可能

要するにオリジナルの日本語関連バグを修正しているってことです。日本語リソースもちゃんと最新バージョンに追いついています。

• 全体、フォーラム、トピック別の RSS/Atom フィードを配信可能
• 最近投稿されたトピックを全て表示する機能を追加
• 期間やカテゴリだけを指定しての全投稿検索する機能を追加

標準の phpBB には最近の投稿を確認する機能が備わっておらず、新規投稿のチェックが困難です。その解決策として RSS/Atom フィードの配信機能と全投稿検索機能を追加しています。フィードについては Feeds Syndicator という MOD を同梱しており、必要な場合に追加導入する形です。多分通常の phpBB にも追加導入可能ですが未確認です。

• メッセージ内容によるフィルタリング機能を追加
• メッセージ題名によるフィルタリング機能を追加
• メッセージ中のリンク数によるフィルタリング機能を追加
• ゲストユーザの投稿には確認コードの入力を求めることが可能
• スパムを記録用に残すための「ゴミ箱フォーラム」を定義可能

スパム対策機能です。上手く使ってちゃんと管理すれば大半のスパムをシャットアウトできますが、今のところ管理用 UI は用意しておらず、スパム対策のために phpBB++ を検討されている方は phpMyAdmin などが必須だと思ってください。

• メッセージ中で使える実態参照を一部追加
• 誤登録の元と判断して COPPA 機能を除去
• デフォルトのテーマやスタイルシートなどを一部変更
• モデレータがログインしたとき以外はユーザ一覧に無効なユーザを含めない
• いくつかの MOD を同梱

これ以外にもまだあります。要するに、細かい点が色々違うってことです。細部が気になる人は同梱の diff を確認してください。

次に、phpBB++ を使用する上で準備すべきものについて軽く説明します。

• phpBB++ の最新バージョン (必須)

何はなくとも、です。

• mbstring が有効になっている PHP サーバ (必須)

通知メールなどは mbstring (マルチバイト拡張モジュール)で文字コードを変換して送信します(フォーラムが UTF-8 で通知メールは ISO-2022-JP を推奨)。他にも何かと必要となることが多いモジュールなので、使えるようにしておきましょう。

• MySQL サーバ (必須)

MySQL 以外は一切サポートしません。他のサーバでもちょっといじれば動作するはずですが、私は一切関知しません。また、mysqldump コマンドが使えると便利です。

• phpMyAdmin

上記スパム対策機能のところでも書きましたが、今のところ管理者向けの追加機能については UI を用意していません。直接データベースを操作することになるので、phpMyAdmin がないとやってられません。

• patch コマンド実行環境

一部の追加機能(MOD)については patch 形式のファイルとして同梱しています。phpBB 界で一般的な MOD 形式じゃないのは、diff/patch が使える人にはあんなの不便極まりないからです。(笑)

およそこんな感じです。ちゃんと整理し切れていませんが、元々配布目的じゃないってことでご容赦ください。(^^;

これらのフォーラムでは phpBB のカスタム版(phpBB++)を使っていますが、これまで phpBB++ については公開はしているものの、修正点や追加機能の説明は殆どしてきませんでした。それでも採用してくださっている方がいますし、最近某所でスパム対策のために phpBB++ に移行しようという動きもあるので、少しずつ phpBB++ の管理方法などを説明していこうかと思います。

今後この Blog の phpBB カテゴリに続きを書いていきますので、phpBB++ の管理者その他興味のある方はご覧ください。

ところで、当時はまだ日本では知名度も高くなく、そもそも日本語対応がボロボロだった(今も駄目っぽい) phpBB を独自に修正してまで採用した理由ですが、US の Mozilla コミュニティである MozillaZine のフォーラムが phpBB であったこと、オープンソースであること、(少なくとも US では)広く使われていたこと、(私の頼りない記憶では)敬愛する池田さんが提案してくれたこと、そして必要と思われる機能がそろっていた(少なくともそれ以前のものより遙かに高機能だった)ことなどでした。

今となっては不足している機能も結構あるし、セキュリティホールもポコポコあるし、他にも選択肢はあったかもしれませんが、総合すればまぁ妥当な選 択だったと思っています。必要だが不足するものについては随時補ってきましたし、蓄積されている過去の資産やユーザの慣れもあるので、今後も phpBB++ を使っていくつもりです。

そして、そんな過程を通して追加してきた独自機能の使い方や、フォーラムを管理する上での注意点などを書き、phpBB++ 管理者の参考にしてもらうというのがこの管理者ガイドの目的です。

ですので、期待してくださった方には申し訳ありませんが、一般的な phpBB の導入方法や基礎知識などは取り扱いません。あくまでも通常の phpBB の使い方が分かっている管理者向けの説明になります。ご了承ください。

最後になりましたが、説明して欲しいことやご意見、お気づきの点などありましたらコメントをよろしくお願いします。

同じ phpBB カスタム版を使用したいという奇特な方は勝手に DL して適当に使ってください。バグ報告があれば受け付けますが、ユーザサポートする気は全くありませんのでご了承ください。

オリジナルとの違いや特徴についてはおおよそこんな感じでしょうか。

• メール文字化けを始めとする日本語処理のバグ修正済み
• 基本的な UI については独自の日本語訳を使用
• 通知メールだけ異なる文字エンコーディングを指定可能
• mysql4, mbstring を有効にした PHP のみサポート
• 最近の投稿を一覧表示することが可能
• RSS フィードの配信が可能 (Feeds Syndicator を同梱)
• 投稿中メッセージ内容によるフィルタリングが可能
• メッセージ中に多数のリンクを含む投稿を禁止
• スパムなどを入れる「ゴミ箱フォーラム」の定義が可能
• メッセージ中で使える実態参照を一部追加
• 誤登録の元と判断して COPPA 機能を除去
• テーマやスタイルシートなどを一部変更
• いくつかの MOD をパッチファイルとして同梱

但し、独自機能の一部は UI を用意しておりません。 phpMyAdmin などで直接データベースを操作して使う機能もあります。

なお、今回からはメンテナンススクリプトを書いて、それを用いてアップデートを行うようにしました。欲しいという要望があればメンテナンススクリプトの方も公開します。

同じ phpBB カスタム版を使用したいという奇特な方は勝手に DL して適当に使ってください。
但し、今のところユーザサポートする気は全くありませんのでご了承ください。

今回からは RSS/Atom フィードを生成するための独自スクリプト Feeds Syndicator も同梱しています。

追記: [quote="name"] BBCode まわりのバグ修正を含めたものにアップデートしました。