応用インストール¶

PEAR インストーラで CakePHP をインストール¶

CakePHP はあなたが PEAR インストーラを使用してインストールできるように PEAR パッケージを公開しています。PEAR インストーラでインストールすると、 複数のアプリケーションで CakePHP ライブラリを共有するのが簡単になります。 PEAR で CakePHP をインストールするには、次の手順を実行する必要があります。

pear channel-discover pear.cakephp.org
pear install cakephp/CakePHP

PEAR で CakePHP をインストールした後、PEAR が正しく設定されていれば、 新しいアプリケーションを作成するために cake コマンドが使えるようになっています。 CakePHP は PHP の include_path 上に配置されるので、とくに他の変更を行う必要はありません。

Composer で CakePHP をインストール¶

始める前に、最新の PHP バージョンであることを確認してください。

php -v

少なくとも PHP 5.3.0 (CLI) 以上がインストールされていなければなりません。 ウェブサーバー版の PHP もまた 5.3.0 以上でなければりませんし、 コマンドラインインターフェース (CLI) 版の PHP と同じバージョンがベストです。

{
    "name": "example-app",
    "require": {
        "cakephp/cakephp": "2.10.*"
    },
    "config": {
        "vendor-dir": "Vendor/"
    }
}

$ php composer.phar install

example-app/
    composer.phar
    composer.json
    Vendor/
        bin/
        autoload.php
        composer/
        cakephp/

$ Vendor/bin/cake bake project <path to project>

define(
    'CAKE_CORE_INCLUDE_PATH',
    ROOT . DS . APP_DIR . DS . 'Vendor' . DS . 'cakephp' . DS . 'cakephp' . DS . 'lib'
);

// Composer の autoload を読み込み
require APP . 'Vendor/autoload.php';

// CakePHP のオートローダーをいったん削除し、Composer より先に評価されるように先頭に追加する
// http://goo.gl/kKVJO7 を参照
spl_autoload_unregister(array('App', 'load'));
spl_autoload_register(array('App', 'load'), true, true);

複数のアプリケーションで CakePHP を共有する¶

時には、CakePHP のディレクトリをファイルシステムの別な場所に配置したいと思う場合があるかもしれません。 共有しているホストの制限であったり、複数のアプリが同じ CakePHP のライブラリを共有したい場合などです。 このセクションでは、どうやって CakePHP のディレクトリをファイルシステム内に分散配置できるのかを説明します。

まず、CakePHP アプリケーションには三つの主要な部分があることを意識しましょう:

1. CakePHP のコアライブラリは、 /lib/Cake の中です。

2. アプリケーションコードは、/app の中です。

3. アプリケーションのウェブルートは、通常 /app/webroot の中です。

webroot を除く各ディレクトリは、 ファイルシステム内のどこにでも配置できます。 これらは Web サーバからアクセスできるようにする必要があります。 また、 CakePHP に場所を知らせれば、 webroot フォルダを app フォルダの外に移すことができます。

CakePHP インストールの環境設定をするには、以下のファイルを少し修正する必要があります。

• /app/webroot/index.php

• /app/webroot/test.php ( テスト 機能を使う場合。)

編集しなくてはいけない三つの定数は、 ROOT 、 APP_DIR 、 CAKE_CORE_INCLUDE_PATH です。

• ROOT には、アプリのフォルダが含まれているディレクトリのパスを設定します。

• APP_DIR には、（訳注：相対的な）アプリのフォルダ名を設定します。

• CAKE_CORE_INCLUDE_PATH には、CakePHP ライブラリフォルダのパスを設定します。

例を挙げて、応用インストールを実践した場合の様子を見てみましょう。 CakePHP を次のような条件で動作させたいとします:

• CakePHP のコアライブラリは /usr/lib/cake に配置する。

• アプリケーションの webroot ディレクトリは /var/www/mysite/ にする。

• アプリケーションのアプリディレクトリは /home/me/myapp にする。

このようなセットアップの場合には、 webroot/index.php ファイル（つまり、この例では /var/www/mysite/index.php）が次のようになるよう、編集します。

// /app/webroot/index.php (一部分。コメントは取り除いてあります。)

if (!defined('ROOT')) {
    define('ROOT', DS . 'home' . DS . 'me');
}

if (!defined('APP_DIR')) {
    define ('APP_DIR', 'myapp');
}

if (!defined('CAKE_CORE_INCLUDE_PATH')) {
    define('CAKE_CORE_INCLUDE_PATH', DS . 'usr' . DS . 'lib');
}

ファイルパスの区切り文字には、スラッシュではなく DS 定数を使うのがオススメです。 こうしておくと、間違った区切り文字による、ファイルが無いというエラーを防ぐことができ、コードをさまざまなプラットフォームで動くようにすることができます。

Apache と mod_rewrite (と .htaccess)¶

この章は URLリライティング に移動しました。