PocketBBSのセットアップ手順は下記の通りです。
セットアップは下記の手順にしたがって行ってください。
PocketBBS は以下のようなサーバ環境で動作させることを推奨しています。
本マニュアルは、PocketBBS 1.1.5を基にして記載されています。
本マニュアルは、OS、Apache、PHP、MySQL、又はPostgreSQLが既にインストールされている事を前提とします。
- ROOT_DIR ├ css <--- デザインの設定ファイル格納 ├ imgages <--- 画像ファイルを格納 ├ js <--- JavaScriptファイルを格納(現在は使用していません) ├ lib <--- PocketBBS、PEAR、SMARTY等のライブラリファイルを格納 ├ setup <--- セットアップSQLファイルを格納 ├ webapp <--- 各種アクション、テンプレート、キャッシュ、コンフィグファイル等を格納 │ ├ cache │ ├ configs │ ├ lib │ ├ modules │ ├ templates_c │ ├ config.php │ └ init.php ├ img.php <--- 画像処理ファイル └ index.php <--- 初回起動ファイル
※基本的に上記の構成を変更する必要はありません。変更される場合は上級知識が必要になります。
[設定例]
$ chmod -R [ XXX ] cache/* templates_c/*
※[ XXX ]には環境によって適切な値を設定して下さい。
[ POCKET_APL_ALIAS ]
アプリケーションのエイリアス名(DocumentRootの場合は「/」)
[ _POCKET_DSN ]
データベースへ接続するための情報です。(MySQL、又はPostgreSQL)
接続用ユーザ、パスワード、サーバホスト名、データベース名を設定して下さい。
※DSN設定にはMySQLとPostgreSQL用があります。どちらか一方を有効にして下さい。
[ _POCKET_SMTP ]
SMTPサーバの情報です。
パスワード再発行等で使用します。
[ _POCKET_POP3 ]
POP3サーバの情報です。
POP before SMTP 対応でメール送信時にPOP3認証する際に使用します。
[ POCKET_BBS_ENCRYPT_KEY ]
暗号化用の鍵(56バイト以内のASCII文字)
推測されないような文字列を設定して下さい。
[ POCKET_BBS_COLOR ]
PocketBBSのベース色
ベース色の設定が可能です。お好みに合わせて設定して下さい。
※基本的に上記の内容以外は編集する必要はありません。変更される場合は上級知識が必要になります。
[設定例]
バーチャルホストを使った設定
<VirtualHost *:80>
ServerName pocket.example.net
DocumentRoot /home/username/pocketbbs/
DirectoryIndex index.html index.php
</VirtualHost>
httpd.conf編集後、設定を反映させるにはApacheを再起動して下さい。
下記の手順を順番に実行して、データベースを作成して下さい。
1. MySQL コマンドに接続
$ mysql -u [ username ] -p <Enter> Enter password: [ password ] <Enter> Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is XXXXX to server version: 4.1.XX-log Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql>
※[ username ][ password ]は環境によって書き換えて下さい。
※mysql コマンドを利用するには、mysqlグループユーザで実行する必要があります。
2. データベースの作成
mysql> CREATE DATABASE [ DBNAME ] DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; <Enter>
※[ DBNAME ]は環境によって書き換えて下さい。
3. MySQL コマンドの終了
mysql> exit <Enter> Bye
下記の手順を順番に実行して、データベース、ユーザ、スキーマを作成して下さい。
1. データベースの作成
$ createdb [ DBNAME ] -E 'UNICODE' <Enter> CREATE DATABASE
※[ DBNAME ]は環境によって書き換えて下さい。
※createdb コマンドを利用するには、postgreグループユーザで実行する必要があります。
2. PostgreSQL コマンドに接続
$ psql [ DBNAME ] <Enter>
Welcome to psql 7.4.XX, the PostgreSQL interactive terminal.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help on internal slash commands
\g or terminate with semicolon to execute query
\q to quit
pocket=#
※[ DBNAME ]には「1. データベースの作成」で作成したデータベースを指定して下さい。
※psql コマンドを利用するには、postgreグループユーザで実行する必要があります。
3. ユーザの作成
pocket=# CREATE USER [ username ] WITH ENCRYPTED PASSWORD '[ password ]'; <Enter> CREATE USER
※[ username ][ password ]は環境によって書き換えて下さい。
4. スキーマの作成
pocket=# CREATE SCHEMA [ schemaname ] AUTHORIZATION [ username ]; <Enter> CREATE SCHEMA
※[ schemaname ]は環境によって書き換えて下さい。
※[ username ]には、「 3. ユーザの作成 」で指定したユーザ名を指定して下さい。
5. PostgreSQL コマンドの終了
pocket=# \q <Enter>
[アクセス例]
http://pocket.example.net/?m=setup
[ _POCKET_MODULES ]
「setup」を削除して下さい。