すぐに忘れる脳みそのためのメモ

1. 開発環境の一覧

この時期、恒例になってきた開発環境の整備。変なエラーに煩わされないことを祈りつつ設定 (+_+)

利用するツールとバージョンは以下の通り。

IDE
- PDT, PHP Development Tools (PDT) – Downloads より, PDT 2.1-SR2, Eclipse 3.5-SR2
Web サーバ, DB
- XAMPP, Browse XAMPP Files on SourceForge.net より, 1.7.3
バージョン管理
- Subversion, Apache 2.2-compatible を Subversion Binary Packages より, 1.6.6
- TortoiseSVN, TortoiseSVN downloads | TortoiseSVN より, 1.6.8
- Subclipse, http://subclipse.tigris.org/update_1.6.x を subclipse: Download and Install より ( cf. Eclipse から Subversion を利用する – Subclipse )

2. CakePHP を利用するための準備

今回、開発環境を新しくした理由は、修正したいコードがあったため。修正対象のソースコードで、PHP が使われている部分は、

パーツに分割した HTML を結合する処理と ( cf. フレームの代わりにPHPを使う ) 、
フォームでの問い合わせの処理。

DB は使用していない。処理はシンプルなので、テンプレートエンジンを使わず、自前で MVC ライクに書いている。しかし、いくら単純でも、Web ページの数が増えてくると、重複した部分が徐々に気になってくる。フレームワークを使うように変更しようか、検討中。

以前に、CakePHP を試してみようと環境を整えたことがある。

PHPフレームワークちいたん via kwout

軽量なフレームワーク

ちいたん

も良さげだけれど、 PHP で他のフレームワークを使ったことがないので、とりあえず CakePHP への移行が無難かな。

PHP はたくさんのフレームワークが乱立している。なるべくシンプルでコンパクトなものを使いたい。以下の図による説明を見ると、今回の自分のやりたいことに対して、CakePHP は、妥当な選択に思えた。

http://www.phppro.jp/article/framework/comparison.php

PHPフレームワークの機能比較/CakePHP,symfony,Zend Framework - PHPプロ！ via kwout

ちなみに、調べていたら、 symfony からのつながりで、Twig というテンプレートエンジンが気になった。一度、使ってみたい。

Twig via kwout

使用する CakePHP のバージョン

CakePHP のバージョンを確認したら、1.3.0 と 1.2.7 がリリースされている。1.3 はまだ出たばかりのようなので、今回は 1.2.7 を利用することにした。

CakePHP: 高速開発 php フレームワーク。 Home via kwout

現時点では、1.2 の方がドキュメントが充実している。

マニュアル :: 1.2 Collection :: The Cookbook

PDT へ CakePHP のソースコードをインポート

cakephp / cakephp1x より、1.2.7 をダウンロードして解凍。
PDT で新規に testCakePHP2 プロジェクトを作成。
解凍した CakePHP のソースコードを testCakePHP2 プロジェクトに D&D。
プロジェクトのプロパティで Resource > Text file encoding を UTF-8 に変更。

Apache の設定

Apache の httpd.conf で以下の記述がコメントアウトされているのを確認。 ( cf. Apacheとmod_rewrite )

LoadModule rewrite_module modules/mod_rewrite.so

テスト用のアプリケーションの設定のために以下の記述を追加。

Alias /testCakePHP2/ "C:/develop/tool/eclipse/workspace/testCakePHP2/"
<Directory "C:\develop\tool\eclipse\workspace\testCakePHP2/">
    Options FollowSymLinks 
    AllowOverride All
    Allow from All
</Directory>

ただし、PDT が利用する workspace は、

C:/develop/tool/eclipse/workspace/

であるとする。また、アプリケーションのルートの URL は、

http://localhost/testCakePHP2/

とする。上記の設定中 Options FollowSymLinks を有効にしているのは、Old Nabble - CakePHP - Forbidden Error によると、

In order for mod_rewrite to work you have to have:
Options FollowSymLinks
Put that right under the AllowOverride All and it should work. :)

CakePHP の .htaccess に RewriteBase を追加

次に CakePHP on XAMPP でちょっとはまった « 43HR を参考にして、PDT にインポートした CakePHP のソースコードの以下の各々のファイルに内容に RewriteBase を追加。

testCakePHP2/.htaccess に RewriteBase /testCakePHP2
testCakePHP2/app/.htaccess に RewriteBase /testCakePHP/app
testCakePHP2/app/webroot/.htaccess に RewriteBase /testCakePHP2/app/webroot

debugger.php の設定

これで http://localhost/testCakePHP2/ にアクセスすることができるようになった。ただし、以下の警告が表示される。

Notice (1024): Please change the value of 'Security.salt' in app/config/core.php to a salt value specific to your application [CORE\cake\libs\debugger.php, line 548]

CakePHPブログチュートリアル :: 開発例 :: マニュアル :: 1.2 Collection :: The Cookbook によると、

security saltは、ハッシュの生成に用いられます。/app/config/core.phpの153行目を編集し、デフォルトのsalt値を変更してください。

これにより、警告が消える。

3. MySQL の設定

今回は DB を使う予定はない。しかし、http://localhost/testCakePHP2/ にアクセスすると警告がでるので、ついでに DB の設定もしておく。

XAMPP のコントロールパネルで MySQL の Start ボタンを押す。

Admin ボタンで phpMyAdmin を起動。(phpMyAdmin を使いたくない場合は、MySQL Workbench を利用するとよい。)

「データベース」タブを選択し、新規にデータベース testcakephp を作成。

XAMPP の MySQLと PHP の説明によると、

MySQLは "root" に対するパスワード無しで起動します。したがってPHPではMySQLサーバを以下で接続できます： mysql_connect("localhost","root","")
MySQLの"root" に対するパスワードを設定したい場合は、コンソール（Console）の下の"mysqladmin"を使ってください。

testCakePHP2\app\config の database.php.default を database.php に名前を変更。 database.php で $default 変数のハッシュのキーに対する値において、