PHPのテクメモ

XOOPS本を2冊買った。本を買った目的は「モジュールが作れるようになること」。ウェブで調べれば情報はあると思うが、やはりこういうとき、紙媒体は捨てがたい。
1冊目は「Customizing Xoops」。基本的な使い方から、代表的な外部モジュールの使い方、テンプレートの編集、モジュールのハックまで書いてある。まだ全てを読んだわけではないけれど、既存のモジュールでやりくりするならこの本で十分だ。代表的な外部モジュールとして、簡単にページを追加するための「TinyD」、外部RSSを読み込む「xhld」が紹介されている。しかしこの本を読んでもモジュールを作れるようにはならない。モジュールの仕様が書いてないからだ。モジュールの仕様がわからないのだから、モジュールのハックといってもおそらく本格的にはハックできない。なんとも中途半端な本だ。
最初はこの本だけ買ったのだが、この本の中の記述で「モジュール作るならこの一冊」見たいな記述があった。その本は「XOOPSコミュニティサイト構築ガイド」。この本はよかった！。モジュールの仕様がよくわかる。しばらく読んでいて、なんとなくXOOPSがわかったような気がしてくる。でも正直言うと、もう少し細かく書かれていてもいいような木がする。一つの項目についてもっと徹底的に解説して欲しかった。でもまぁ、これでなんとかなりそうだ。

その昔XOOPSをインストールした際、ユーザの登録情報をカスタマイズするといえば「白扇」だった。「今はさぞ進化したことだろう」、と思ったら今でも白扇だった。
何でも、白扇の新版「新扇」というのが開発中らしいが、進捗はどうなっていることやら。既に開発期間も2年ほど過ぎようというのに、いまだに情報があまりない。おそらくまだ出来上がっていないのだろう（作者さん、がんばって！）。
いちおう「ミニ白扇」なるものもあるらしい。まぁ、これもおそらく白扇と似たような感じなのだと思う。どちらを使うかはまた後日検討して決めるとする。
現在運営中のサイトの一つが、初めてmojaviを使って構築したサイトなのだが、タコなプログラムを書いてしまったので、リニューアルを検討中。もっとも・・・mojaviの勉強のために構築したのだから、ずいぶん役にはたった。リニューアルのためのフレームワークを何でやるか、XOOPSかcakePHPなのだ。もう少し研究して、XOOPSが無理っぽいようだったらcakePHPで。ちょっとがんばってみる。

既存のモジュールに関する説明だが、この本には期待しないほうがいい。だってそんな記述はほとんどないから（もちろん最低限なことはかいてあるけど）。主に自分でモジュールを作ったりする人向け、というコンセプトなのだと思う（まぁ、タイトルどおりなんだが）。
それでもモジュール「TinyD」（静的ページ作成モジュール）などは詳しく書かれているので、自分にとっては非常に有用な書籍になりそうだ（まだ全部読んでないんでね）。
ということで、個人的にはかなりいい本だと思う。
悪い点としてあえてあげれば、無駄な紙面が多い（最初のカラーのXOOPSサイトカタログとか）こと。だいたいハックするための本なんだから、無駄な記述はいらんだろうと思う（初心者向けじゃないんだからさ）。

XOOPSをインストールするのはもう何年かぶりとなる。前回インストールした際は、インストーラがまだまだいけてなくて、途中で真っ白な画面表示になったりしてトラぶったが今回はこなれているだろうか、と少し不安を持ちつつインストールを開始した。ここにはインストールした手順をメモしておく。

(1) 設置場所の準備
専用のドメインなりサブドメインを用意してそのルートディレクトリにインストールすることにした。基本的にXOOPSで全てまかなうのが常套だと思うので、サブディレクトリに設置するといった、イレギュラーな処理はすべきでないだろう。

(2) データベースの用意
XOOPSで使用するMySQLデータベースをあらかじめ用意しておく。

(3) FTPする
XOOPSからアーカイブをダウンロード、解凍し、出来上がったファイルのうちhtmlディレクトリ内のファイル全てをサーバ上のドキュメントルートディレクトリにアップロードする。

(4) ブラウザでアクセスする
ドキュメントルートに設置しているので、以下のようにアクセスしてみる。
http://xoops.example.com

(5) 最初の画面
ここでインストールで使用する言語を選択する。通常なら迷わずjapanese（日本語）を選択する。

(6) 説明画面がでるので必要に応じて読んで次に進む

(7) アクセス権チェック
アップロードした際には特に何も設定しなかった場合、アクセス権限のチェックでひっかかる。ここで出た指示に沿ってアクセス権限を設定する。ここで設定するファイルは4つ。
○uploads/ ウェブからファイルをアップロードした際に、ファイルがここにおかれる
○cache/ 諸般キャッシュがここに作成される
○templates_c/ XOOPSではSmartyを使用しているので、コンパイル済みファイルの設置場所としてこのディレクトリを使う
○mainfile.php 各種設定などが書き込まれる

(8) 正しく設定すると次に進めるようになる

(9) データベース・パスの設定
作成したデータベースへのログイン情報などを設定する。大抵はデータベースのホスト名、ユーザ名、パスワード、データベース名を入力するだけでいいはずだ。

(10) 設定内容の確認画面が表示される

(11) 設定内容がmainfile.phpに書き込まれる

(12) パス・URLの確認が表示される

(13) データベース設定の確認が表示される

(14) データベースへの接続がチェックされる
ここまできてようやくデータベースへの接続がチェックされる。本当ならmainfile.phpへデータベースへのログイン情報を書き込む前にチェックすべきなのだが、まぁ、仕方ない。問題なければ次に進む。

(15) 必要なテーブルがデータベース内に作成される
(14)で問題なければ、ここも問題はないだろう（よほどちゃんとアクセス権限を設定したりする場合はここでエラーが出るかもしれない）。

(16) 管理者情報の入力
管理者ログインに関する情報を設定する。

(17) 管理者情報がデータベースに書き込まれる
データベースに書き込まれた内容が確認として表示される。あと、一部設定ファイルにも書き込まれるようだ。

(18) インストール完了
ここまでくればインストールが無事完了、となる。

しかし入力内容の確認がかなり冗長で、ちょっとうざいかもしれない。そのあたりがこなれてくるといいなと感じた。ちなみにインストール直後は、非ログイン状態だと何も表示されない。それはデフォルトの設定が、非ログイン者に対しては全て非表示になっているからだ（親切にデフォルトでも何か表示されたほうが普通の人にはわかりやすいのに・・・）。ここから徐々にちょっとずつ設定していくことが必要になる、ということだ。

さて第一段階終了。次のステップもまた逐次ここでメモしていく。

クライアントさんの関係でとうとうXOOPSを始めることになった。
とうとう、というのは語弊があって、実は以前XOOPSを使っていた。バージョン2の頃だから、ちょうどCMSがもてはやされ始めた頃・・・と思ったら今だにバージョンは2のままか。数年間メジャーバージョンアップしてないわけですな。
しかし派生バージョン「XOOPS CUBE」ができている。数年前は「日本語独自バージョンを開発するのはどうこう」と議論になっていたが、結局やる方向で落ち着いたということか。
情報をあさってみると、XOOPSで日本人のコミットが拒否されたとか・・・。元々日本人がメイン開発者の一人だったのに、ひどい話だ。しかしそれにもまして新プロジェクト「XOOPS CUBE」では広く（国籍を問わず）開発者を募集している。きっと大変徳の高い方がやっていらっしゃるのだろう（と思ったらXOOPS CUBEの管理者の名前がtadashi・・・これは長尾さんだったかな）。なんとも徳が高い話だ。オープンソースの鏡、というべき？。
ということでXOOPSの取り扱いを始めます。記事投稿は逐次・・・。