インストール

CakePHP は素早く簡単にインストールできます。 最小構成で必要なものは、ウェブサーバと CakePHP のコピー、それだけです! このマニュアルでは主に(最も一般的である) Apache でのセットアップに主眼を置いていますが、 CakePHP を lighttpd や Microsoft IIS のような様々なウェブサーバで走らせるよう設定することもできます。

システム要件

  • HTTPサーバー。例: Apache。mod_rewriteが推奨されますが、必須ではありません。

  • PHP 5.3.0 以上 (CakePHP バージョン 2.6 以下は、 PHP 5.2.8 以上をサポートします) 。 CakePHP バージョン 2.8.0 以上は PHP 7 をサポートします。 PHP 7.1 以上を使用するためには、 PECL 経由で mcrypt をインストールする必要があります。詳しくは、 Security をご覧ください。

技術的にはデータベースエンジンは必ずしも必要ではありませんが、ほとんどのアプリケーションはこれを活用することが想像できます。 CakePHPは種々のデータベース・ストレージのエンジンをサポートしています:

  • MySQL (4以上)

  • PostgreSQL

  • Microsoft SQL Server

  • SQLite

注釈

組み込みのドライバは全てPDOを必要とします。 正しいPDO拡張モジュールがインストールされているか必ず確かめてください。

ライセンス

CakePHPはMIT Licenseの元にライセンスされています。 これは著作権(copyright)の提示が全く改変されていない状態で残されているという条件の元で、ソースコードを自由に更新、配布、再公開できることを意味します。 また、自由にCakePHPを宣伝やクローズソースのアプリケーションに組み込むこともできます。

CakePHPのダウンロード

CakePHP の最新版を手に入れるには、主に二つの方法があります。 ウェブサイトからアーカイブ(zip/tar.gz/tar.bz2)としてダウンロードする、あるいは git リポジトリからコードをチェックアウトする方法のいずれかにより取得できます。

最新のアーカイブをダウンロードするには、 https://cakephp.org のウェブサイトに行き、 "Download" というリンクに従って進みます。

CakePHP の最新のリリースは GitHub でホスティングされています。 GitHubにはCakePHP自身、また多くのCakePHPプラグインが含まれています。 CakePHPのリリースは GitHub tags で入手できます。

他の手段を用いて、バグ修正や日ごとに行われる細かな機能追加が含まれた、できたてホヤホヤのコードを手に入れることができます。 これらは GitHub からレポジトリを複製することでアクセスすることができます

git clone -b 2.x git://github.com/cakephp/cakephp.git

パーミッション

CakePHP は、幾つかの操作のために app/tmp ディレクトリを使用します。 モデルのdescriptionや、ビューのキャッシュ、セッション情報などです。

従って、 CakePHP のインストール時の app/tmp ディレクトリと、そのサブディレクトリ全てに、ウェブサーバーのユーザによる書き込み権限があることを確認してください。

一般的な課題として、app/tmp ディレクトリとサブディレクトリは、ウェブサーバとコマンドラインユーザの両方で書き込み権限が必要なことがあります。 UNIXシステム上で ウェブサーバユーザとコマンドラインユーザが異なる場合、パーミッションのプロパティ設定を確保するために、あなたのプロジェクト内で一度だけ以下のコマンドを実行してください。

HTTPDUSER=`ps aux | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\  -f1`
setfacl -R -m u:${HTTPDUSER}:rwx app/tmp
setfacl -R -d -m u:${HTTPDUSER}:rwx app/tmp

設定

CakePHP のインストールは、ウェブサーバのドキュメントルートに放り込むだけの簡単インストールから、好きなだけ複雑かつ柔軟に設定することまでもできます。 このセクションでは、CakePHPの3種類の主なインストール方法: 開発、運用、応用について説明します。

  • 開発(Development): 簡単にはじめることができますが、アプリケーションのURLには、CakePHPをインストールしたディレクトリ名が入ります。 他の設定と比べるとセキュリティ面はやや弱くなります。

  • 運用(Production): ウェブサーバのドキュメントルートを設定できる必要がありますが、URLをクリーンにでき、セキュリティを固くできます。

  • 応用(Advanced): 幾つかの設定により、CakePHPの重要な各ディレクトリをファイルシステムの異なる場所に配置することができるので、 多くのCakePHPアプリケーションがひとつのCakePHPコアライブラリのフォルダを共有することなどが可能です。

開発(Development)

開発用のインストールは CakePHP をセットアップする最も早い方法です。 この例では CakePHP をインストールし、 http://www.example.com/cake_2_0/ でアクセスできるようにする方法を説明します。 ドキュメントルートは /var/www/html であると仮定します。

CakePHP のアーカイブを /var/www/html に展開してください。 ドキュメントルートに、ダウンロードしたリリースの名前がついたフォルダ(例えば cake_2.0.0)が取得できます。 このフォルダを cake_2_0 という名前にリネームしてください。 ファイルシステム上の開発用の設定は次のようになります

/var/www/html/
    cake_2_0/
        app/
        lib/
        plugins/
        vendors/
        .htaccess
        index.php
        README

もしウェブサーバが適切に設定されていれば、 http://www.example.com/cake_2_0/ で CakePHP アプリケーションがアクセス可能になっているはずです。

複数のアプリケーションから一つのCakePHPを使用する

多数のアプリケーションを開発している場合、それらがCakePHPのコアファイルを共有するのは理にかなっているといえます。そのようにするには、いくつか方法があります。いちばん簡単なのが、PHPの include_path を使う方法です。そのためにまずは、CakePHPを適当なディレクトリに複製します。この例では /home/mark/projects ディレクトリにします。

git clone -b 2.x git://github.com/cakephp/cakephp.git /home/mark/projects/cakephp

このコマンドを実行すると、CakePHP のファイルが /home/mark/projects ディレクトリの中に複製されます。gitを使用したくない場合は、zip形式でのダウンロードも可能で、残りの手順も同じです。次は、 php.ini を探して編集する必要があります。*nix系のシステムならたいていは /etc/php.ini にあります。もしくは php -i コマンドを実行して 'Loaded Configuration File' を確認してください。ini ファイルを見つけたら、 include_path の設定を変更して /home/mark/projects/cakephp/lib が含まれるようにしてください。例としては次のようになります。

include_path = .:/home/mark/projects/cakephp/lib:/usr/local/php/lib/php

ウェブサーバを再起動した後、 phpinfo() で変更が反映されているのを確認してください。

注釈

Windowsでは、インクルードパスの区切りは : ではなく ; になります。

include_path の設定が完了したので、アプリケーションはCakePHPのファイルを見つけられるようになりました。

運用(Production)

運用向けのインストールは CakePHP をセットアップするより柔軟な方法です。 この方法を使うと、ドメイン全体を単一の CakePHP アプリケーションのように振舞わせることができます。 この例では CakePHP を任意のファイルシステムの場所にインストールし、 http://www.example.com でアクセスできるようにする方法を説明します。 このインストールにおいては Apache ウェブサーバの DocumentRoot の設定を正しいものに変更する必要が出てくるかもしれないことに注意してください。

CakePHP のアーカイブを好きなディレクトリに展開してください。 この例において、CakePHP をインストールすると決めたディレクトリは /cake_install であると仮定します。 ファイルシステム上の運用向けの設定は次のようになります

/cake_install/
    app/
        webroot/ (このディレクトリを ``DocumentRoot`` ディレクティブとしてセットします)
    lib/
    plugins/
    vendors/
    .htaccess
    index.php
    README

Apache を使用する場合は、そのドメインの DocumentRoot ディレクティブを次のように設定してください

DocumentRoot /cake_install/app/webroot

もしウェブサーバが適切に設定されていれば、 http://www.example.com で CakePHP アプリケーションがアクセス可能になっているはずです。

応用インストールと URL リライティング

動作確認

それでは、実際に CakePHP を動作させてみましょう。 セットアップの種類にもよりますが、 http://example.com/ または http://example.com/cake_2_0/ をブラウザで開いてみましょう。 この時点では、CakePHP のデフォルトのホーム画面と、現在のデータベース接続の状態が表示されるはずです。

おめでとうございます! CakePHP の最初のアプリケーションを作る 準備ができました。

動きませんか? もし PHP のタイムゾーンに関連するエラーが出るなら、 app/Config/core.php の中のとある一行のコメントを外してください

/**
 * Uncomment this line and correct your server timezone to fix
 * any date & time related errors.
 */
    date_default_timezone_set('UTC');