環境設定¶

Configureのメソッド¶

Configure::write('Company.name','株式会社ピザ');
Configure::write('Company.slogan','体と心にピザを');

Configure::write(
    'Company',array('name'=>'株式会社ピザ','slogan'=>'体と心にピザを')
);

Configure::read('Company.name');    //出力は: '株式会社ピザ'
Configure::read('Company.slogan');  //出力は: '体と心にピザを'

Configure::read('Company');

//出力は:
array('name' => '株式会社ピザ', 'slogan' => '体と心にピザを');

Configure::delete('Company.name');

// /app/config/messages.php:
<?php
$config['Company']['name'] = '株式会社ピザ';
$config['Company']['slogan'] = '体と心にピザを';
$config['Company']['phone'] = '555-55-55';
?>

<?php
Configure::load('messages');
Configure::read('Company.name');
?>

CakePHPコアの環境設定変数¶

Configure クラスは、CakePHP の一連の環境設定変数を管理するために使用されます。これらの変数は、app/config/core.php の中にあります。下記では、各変数の詳細と CakePHP アプリケーションにどのように影響するかを説明します。

環境変数設定

説明

debug

CakePHP のデバッグ出力を変更します。 0 = 運用モード。出力しません。 1 = エラーと警告を表示します。 2 = エラー、警告、SQLを表示します。 3 = エラー、警告、SQL、コントローラの完全なdumpを表示します。

App.baseUrl

CakePHP で Apache の mod_rewrite を使用しないのであれば、この定義のコメントアウトを外してください。.htaccess ファイルを削除するのも忘れないようにしてください。

Routing.admin

CakePHP の管理者ルート(admin routes)を活用する場合にはコメントアウトを外してください。使用したい管理者 route の名前をこの変数に設定してください。詳細は後述します。

Cache.disable

true に設定すると、サイト全体のキャッシュが無効になります。

Cache.check

true に設定すると、ビューのキャッシュが有効になります。有効にするためにコントローラ内の設定も必要ですが、この変数によって、これらの設定を調べるようになります。

Session.save

CakePHP がどのセッションストレージを使用するかを指定します。 php = PHP のデフォルトのセッションストレージを使用します。 cache = Cache::config() で設定されたキャッシュエンジンを使用する。キャッシュしたデータとセッションを格納するために、複数のアプリケーションサーバから使えるようセットアップした Memcache を利用する場合にとても便利です。 cake = セッションデータを /app/tmp に格納します。 database = セッションデータをデータベーステーブルの中に保存します。/app/config/sql/sessions.sql にある SQL ファイルを使用して、テーブルを設定しておいてください。

Session.table

セッション情報を保存するテーブル名(接頭辞(prefix)は含めません。)

Session.database

セッション情報を保存するデータベース名。

Session.cookie

セッションを追跡するのに用いられるクッキー名。

Session.timeout

セッションタイムアウトの基本時間を秒で指定します。実際の時間は、 Security.level に依存します。

Session.start

trueに設定すると、セッションが自動的に始まります。

Session.checkAgent

false に設定すると、リクエストの間にユーザエージェントが変更されていないかを CakePHP のセッションが確認しなくなります。

Security.level

CakePHP のセキュリティレベルを設定します。'Session.timeout' で設定されたセッションタイムアウトの基本時間に、この設定による値をかけたものが最終的な値になります。 有効な値： 'high' = x 10 'medium' = x 100 'low' = x 300 'high' と 'medium' は、両方とも session.referer_check が有効になります。 'Security.level' が 'high' にセットされていた場合、 CakePHP のセッション ID はリクエストごとに再生成されます。

Security.salt

セキュリティを考慮したハッシングのために利用されるランダムな文字列です。

Asset.timestamp

正規のヘルパーを使用する場合、個々のファイルの最終更新時刻のタイムスタンプをアセットファイル（CSS, JavaScript, 画像）のURLの最後に付与します。

有効な値:

(bool) false - 何もしない（デフォルト） (bool) true - debug > 0 のときタイムスタンプを付与する (string) 'force' - debug >= 0 のときタイムスタンプを付与する

Acl.classname, Acl.database

CakePHP の ACL(アクセス制御リスト)機能で利用される定数です。詳細はアクセス制御リストの章を見てください。

キャッシュの設定は、core.php にもあります。この点については後の章にもありますので参考にしてください。

Configure クラスは、サイトの動作中に、コアの環境設定を読み書きすることができます。たとえば、アプリケーションの中で、ある特定の部分だけデバッグ設定を変えたいというような場合などに特に便利です。

Configuration定数¶

ほとんどの環境設定はConfigureで行いますが、CakePHPが実行時に使用する定数がほかにもあります。

App::import()の使用¶

App::import($type, $name, $parent, $search, $file, $return)

初めて App::import を見ると複雑に見えるかもしれません。でも、多くの場合は２つの引数だけが必須になっています。

コアライブラリのインポート¶

SanitizeやXmlといったコアのライブラリは、次の方法で読み込みます。

<?php App::import('Core', 'Sanitize') ?>

これで、Sanitizeクラスが使えるようになります。

コントローラ、モデル、コンポーネント、ビヘイビア、ヘルパのインポート¶

アプリケーションに関連するすべてのクラスをApp::import()で読み込めます。以下の例を参照してください。

<?php
// これは、require('controllers/users_controller.php'); と同じです。
App::import('Controller', 'Users');

// クラスをロードします
$Users = new UsersController;

// モデルのアソシエーション、コンポーネントその他をロードするには次のようにします。
$Users->constructClasses();
?>

<?php
App::import('Component', 'Mailer');

// このクラスを読み込む必要がある
$Mailer = new MailerComponent();

?>

プラグインの読み込み¶

プラグインのクラスを読み込むのは、appとコアのクラスを読み込むのとほぼ同じです。しかし、読み込み元のプラグイン名を指定してください。

App::import('Model', 'PluginName.Comment');

APP/plugins/plugin_name/vendors/flickr/flickr.php を読み込むには、次のようにします：

App::import('Vendor', 'PluginName.flickr/flickr');

Vendor ファイルの読み込み¶

vendor() 関数は非推奨になりました。vendor ファイルはこれまでと同様に App::import() を使用して読み込むようになりました。構文はわずかに異なり、引数が追加されています。これは vendor ファイルの構造は大きく異なっていたり、すべての vendor ファイルにクラスが含まれているとは限らないためです。

以下は、いくつかのパス構造から vendor ファイルをどのように読み込むかという例です。vendor ファイルは、vendor フォルダにあると仮定します。

App::import('Vendor', 'geshi');

App::import('Vendor', 'flickr/flickr');

App::import('Vendor', 'SomeName', array('file' => 'some.name.php'));

App::import('Vendor', 'WellNamed', array('file' => 'services'.DS.'well.named.php'));

App::import('Vendor', 'aUniqueIdentifier', array('file' =>'vendorName'.DS.'libFile.php'));

デフォルトのルーティング¶

独自のルートを設定する前に、CakePHP のデフォルトのルートについて知っておく必要があります。CakePHP のデフォルトルーティングによって、どんなアプリケーションでもうまく動くようになっています。URL の中に、アクション名を置くことで、アクションに直接アクセスすることができます。コントローラのアクションに URL を使うことでパラメータを渡すこともできます。

デフォルトのroutesのURLパターン：
http://example.com/コントローラ名/アクション名/パラメータ１/パラメータ２/パラメータ３

/posts/view という URL は、PostsController の view() アクションにマップされます。 /products/view_clearance は、ProductsController の viewClearance() アクションにマップされます。URL でアクション名が指定されていない場合には、index() メソッドが用いられます。

デフォルトのルーティングでは、URLを使ってアクションにパラメータを渡すこともできます。例えば、/posts/view/25 というリクエストは、PostsController 上で view(25) として呼ぶのと同じことになります。

名前付きのパラメータ¶

CakePHP 1.2 の新機能には、パラメータに名前を付けられる、というものがあります。URL を使ってパラメータに名前を付けて、その値を渡すことができます。/posts/view/title:first+post/category:generalというリクエストでは、PostsController の view() アクションが呼ばれます。このアクションでは、title と category というパラメータの値を、それぞれ、$this->passedArgs[‘title’] と $this->passedArgs[‘category’] として受け取ることができます。

参考例としていくつか挙げてみます。

デフォルトのルーティングを使用した、URL からコントローラへのアクションマッピング：

URL: /monkeys/jump
Mapping: MonkeysController->jump();

URL: /products
Mapping: ProductsController->index();

URL: /tasks/view/45
Mapping: TasksController->view(45);

URL: /donations/view/recent/2001
Mapping: DonationsController->view('recent', '2001');

URL: /contents/view/chapter:models/section:associations
Mapping: ContentsController->view();
$this->passedArgs['chapter'] = 'models';
$this->passedArgs['section'] = 'associations';

Routes の定義¶

独自ルートの定義により、アプリケーションを指定した URL で動作させることができるようになります。独自のルーティングは、/app/config/routes.php ファイルで Router::connect() メソッドを使用して定義します。

connect() メソッドは３つのパラメータからなっています。対応させたい URL、独自のルート要素のデフォルトの値、要素と対応させるための正規表現ルールです。

ルート定義の基本的な形式は次のようになります。：

Router::connect(
    'URL',
    array('paramName' => 'デフォルト値'),
    array('paramName' => '正規表現')
)

最初のパラメータで、制御する URL をルータに伝えます。URL は、通常のスラッシュで分けられた文字列です。しかし、ワイルドカード(*)や、独自の route 要素(コロンで始まる変数名)を含むことができます。ワイルドカードで対応させたい URL を指定し、route 要素の指定で、コントローラアクションのためのパラメータを集めることができます。

URLを指定した後、connect() の次の２つのパラメータを使って、リクエストが対応した場合に何を行うのかを CakePHP に伝えます。2番目のパラメータは連想配列です。配列のキーは、URL の route 要素にちなんだものか、デフォルト要素（:controller, :action, :plugin）にしてください。配列内の値は、それらのキーに対するデフォルト値です。connect() の3番目のパラメータを考える前に、基本的な例をいくつか見てみましょう。

Router::connect(
    '/pages/*',
    array('controller' => 'pages', 'action' => 'display')
);

CakePHP の routes.php ファイルの中（40行目）に、このルートが書かれています。このルートは、/pages/ ではじまるすべての URL にマッチし、それを PagesController(); の display() メソッドに渡します。例えば、 /pages/products というリクエストは、PagesController->display('products') にマップされます。

Router::connect(
    '/government',
    array('controller' => 'products', 'action' => 'display', 5)
);

この2つ目の例は、connect() の2番目のパラメータでデフォルトパラメータを定義する方法を示しています。それぞれのお客様向けに異なる製品がある場合などに route を作成することを考えることができるでしょう。この例では、/products/display/5 としなくても、/government という URL でアクセスできるようになります。

一般的な Router の他の使い方は、コントローラの別名(alias)を定義することです。通常の /users/someAction/5 という URL の代わりに、/cooks/someAction/5 でアクセスさせたいとしましょう。このようなルートの設定は、次のようにすることで簡単に実現できます。

Router::connect(
    '/cooks/:action/*', array('controller' => 'users', 'action' => 'index')
);

この設定は、 Router が /cooks/ で始まる URL を、全て users コントローラに送ることを表しています。

URL が生成されるときも、ルートの設定が適用されます。上述の例にあるルートが最初にマッチした場合、URL として array('controller' => 'users', 'action' => 'someAction', 5) のように指定すると、/cooks/someAction/5 というURL が生成されます。

ルートの中で独自の名前を持つパラメータを使うつもりならば、Router::connectNamed を用いて Router にそれを伝える必要があります。上述の例にあるルートに /cooks/someAction/type:chef のようなURLをマッチさせたい場合は、次のようにします。

Router::connectNamed(array('type'));
Router::connect(
    '/cooks/:action/*', array('controller' => 'users', 'action' => 'index')
);

さらに柔軟な追加機能として、カスタム route 要素を指定できます。この機能により、コントローラアクション用のパラメータが、URL のどこにあるのかを定義できるようになります。リクエストがあると、このカスタム route 要素は、コントローラの $this->params の中に入ります。これは、パラメータに名前を付けるのとは異なる仕方で扱われます。違いに注意してください。パラメータに名前を付けた（/コントローラ/アクション/名前:値）ものは、$this->passedArgs の中に入りますが、カスタム route 要素のデータは、$this->params の中に入ります。カスタム route 要素を定義する際には、正規表現によって、URL が正しく作られているか、作られていないかを CakePHP が判断できるようにします。

Router::connect(
    '/:controller/:id',
    array('action' => 'view'),
    array('id' => '[0-9]+')
);

これは、/コントローラ名/id という形で、どんなコントローラからでもモデルを表示（view）できるようにする例です。connect() に指定されている URL には２つの route 要素があります。controller と :id です。:controller 要素は、CakePHP のデフォルト route 要素です。ルータは URL 内のコントローラ名を見つけることができます。:id 要素はカスタム route 要素なので、connect() の３番目のパラメータ内の正規表現で、どうやってマッチさせるのかを明示する必要があります。こうすることで、CakePHP はアクション名ではないと区別でき、URL 内の ID を見つけることができます。

この route が定義されると、/apples/5 というリクエストは、/apples/view/5 としたのと同じことになります。どちらも、ApplesController の view() メソッドを呼びます。view() メソッド内では、$this->params['id'] を使って渡された ID を知ることができます。

この例も知れば、routing の達人です。

Router::connect(
    '/:controller/:year/:month/:day',
    array('action' => 'index', 'day' => null),
    array(
        'year' => '[12][0-9]{3}',
        'month' => '0[1-9]|1[012]',
        'day' => '0[1-9]|[12][0-9]|3[01]'
    )
);

ややこしいものですが、route が非常に強力であることを示す例です。この URL では、4つの要素があります。最初のものはよく知っているもので、まずコントローラ名が来ることを CakePHP に伝えます。

次に、いくつかのデフォルト値を指定します。コントローラ名に関係なく、index() アクションが呼ばれるようにします。そして、day パラメーター（URL の４つ目の要素）のデフォルト値を null として、これがオプションであることを設定します。

最後に、年(year)、月(month)、日(day)の数値にマッチする正規表現を指定します。

設定すると、この route は、/articles/2007/02/01、/posts/2004/11/16、/products/2001/05 （day パラメータは、オプション）といった URL にマッチするようになります。対応するコントローラの index() アクションに渡し、$this->params の中にはカスタム指定した日付パラメータを入れます。

アクションにパラメータを渡す¶

アクション(action)が次のように定義されていて、$this->params['id'] の代わりに $articleID を使用して引数を受け取りたいと仮定します。ただ、Router::connect() の第３引数に特別な配列(array)を追加するだけです。

// some_controller.php
function view($articleID = null, $slug = null) {
    // ここに何かしらコードを書く
}

// routes.php
Router::connect(
    // E.g. /blog/3-CakePHP_Rocks
    '/blog/:id-:slug',
    array('controller' => 'blog', 'action' => 'view'),
    array(
        // これは単にアクション(action)で ":id" を $articleID にマッピングするため、順番は重要です。
        'pass' => array('id', 'slug'),
        'id' => '[0-9]+'
    )
)

これで逆のルーティング機能が追加されたので、以下のように url 配列に渡すことができます。ルートで定義されているので、 Cake は URL をどのように作成したらよいかがわかっています。

// view.ctp
// これは /blog/3-CakePHP_Rocks へのリンクを返すでしょう
<?= $html->link('CakePHP Rocks', array(
    'controller' => 'blog',
    'action' => 'view',
    'id' => 3,
    'slug' => Inflector::slug('CakePHP Rocks')
)) ?>

プレフィックスルーティング(Prefix Routing)¶

たいていのアプリケーションには、権限のあるユーザだけが情報を変更できる管理画面が必要です。そのために /admin/users/edit/5 のような特別な URL を準備することがよくあります。CakePHP では、コア設定ファイル内の Routing.admin に管理パスを設定して admin ルーティングを有効にできます。

Configure::write('Routing.admin', 'admin');

コントローラ(controller)内では、プレフィックスとして admin_ をメソッドの前につけたすべてのアクション(action)が呼び出されます。users を例にすると、/admin/users/edit/5 というURLへのアクセスで、UsersController の admin_edit メソッドが、引数5で呼び出されます。このビューファイルはapp/views/users/admin_edit.ctpとなります。

URL /admin を、pagesコントローラの admin_indexアクションにマップするには次のような route を使います。

Router::connect('/admin', array('controller' => 'pages', 'action' => 'index', 'admin' => true));

複数のプレフィックスを使うように Router を設定することもできます。

Router::connect('/profiles/:controller/:action/*', array('prefix' => 'profiles', 'profiles' => true));

profiles に対するすべての呼び出しは、profiles_ プレフィックスのついたメソッドを探して呼び出します。usersを例にとると、/profiles/users/edit/5 などの構造を持つURLは、UsersController の profiles_edit メソッドを呼び出します。

:controllerと似ている:prefixという名前のエレメントを使って、ワイルドカードプレフィックスルーティングをすることができます。以下のルートを使えば、apiコントローラのuser_createアクションに、/api/user/createというURLをマッピングすることができます。

Router::connect('/api/:prefix/:action', array('controller' => 'api'));

その他、apiコントローラのquestion_createアクションに/api/question/create、apiコントローラのquestion_editアクションに/api/question/editをマッピングすることもできます。

また、重要な点として、HTML ヘルパーを使用してリンクを作成するなら、プレフィックスを用いた呼び出しの管理も楽になります。HTML ヘルパーを使ったリンクの例は次のようになります。

echo $html->link('Edit your profile', array('profiles' => true, 'controller' => 'users', 'action' => 'edit', 'id' => 5));

この方法を使うと、複数のプレフィックスルートを定義することができ、柔軟な URL 構造を持つアプリケーションを作成できます。

Plugin routing¶

Plugin routing uses the plugin key. You can create links that point to a plugin by adding the plugin key to your url array.

echo $html->link('New todo', array('plugin' => 'todo', 'controller' => 'todo_items', 'action' => 'create'));

Conversely if the active request is a plugin request and you want to create a link that has no plugin you can do the following.

echo $html->link('New todo', array('plugin' => null, 'controller' => 'users', 'action' => 'profile'));

By setting plugin => null you tell the Router that you want to create a link that is not part of a plugin.

File extensions¶

To handle different file extensions with your routes, you need one extra line in your routes config file:

Router::parseExtensions('html', 'rss');

This will tell the router to remove any matching file extensions, and then parse what remains.

If you want to create a URL such as /page/title-of-page.html you would create your route as illustrated below:

Router::connect(
    '/page/:title',
    array('controller' => 'pages', 'action' => 'view'),
    array(
        'pass' => array('title')
    )
);

Then to create links which map back to the routes simply use:

$html->link('Link title', array('controller' => 'pages', 'action' => 'view', 'title' => Inflector::slug('text to slug', '-'), 'ext' => 'html'))