README for mod_fast_bbs (Windows)

mod_fast_bbs: Apache のモジュールとして動作するスレッド型掲示板

Contents

mod_fast_bbs とは?

mod_fast_bbs は,スレッド型の掲示板を Apache のモジュールとして実装 したものです.以下のような特長があります.

動作サンプル

http://acapulco.dyndns.org:6060/bbs/

動作環境

mod_fast_bbs は,Windows で動作します.(Linux UNIX 版はこちら)

詳細を以下に示します.

ライセンス

The zlib/libpng LicenseThe zlib/libpng License の翻訳 )に従 います.

ダウンロード

CVS リポジトリ

下記のようにすることで check out できます.(パスワードは空)

$ cvs -d:pserver:anonymous@cvs.sourceforge.jp:/cvsroot/mod-fast-bbs login
$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.jp:/cvsroot/mod-fast-bbs co mod_fast_bbs

また, ViewCVS 経由で参照 することもできます.

インストール

mod_fast_bbs-1.0.5.msi を実行すれば OK です.デフォルトでは C:/Program Files/mod_fast_bbs 以下にインストールされます.

注意事項

動作環境 にも書いてありますが,あらかじめ Apache 及び ImageMagick を インストールしておく必要があります.(参考: Apache インストール手順, ImageMagick インストール手順)

設定

  1. [スタート] - [プログラム] - [mod_fast_bbs] からたどれる FastBBSConfig を起動します.起動すると下図の様なウィンドウが現れます.
FastBBSConfig のスクリーンショット
  1. 掲示板の URL を必要にあわせて変更します.他にも設定項目がありますが, 通常は変更する必要ありません.
  2. エラー エラーアイコン が表示されていれば,その項目を修正します. アイコンの上にカーソルをあわせると詳しい説明が表示されます.
  3. 「設定をコピー」ボタンを押して設定をクリップボードにコピーします.
  4. コピーしたものを Apache の設定ファイル (httpd.conf) に貼り付けます.

起動

Apache を普通に起動すれば OK です.設置した場所にブラウザでアクセス してみましょう.

コンパイル方法

通常はコンパイル作業は不要です.ソースを編集して細かくカスタマイズした い方のみ読んでください.

最初に,UNIX 系 OS で configure します.

$ ./configure

次に,ディレクトリを丸ごと Windows にコピーし,src/GNUmakefile.win32 の 次の部分を, Apache をインストールしたディレクトリおよび ImageMagick をインストールしたディレクトリに書き換えます.

APACHE_DIR  := C:/Server/Apache2
MAGICK_DIR  := C:/Application/Image/Edit/ImageMagick

以上が完了したら,src/GNUmakefile.win32 を使って make します.

> cd src
> vsvars32.bat
> make -f GNUmakefile.win32

vsvars32.bat は,コマンドラインから Visual C++ .NET を使うための環 境設定を行うスクリプトです. Visual C++ .NET をインストールしたディ レクトリ以下の Common7/Tools にあります.

アンインストール

[スタート] - [設定] - [コントロールパネル] にある「プログラムの追加と削 除」から行えます.掲示板のデータは自動的には消去されませんので完全に消 去したい場合は手動でフォルダ (デフォルトでは C:/Program Files/mod_fast_bbs) を削除してください.

注意事項

mod_fast_bbs が動作中だとアンインストールが行えません.アンインストール 作業が途中で止まってしまう場合は,httpd.conf から mod_fast_bbs の設定を 削除した後 Apache を再起動し,再度試してみてください.

テスト結果

テスト結果一覧

API ドキュメント

http://acapulco.dyndns.org/mod_fast_bbs/api/

寄付

PayPal 経由での寄付を受け付けています.mod_fast_bbs が気に入った場合は よろしくお願いします.いただいたお金は開発のための書籍購入などにあてさ せていただきます.

参考文献

プログラムの作成にあたってお世話になった文献を紹介します.

Apacheモジュール プログラミングガイド Secure Coding in C And C++

Apacheモジュール プログラミングガイド
Apache のモジュール作成に必要になる事柄を一通り説明した本.痒いと ころに手が届いているので,手元に置いておくと重宝します.
Secure Coding in C And C++
C/C++ でプログラムを作るときにセキュリティホールが発生してしまう原理と その対策について詳しく説明した本です.丁寧に書かれているので内容を しっかりと理解することができます.
Advanced Topics in Module Design: Threadsafety and Portability
Apache 2.0 でモジュールを作成するときに必要になってくるテクニック が解説されたパワポ.そんなに長くないので,モジュール書く前にさらっと 読んでおきましょう.
Apache API C++ Cookbook
C++ を使って Apache のモジュールを作成する際の注意事項について説明 したサイト.
libapr (apache portable runtime) programming tutorial
APR のチュートリアル.サンプルコードおよび,間違いやすい点についての 記述が多いので重宝します.
Using libavformat and libavcodec: An Update
libavformat と libavcodec を使って動画からフレーム画像を取り出す方法 を解説したページ.丁寧に書かれています.
STL のページ
C++ の標準テンプレートライブラリである STL について簡潔にまとめられた サイト.
RubyExtensionProgrammingGuide
Ruby の拡張ライブラリの書き方を解説したサイト.基本的な事項から少し高 度な話題まで非常に良くまとまってます.
Compiler Construction Lecture
コンパイラ作成に関する実践的な内容が簡潔にまとめられたサイト.簡単な インタプリタもどきを作るんだったら,このサイトだけで十分かも.