インストール¶

Composer のインストール¶

CakePHP の公式のインストール方法として、依存性管理ツール Composer を使用します。

• Linux や macOS に Composer をインストール

  1. 公式の Composer ドキュメント に書かれた インストーラースクリプトを実行し、Composer をインストールするために指示に従ってください。

  2. composer.phar を指定したパスのディレクトリーに移すために以下のコマンドを実行してください。

     mv composer.phar /usr/local/bin/composer
     

• Windows に Composer をインストール

  Windows 環境なら、 こちら から Windows インストーラーをダウンロードできます。Composer の Windows インストーラーについての詳細は、 README をご覧ください。

CakePHP プロジェクトを作成¶

以上で、Composer をダウンロードとインストールしましたので、 my_app_name フォルダーに CakePHP の新しいアプリケーションを作成してください。下記の composer コマンドを実行して作成します。

php composer.phar create-project --prefer-dist cakephp/app:^3.8 my_app_name

または Composer にパスが通っているのであれば下記のコマンドも使えます。

composer self-update && composer create-project --prefer-dist cakephp/app:^3.8 my_app_name

一度 Composer がアプリケーションの雛形とコアライブラリーをダウンロードしたら、 インストールした CakePHP アプリケーションを Composer から操作できるように しておくべきです。 必ず composer.json と composer.lock ファイルは残しておきましょう。

これでインストールした CakePHP アプリケーションにアクセスして、デフォルトの ホームページを見ることができるようになりました。このページの内容を変更するには src/Template/Pages/home.ctp を編集してください。

composer によるインストールが推奨されますが、 Github にはプリインストール版もあります。 このファイルにはアプリケーションの雛形と全てのベンダーパッケージが同梱されています。 また、 composer.phar も入っていますので、あなたのさらなる使用のために必要なものは 全てそろっているのです。

CakePHP の変更に合わせて最新の状態に保つ¶

デフォルトではあなたのアプリケーションの composer.json は下記のようになっています。

"require": {
    "cakephp/cakephp": "3.6.*"
}

あなたが php composer.phar update を実行するたびに、このマイナーバージョンの パッチリリースが手に入ります。代わりに ^3.6 に変更して、 3.x ブランチの 最新の安定版マイナーリリースを手に入れることができます。

もし CakePHP をリリース前の最新状態で維持したいのなら、あなたのアプリケーションの composer.json にパッケージバージョンとして dev-master を指定してください。

"require": {
    "cakephp/cakephp": "dev-master"
}

この方法は次のメジャーバージョンがリリースされた時にあなたのアプリケーションが 動かなくなる可能性がありますので、お奨めできない事に注意してください。 さらに、composer は開発ブランチをキャッシュしませんので、composer による 連続したインストール・アップデートには時間がかかります。

Oven を使用したインストール¶

CakePHP を素早くインストールするための別の方法は、 Oven です。 これは、必要なシステム要件をチェック、CakePHP アプリケーションのスケルトンをインストール、そして、 開発環境をセットアップするシンプルな PHP スクリプトです。

インストールが完了すれば、あなたの CakePHP アプリケーションはすぐに使えます！

Apache¶

CakePHP は、展開した状態では mod_rewrite を使用するようになっており、自分のシステムで うまく動作するまで苦労するユーザーもいます。

ここでは、正しく動作させるために行うことをいくつか示します。 まず始めに httpd.conf を見てください（ユーザーやサイト個別の httpd.conf ではなく、 必ずシステムの httpd.conf を編集してください）。

これらのファイルはディストリビューションや Apache のバージョンによって大きく異なります。 詳細については https://wiki.apache.org/httpd/DistrosDefaultLayout を見てもよいかも しれません。

1. 適切な DocumentRoot に対して .htaccess による設定の上書きを許可するよう、 AllowOverride に All が設定されている事を確認します。 これは下記のように書かれているでしょう。

   # Each directory to which Apache has access can be configured with respect
   # to which services and features are allowed and/or disabled in that
   # directory (and its subdirectories).
   #
   # First, we configure the "default" to be a very restrictive set of
   # features.
   <Directory />
       Options FollowSymLinks
       AllowOverride All
   #    Order deny,allow
   #    Deny from all
   </Directory>
   

2. 下記のように mod_rewrite が正しくロードされている事を確認します。

   LoadModule rewrite_module libexec/apache2/mod_rewrite.so
   

   多くのシステムでこれらはデフォルトではコメントアウトされているでしょうから、 先頭の「#」の文字を削除する必要があります。

   変更した後は、設定変更を反映するために Apache を再起動してください。

   .htaccess ファイルが正しいディレクトリーにあることを確認してください。 一部のOSでは、ファイル名が「.」から始まるファイルは隠しファイルとみなされ、 コピーされないでしょう。

3. サイトのダウンロードページや Git リポジトリーからコピーした CakePHP が正しく 解凍できているか、 .htaccess ファイルをチェックします。

   CakePHP のアプリケーションディレクトリー（あなたが Bake でコピーした一番上の ディレクトリー）にはこのように書いてあります。

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

   webroot ディレクトリーにはこのように書いてあります。

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteRule ^ index.php [L]
   </IfModule>
   

   まだあなたの CakePHP サイトで mod_rewrite の問題が起きているなら、 仮想ホスト (virtualhosts) の設定の変更を試してみるといいかもしれません。 Ubuntu 上なら、/etc/apache2/sites-available/default (場所は ディストリビューションによる)のファイルを編集してください。 このファイルの中で AllowOverride None が AllowOverride All に変更されているかを確かめてください。 つまり以下のようになるでしょう。

   <Directory />
       Options FollowSymLinks
       AllowOverride All
   </Directory>
   <Directory /var/www>
       Options FollowSymLinks
       AllowOverride All
       Order Allow,Deny
       Allow from all
   </Directory>
   

   macOS 上での別解は、仮想ホストをフォルダーに向けさせるのに、 virtualhostx ツールを使うことが挙げられます。

   多くのホスティングサービス (GoDaddy、1and1) では、ウェブサーバーが 既に mod_rewrite を使っているユーザーディレクトリーから配信されます。 CakePHP をユーザーディレクトリー (http://example.com/~username/cakephp/) または 既に mod_rewrite を活用しているその他の URL 構造にインストールしているなら、 RewriteBase ステートメントを CakePHP が使う .htaccess ファイル (/.htaccess、/app/.htaccess、/app/webroot/.htaccess) に追加する必要があります。

   これは RewriteEngine ディレクティブと同じセクションに追加でき、 例えば webroot の .htaccess ファイルは以下のようになります。

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteBase /path/to/app
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteRule ^ index.php [L]
   </IfModule>
   

   この変更の詳細はあなたの環境構成に依存しますので、CakePHP と関係ない内容が 含まれることがあります。 詳しくは Apache のオンラインドキュメントを参照するようにしてください。

4. (オプション) 公開環境の設定では、必要ないリクエストは CakePHP で処理されないようにしましょう。 webroot の .htaccess ファイルを次のように修正してください。

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteBase /path/to/app/
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteCond %{REQUEST_URI} !^/(webroot/)?(img|css|js)/(.*)$
       RewriteRule ^ index.php [L]
   </IfModule>
   

   上の例は、正しくないアセットを index.php へ送信せず、ウェブサーバーの 404 ページを表示します。

   また、HTML で 404 ページを作成することもできますし、 ErrorDocument ディレクティブへ 追記することで、CakePHP のビルトインの 404 ページを使うこともできます。

   ErrorDocument 404 /404-not-found
   

nginx¶

nginx は Apache のような .htaccess ファイルを利用しませんので、 サイトの設定で URLの書き換えルールを作成する必要があります。 これは大抵 /etc/nginx/sites-available/your_virtual_host_conf_file に記載します。 あなたの環境構成に応じて、このファイルを書き換えなければなりませんが、 少なくとも PHP を FastCGI として稼働させる必要はあるでしょう。 下記の設定は、リクエストを webroot/index.php にリダイレクトします。

location / {
    try_files $uri $uri/ /index.php?$args;
}

server ディレクティブの例は、次の通りです。

server {
    listen   80;
    listen   [::]:80;
    server_name www.example.com;
    return 301 http://example.com$request_uri;
}

server {
    listen   80;
    listen   [::]:80;
    server_name example.com;

    root   /var/www/example.com/public/webroot;
    index  index.php;

    access_log /var/www/example.com/log/access.log;
    error_log /var/www/example.com/log/error.log;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include fastcgi_params;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_intercept_errors on;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

IIS7 (Windows hosts)¶

IIS7 はネイティブで .htaccess ファイルをサポートしていません。 このサポートを追加できるアドオンがありますが、CakePHP のネイティブな書き換えを使うように IIS に htaccess のルールをインポートすることもできます。 これをするには、以下のステップを踏んでください:

1. URL Rewrite Module 2.0 をインストールするために、Microsoftの Web Platform Installer を使うか、直接ダウンロードします。(32ビット / 64ビット)

2. CakePHP のルートフォルダーに web.config という名前の新しいファイルを作成してください。

3. メモ帳か XML が編集可能なエディターを使って、以下のコードを今作った web.config ファイルに コピーしてください。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Exclude direct access to webroot/*"
                  stopProcessing="true">
                    <match url="^webroot/(.*)$" ignoreCase="false" />
                    <action type="None" />
                </rule>
                <rule name="Rewrite routed access to assets(img, css, files, js, favicon)"
                  stopProcessing="true">
                    <match url="^(font|img|css|files|js|favicon.ico)(.*)$" />
                    <action type="Rewrite" url="webroot/{R:1}{R:2}"
                      appendQueryString="false" />
                </rule>
                <rule name="Rewrite requested file/folder to index.php"
                  stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="false" />
                    <action type="Rewrite" url="index.php"
                      appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

一旦 IIS で利用可能な書き換えルールを含む web.config ファイルができたら、 CakePHP のリンク、CSS、JavaScript、再ルーティング (rerouting) は正しく動作するでしょう。

URL リライティングを使わない場合¶

もしあなたのサーバーで mod_rewrite (かそれと互換性のあるモジュール) を使いたくなかったり 使えない場合は、 CakePHP の組み込みのままの URL を使う必要があります。 config/app.php の下記のコメントを解除します。

'App' => [
    // ...
    // 'baseUrl' => env('SCRIPT_NAME'),
]

そして、下記の .htaccess ファイルを削除します。

/.htaccess
webroot/.htaccess

これで URL は www.example.com/controllername/actionname/param ではなく www.example.com/index.php/controllername/actionname/param という書式になるでしょう。