この関数はPHPのmagic_quotes_gpcがonの場合でも問題なく動作させるために使用されています。

if (ini_get('magic_quotes_gpc') == 1) {
    if (!empty($_POST)) {
        $params['form'] = stripslashes_deep($_POST);
    }
} else {
    $params['form'] = $_POST;
}

ここで、magic_quotes_gpcがonの場合に、裏でどんな処理が行われるのかをおさらいしておきます。
マニュアルによると

オンの場合、全ての’ (シングルクオート), ” (ダブルクオート), \ (バックスラッシュ)および
NULL 文字がバックスラッシュで自動的にエスケープされます。 これは、addslashes() の機能と同じです。

つまり、「Is your name O’reilly?」は、「Is your name O\’reilly?」に自動的に変換されるわけです。
この変換処理はHTTPリクエストデータ(GET, POST, そして COOKIE)に対して行われます。

そして、この変換されてしまったデータを元に戻すために使用されるのがstripslashes_deep()関数です。
この関数は「cake/basics.php」内に定義されています。

function stripslashes_deep($value) {
    if (is_array($value)) {
        $return = array_map('stripslashes_deep', $value);
        return $return;
    } else {
        $return = stripslashes($value);
        return $return ;
    }
}

引数が配列で無い場合と、配列の場合で処理が分かれています。

まずは配列で無い場合ですが、stripslashes関数で変換した値を返して終了しています。
stripslashes関数はmagic_quotes_gpcが行う変換処理の反対の変換を、つまり
「Is your name O\’reilly?」であれば、「Is your name O’reilly?」に変換します。

次は配列の場合の処理を見てみます。

まずarray_mapですが、これは第一引数で指定されている関数を、第二引数の配列の各値を引数にして呼び出す関数です。
ここでポイントになるのはarray_map内でstripslashes_deep関数を、つまり自分自身を関数内で呼び出している点です。
これは再帰関数と呼ばれるものになりますが、初めはなぜ「stripslashes」でなく「stripslashes_deep」を呼び出す必要があるのか疑問でした。
ただし、よくよく考えてみると配列の中身も配列、更にその中身も配列の可能性が…と考えると「なるほど再帰関数ってこういう
使い方をするのか」と感心してしまいました。

この関数を作った人が関数名に「_deep」と付けたのもうなづけます。
再帰関数を理解するのにうってつけのお手本ではないでしょうか。

以前解析したように$Route->parse(’users/login/aaaa/bbbb/cccc/dddd?a=A&b=B’)の戻り値は
下記のような配列になります。

Array
(
	[pass] => Array
	(
		[0] => aaaa
		[1] => bbbb
		[2] => cccc
		[3] => dddd
	)
	[controller] => users
	[action] => login
)

この結果を$params変数が受け取っているわけですが、この$params変数は「$this->data」を保持する非常に重要な変数です。
下記のようにその後の処理でform値やurl値を取り込んでいます。

if (ini_get('magic_quotes_gpc') == 1) {
	if (!empty($_POST)) {
		$params['form'] = stripslashes_deep($_POST);
	}
} else {
	$params['form'] = $_POST;
}

次回はこの処理の中で使用されている「stripslashes_deep」関数を解析します。

一体どんな値を入れているのかだけ、出力して終了(>_<)
CakePHPのよく理解している人なら見当がつくのかな。

Router Object
(
 [routes] => Array
  (
   [0] => Array
    (
     [0] => /
     [1] => /^[\/]*$/
     [2] => Array
      (
      )

     [3] => Array
      (
       [controller] => schedules
       [action] => index
      )
    )

   [1] => Array
    (
     [0] => /pages/*
     [1] => #^/pages(?:\/(.*))?[\/]*$#
     [2] => Array
      (
      )
     [3] => Array
      (
       [controller] => pages
       [action] => display
      )
    )

   [2] => Array
    (
     [0] => /tests
     [1] => #^/tests[\/]*$#
     [2] => Array
      (
      )
     [3] => Array
      (
       [controller] => tests
       [action] => index
      )
    )

   [3] => Array
    (
     [0] => /bare/:controller/:action/*
     [1] => #^/bare(?:\/([^\/]+))?(?:\/([^\/]+))?(?:\/(.*))?[\/]*$#
     [2] => Array
      (
       [0] => controller
       [1] => action
      )
     [3] => Array
      (
       [bare] => 1
      )
    )

   [4] => Array
    (
     [0] => /ajax/:controller/:action/*
     [1] => #^/ajax(?:\/([^\/]+))?(?:\/([^\/]+))?(?:\/(.*))?[\/]*$#
     [2] => Array
      (
       [0] => controller
       [1] => action
      )
     [3] => Array
      (
       [bare] => 1
      )
    )

   [5] => Array
    (
     [0] => /:controller/:action/* (default)
     [1] => /^(?:\/(?:([a-zA-Z0-9_\-\.\;\:]+)(?:\/([a-zA-Z0-9_\-\.\;\:]+)(?:[\/\?](.*))?)?))[\/]*$/
     [2] => Array
      (
       [0] => controller
       [1] => action
      )
     [3] => Array
      (
      )
    )
  )

 [__admin] =>
 [_log] =>
)

追記
$route配列をよくよく観察してみると、CakePHPの遷移処理を管理しているように見えますね。
下記の例だと

[0] => /
[1] => /^[\/]*$/
[2] => Array
    (
    )
[3] => Array
    (
        [controller] => schedules
        [action] => index
    )

おそらく[0]がルートパスを表していて、[1]が遷移に関する正規表現？、[2]はひとまず置いといて
[3]は実行するコントローラーとアクション。

[1]の正規表現は何を意味しているんだろう？
「/^[\/]*$/」にマッチするのって「/」とか「///」みたいに、ひたすらスラッシュの文字列だけのように思うんだけど。
もう少しCakePHP理解しないと、分からないかな。

$Dispatcher = new Dispatcher();
$Dispatcher->dispatch($url);

で、dispatcher.phpでは引数の$url変数をプライベートメソッドで何かしています。

$params = array_merge($this->parseParams($url), $additionalParams);

parseParams()メソッドの動きを追ってみます。
すると今度はRouteクラスのparseメソッドに引き渡されました。

$Route = new Router();
include CONFIGS.'routes.php';
$params = $Route->parse ($from_url);

しつこく、Routeクラスが定義されている「cake/libs/router.php」を追ってみます。
これまた、複雑そうな処理がずらずら出てきてしまいました。
なんか、面倒になってきたので一旦この辺で区切ろうと思います。

ちなみに適当なファイルに下記のような処理をほどこしたところ…

$Route = new Router();
include CONFIGS.'routes.php';
$params = $Route->parse ('users/login/aaaa/bbbb/cccc/dddd?a=A&b=B');

pr($params);    //結果出力

このような結果が返ってきました。

Array
(
    [pass] => Array
        (
            [0] => aaaa
            [1] => bbbb
            [2] => cccc
            [3] => dddd
        )
    [controller] => users
    [action] => login
)

次回は、更につっこんで解析してみます。

setUri()

function setUri() {
	if (env('HTTP_X_REWRITE_URL')) {
		$uri = env('HTTP_X_REWRITE_URL');
	} elseif (env('REQUEST_URI')) {
		$uri = env('REQUEST_URI');
	} else {
		if (env('argv')) {
			$uri = env('argv');

			if (defined('SERVER_IIS')) {
				$uri = BASE_URL . $uri[0];
			} else {
				$uri = env('PHP_SELF') . '/' . $uri[0];
			}
		} else {
			$uri = env('PHP_SELF') . '/' . env('QUERY_STRING');
		}
	}
	return $uri;
}

簡単なif文のプログラムですね。
ポイントになるのは「env」が何を返しているかということでしょう。この「env」も「basics.php」内に定義されており、引数に応じて$_SERVERや$_ENVの値を返しています。

ここで、setUriはリクエストされたURIを環境に応じて返しているようです。環境というのは、「mod_rewriteを使える／使えない」とか「サーバーがApache／IIS」とか。

$uriと$_GET['url']の値をセット

最終的に呼び出しもとの「bootstrap.php」で「?=」以降の値を$uri変数と$_GET['url']変数に格納しているようですね。

$uri = setUri();

if ($uri === '/' || $uri === '/index.php' || $uri === '/'.APP_DIR.'/') {
	$_GET['url'] = '/';
	$url = '/';
} else {
	if (strpos($uri, 'index.php') !== false) {
		$uri = r('?', '', $uri);
		$elements=explode('/index.php', $uri);
	} else {
		$elements = explode('/?', $uri);
	}

	if (!empty($elements[1])) {
		$_GET['url'] = $elements[1];
		$url = $elements[1];
	} else {
		$_GET['url'] = '/';
		$url = '/';
	}
}

この後、$uriをコントローラー名、アクション名に分解していろいろやっていくんだろうなぁ。

次回は「cake/dispatcher.php」を解析する予定です。

bootstrap.phpから、&getInstanceメソッドが呼び出されていますね。このメソッドの中身は下記のとおり。

function &getInstance() {
	static $instance = array();
	if (!$instance) {
		$instance[0] =& new Configure;
		$instance[0]->__loadBootstrap();
	}
	return $instance[0];
}

PHP4のSingletonの挙動については、前回のエントリーで書いたので省略。ちょっと分からないのは、呼び出し元が次のようにしているところ。

$paths = Configure::getInstance();

「::」はインスタンス化無しでstaticなメソッドを実行ということなんだろうけど、PHP4の場合は戻り値の変数がstatic宣言されていれば、そのメソッドはstaticなメソッドでみなされるのかな？
うーん、よく分からん。次に進めちゃいます。

次は「__loadBootstrap()」ですが、これはConfigureクラスの一番下に定義されています。中身をみると自分で自分を初期化しているって感じかな。途中で「app/config/bootstrap.php」を読み込んでいますね。

この「app/config/bootstrap.php」ファイルはどうやら、作り手に対して「アプリケーション全体のグローバルな定数や関数を定義したり、または、それらが定義されているファイルを読み込みなよっ」て言っているんだと思います。

次回はConfigureクラスをもうちょっと突っ込んで解析してみたいと思います。

まずは↓から。

require LIBS . 'configure.php';
$paths = Configure::getInstance();

cake/libs内のconfigure.phpを読み込んだ後、インスタンスを取得しています。getInstance()から、Singleton（シングルトン）であることが分かります。PHP4のシングルトンの解説は下記のサイトが分かりやすいです。

PHP4でデザインパターン（Singleton編）

また、&getInstance()メソッドの「&」や「&=」の意味は「てくめも@coop」さんのサイトに解説が載っています。

PHP4 と PHP5 の Sigleton Pattern

ソッド定義とメソッド呼び出しの両方に & を付けないと、参照でなくコピーになってしまい…

今日はあまり時間がないので、ここまでorz

次回はbootstrap.phpが「Configure」インスタンスで何をしているのか解析したいと思います。

<IfModule mod_rewrite.c>
	RewriteEngine On
	RewriteCond %{REQUEST_FILENAME} !-d
	RewriteCond %{REQUEST_FILENAME} !-f
	RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]
	</IfModule>

RewriteCond

RewriteCondはURLをRewriteする条件になります。
「%{REQUEST_FILENAME}」は「要求したファイル名(フォルダ名)が」という意味。
URL指定で、「/app/webroot/aaa」ならば「aaa」がそれに当たります。
そして「!-d」は、この例であれば「aaa」というフォルダが存在するのであればRewriteしない。「!-f」はファイルが存在するのであればRewriteしないということになります。
この処理については、phaさんが自習室で詳しくまとめられています。

RewriteRuleをいろいろ試す会：RewriteCondを使う

QSAとは？

次にRewriteRule ^(.*)$ index.php?url=$1 [QSA,L]ですが、
URL書き換え部分は(.*)が$1に書き換わります。
「/app/webroot/aaa」でアクセスしたら、「/app/webroot/index.php?url=aaa」となります。
後にくっついている[QSA,L]の「QSA」の意味ですが、とみぞーノートさんのサイトに詳しくまとめられています。

mod_rewrite – QSAフラグ

次回は「cake/bootstrap.php」を解説したいと思います。

/.htaccess（app/.htaccessもほぼ同じ内容）

<IfModule mod_rewrite.c>
   RewriteEngine on
   RewriteRule    ^$ app/webroot/    [L]
   RewriteRule    (.*) app/webroot/$1 [L]
</IfModule>

<IfModule mod_rewrite.c>～</IfModule>

まずは、<IfModule mod_rewrite.c>～</IfModule>ですが、これはmod_rewriteモジュールが有効かどうか調べて、有効であれば中身の処理を実行するという意味です。

RewriteEngine on以下

次に中身の解説ですが、こちらの技林さんのサイトの解説が凄く分かりやすいです。この処理でapp/webroot/に飛ばしているわけですね。
mod_rewrite

正規表現は欠かせません

また、mod_rewriteを知る上で正規表現の知識は欠かせません。自分の正規表現入門お薦めサイトはこちらのサイトです。
サルにもわかる正規表現入門

更に正規表現を理解したい人はやはり「フクロウ本」を読むことをお奨めします。

詳説 正規表現 第3版

posted with amazlet at 08.09.21

Jeffrey E.F. Friedl
オライリージャパン
売り上げランキング: 32534

おすすめ度の平均:

正規表現を確実にマスターできる
DOSのコマンドのような簡単なものから

Amazon.co.jp で詳細を見る

[L]って何？

これまた、技林さんのサイトの解説が分かりやすいです。

mod_rewrite サンプル集

[L]を指定している所でマッチしたら、それ以降のマッチング処理をしないということですね。

(.*) app/webroot/$1だけで良くね？

と思って、ローカル環境で^$ app/webroot/を外して試してみましたが普通に動きました。うーん、でもやっぱ何かしらの理由があるんだろうな…。誰か分かる方いらっしゃいましたら教えてください(><)

次のエントリーでは「app/webroot/.htaccess」を解説したいと思います。

if (!defined('CORE_PATH')) {
	if (function_exists('ini_set')) {
		ini_set('include_path',
 CAKE_CORE_INCLUDE_PATH . PATH_SEPARATOR . ROOT . DS .
 APP_DIR . DS . PATH_SEPARATOR . ini_get('include_path'));
		define('APP_PATH', null);
		define('CORE_PATH', null);
	} else {
		define('APP_PATH', ROOT . DS . APP_DIR . DS);
		define('CORE_PATH', CAKE_CORE_INCLUDE_PATH . DS);
	}
}

で、include_pathってなんぞや？ってなるわけですが、こちらのデジットさんの説明がとっても分かりやすいです。

デジットさんのPHPのinclude_path

ここが重要ですね。探す順番。

PHP実行ファイルからrequire()、include()等で読み出されるファイルは、次の順番で探されます。

1. include_pathで設定されているディレクトリ
2. 実行しているファイルのあるディレクトリ
3. ./ 又は ../ で始まっている場合は、 実行しているファイルのあるディレクトリからの相対パス

更に、require()、include()されたファイル（例えば「inc.php」）の中にrequire()、include()がある場合は、当然上記のディレクトリを探した後に「inc.php」ファイルがあるディレクトリも探します。

自分の環境で「var_dump(ini_get(’include_path’));」としてみたところ次のように出力されました。

string(57) “C:\www\schedule;C:\www\schedule\app\;.;C:\xampp\php\pear\”

CakePHPのフォルダを配置した場所が「C:\www\schedule」なので、CakePHPのルートに当たるディレクトリとその下層の「app」フォルダがinclude_pathに追加されたようです。ちなみに「.;C:\xampp\php\pear\」はphp.iniファイルに設定されていました。

このinclude_pathの設定により、requireやincludeでいちいち相対パスを指定する必要が無くなるわけですね。include_pathの概念がよく分かってなかったので早速勉強になりました。