CakePHPは日本でよく使われているPHPフレームワークの一つです。今回は入門編という事で、CakePHP3のインストールを行います。

【入門】PHPフレームワーク「CakePHP3」をインストールする。

<p>日本ではまだまだシェアの高い PHP フレームワークである「CakePHP3 」の導入を行っていきます。</p>
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E6%A4%9C%E8%A8%BC%E7%92%B0%E5%A2%83">検証環境</a></li>
<li><a href="#cakephp-%E3%81%A8%E3%81%AF">CakePHP とは</a></li>
<li><a href="#cakephp3-%E3%82%92%E5%8B%95%E3%81%8B%E3%81%99%E3%81%AE%E3%81%AB%E5%BF%85%E8%A6%81%E3%81%AA%E3%82%82%E3%81%AE">CakePHP3 を動かすのに必要なもの</a></li>
<li><a href="#%E7%A2%BA%E8%AA%8D%E3%81%A8%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89">確認と環境構築</a>
<ol>
<li><a href="#php-%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E7%A2%BA%E8%AA%8D">PHP バージョン確認</a></li>
<li><a href="#php-%E6%8B%A1%E5%BC%B5%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%81%AE%E7%A2%BA%E8%AA%8D">PHP 拡張モジュールの確認</a></li>
<li><a href="#composer-%E3%81%AE%E7%A2%BA%E8%AA%8D">Composer の確認</a></li>
</ol>
</li>
<li><a href="#cakephp3-%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">CakePHP3 のインストール</a></li>
</ol>
<h2 id="検証環境">検証環境</h2>
<ul>
<li>linux CentOS 7</li>
<li>Apache 2.4</li>
<li>PHP 7.1</li>
<li>MySQL 5.7</li>
</ul>
<h2 id="cakephp-とは">CakePHP とは</h2>
<p>[公式]CakePHP<br>
<a href="https://cakephp.org/jp" rel="noopener noreferrer" target="_blank">https://cakephp.org/jp</a></p>
<p>CakePHP（ケイクピーエイチピー）は、Web アプリケーションをよりシンプルに、より速く、少ないコードで構築することを可能にします。 近代的な PHP 7 フレームワークは、柔軟性のあるデータベースアクセス層と強力な足場システムを提供し、小型システムと複雑なシステムの両方をよりシンプルに、より簡単に、そしてより巧妙に構築できます。 迅速に構築し、CakePHP で堅実に成長してください。</p>
<p>とまあ、公式からの抜粋を和訳してみたら説明になっていませんでしたが、個人的な見解から説明すると、CakePHP は PHP フレームワークとして必要な機能は大抵持っているので、機能面での心配はまずありません。</p>
<p>Laravel など他の PHP フレームワークと違うところは、CakePHP なりの規則が多い事です。</p>
<p>WEB アプリケーション構築時のルールが多く、Laravel に比べると多少自由を削がれている感じではありますが、結果、それに従って構築していく事によって、誰が書いても同じような構成・コードで出来上がるよ。という感じになっています。</p>
<p>日本でシェアがあるのもわかるなあって感じですが、開発しているのが「cake ソフトウェア財団」というところで、アメリカにあるんですね。</p>
<p>とはいえ公式リファレンスが充実しており、Cookbook や API リファレンスと合わせる事で結構な情報量になるので、採用するには心強い PHP フレームワークの１つです。</p>
<h2 id="cakephp3-を動かすのに必要なもの">CakePHP3 を動かすのに必要なもの</h2>
<p>インストールを行う前に、自身の環境が要件を満たしているかを確認する必要があります。</p>
<p>CakePHP3 をインストールするのに必要な環境は以下になります。</p>
<ul>
<li>PHP 5.6.0 以上</li>
<li>PHP 拡張モジュール
<ul>
<li>mbstring</li>
<li>intl</li>
<li>simplexml</li>
</ul>
</li>
<li>Composer</li>
<li>MySQL 5.1.10 以上</li>
</ul>
<h2 id="確認と環境構築">確認と環境構築</h2>
<p>ここからは、CakePHP3 のシステム要件を満たす為の確認と各ミドルウェアの導入を行います。</p>
<h3 id="php-バージョン確認">PHP バージョン確認</h3>
<p>PHP のバージョンを確認します。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">PHP のバージョンが 5.6 以上であるか確認する</span>
php -v
<span class="hljs-meta prompt_">
# </span><span class="bash">実行結果</span>
[demo@localhost ~]# php -v

PHP 7.1.11 (cli) (built: Oct 25 2017 10:24:28) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies
    with Zend OPcache v7.1.11, Copyright (c) 1999-2017, by Zend Technologies
    with Xdebug v2.5.5, Copyright (c) 2002-2017, by Derick Rethans
</code></pre>
<p>PHP にのバージョンが 5.6.0 以上であれば OK です。それ以下の場合は、5.6.0 以上の PHP に入れ替える必要があります。</p>
<h3 id="php-拡張モジュールの確認">PHP 拡張モジュールの確認</h3>
<p>CekePHP の稼働に必要な PHP 拡張モジュールが全て導入されているか確認します。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">必要な PHP 拡張モジュールが導入されているか確認する</span>
php -m | grep -e intl -e mbstring -e SimpleXML
<span class="hljs-meta prompt_">
# </span><span class="bash">実行結果</span>
[demo@localhost ~]# php -m | grep -e intl -e mbstring -e SimpleXML
intl
mbstring
SimpleXML 
</code></pre>
<p>「intl 」「mbstring 」「SimpleXML 」が表示されれば OK です。</p>
<p>SimpleXML に関しては、PHP を導入時点でデフォルトで有効になっていますが、その他２つについては手動で導入が必要な場合があります。</p>
<h3 id="composer-の確認">Composer の確認</h3>
<p>Composer が導入されているか確認します。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">Composer が入っているか確認する</span>
composer -v
<span class="hljs-meta prompt_">
# </span><span class="bash">実行結果</span>
[demo@localhost ~]# composer -v
-bash: composer: command not found
</code></pre>
<p>上記のような結果の場合、Composer が入っていないので、インストールします。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">Composer をインストールする</span>
yum -y install composer
</code></pre>
<p>インストール完了後、再度バージョン確認のコマンドを叩き、バージョンが表示されれば導入完了です。</p>
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/58/mai69QpicL1CTzRSeqVd.png" width="600" height="472" alt="Composer バージョン表示画面"></div>
<h2 id="cakephp3-のインストール">CakePHP3 のインストール</h2>
<p>準備が整ったので、CakePHP3 のインストールを行います。</p>
<p>プロジェクトルートへ移動し、Composer コマンドを叩いて CakePHP プロジェクトを作成します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">CakePHP ルートディレクトリへ移動</span>
cd /path/to/cakephp
<span class="hljs-meta prompt_">
# </span><span class="bash">書式</span>
composer create-project --prefer-dist cakephp/app [作成する場所]
<span class="hljs-meta prompt_">
# </span><span class="bash">CakePHP をインストールする</span>
composer create-project --prefer-dist cakephp/app ./
</code></pre>
<p>インストールが完了したら、tmp ディレクトリと logs ディレクトリのユーザーを apache へ変更します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">tmp ディレクトリと logs ディレクトリのユーザを変更する</span>
chown apache:apache tmp logs
</code></pre>
<p>最後に、bake コマンドを使うために実行権限を付与します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">CakePHP ルートディレクトリへ移動</span>
cd /path/to/cakephp
<span class="hljs-meta prompt_">
# </span><span class="bash">bin/cake に実行権限を付与する</span>
chmod +x bin/cake

</code></pre>
<p>これで導入作業は完了です。</p>
<pre><code class="hljs language-shell">[demo@localhost cakephp]# ll
total 104
drwxr-xr-x.  2 nobody nobody    47 Sep 22 06:31 bin
-rw-r--r--.  1 nobody nobody  2016 Sep 22 06:31 composer.json
-rw-r--r--.  1 nobody nobody 76288 Sep 22 06:31 composer.lock
drwxr-xr-x.  3 nobody nobody  4096 Sep 22 06:31 config
-rw-r--r--.  1 nobody nobody   649 Sep 22 06:31 index.php
drwxr-xrwx.  2 apache apache    18 Sep 22 06:31 logs
-rw-r--r--.  1 nobody nobody  1202 Sep 22 06:31 phpunit.xml.dist
drwxr-xr-x.  2 nobody nobody    18 Sep 22 06:31 plugins
-rw-r--r--.  1 nobody nobody  1663 Sep 22 06:31 README.md
drwxr-xr-x.  8 nobody nobody  4096 Sep 22 06:31 src
drwxr-xr-x.  4 nobody nobody    55 Sep 22 06:31 tests
drwxr-xrwx.  5 apache apache    45 Sep 22 06:31 tmp
drwxr-xr-x. 22 nobody nobody  4096 Sep 22 06:31 vendor
drwxr-xr-x.  6 nobody nobody    96 Sep 22 06:31 webroot
</code></pre>
<p>実際にブラウザからアクセスし、以下のような画面が表示されればインストール完了です。</p>
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/58/2wQ6BeaURBtm79zdy6om.png" width="600" height="594" alt="CakePHP3 初期画面"></div>
<p>next：<a href="/posts/59">【入門】 CakePHP3 をインストール後に行っておくべき初期設定</a></p>

<p>日本ではまだまだシェアの高い PHP フレームワークである「CakePHP3 」の導入を行っていきます。</p>
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E6%A4%9C%E8%A8%BC%E7%92%B0%E5%A2%83">検証環境</a></li>
<li><a href="#cakephp-%E3%81%A8%E3%81%AF">CakePHP とは</a></li>
<li><a href="#cakephp3-%E3%82%92%E5%8B%95%E3%81%8B%E3%81%99%E3%81%AE%E3%81%AB%E5%BF%85%E8%A6%81%E3%81%AA%E3%82%82%E3%81%AE">CakePHP3 を動かすのに必要なもの</a></li>
<li><a href="#%E7%A2%BA%E8%AA%8D%E3%81%A8%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89">確認と環境構築</a>
<ol>
<li><a href="#php-%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E7%A2%BA%E8%AA%8D">PHP バージョン確認</a></li>
<li><a href="#php-%E6%8B%A1%E5%BC%B5%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%81%AE%E7%A2%BA%E8%AA%8D">PHP 拡張モジュールの確認</a></li>
<li><a href="#composer-%E3%81%AE%E7%A2%BA%E8%AA%8D">Composer の確認</a></li>
</ol>
</li>
<li><a href="#cakephp3-%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">CakePHP3 のインストール</a></li>
</ol>
<h2 id="検証環境">検証環境</h2>
<ul>
<li>linux CentOS 7</li>
<li>Apache 2.4</li>
<li>PHP 7.1</li>
<li>MySQL 5.7</li>
</ul>
<h2 id="cakephp-とは">CakePHP とは</h2>
<p>[公式]CakePHP<br>
<a href="https://cakephp.org/jp" rel="noopener noreferrer" target="_blank">https://cakephp.org/jp</a></p>
<p>CakePHP（ケイクピーエイチピー）は、Web アプリケーションをよりシンプルに、より速く、少ないコードで構築することを可能にします。 近代的な PHP 7 フレームワークは、柔軟性のあるデータベースアクセス層と強力な足場システムを提供し、小型システムと複雑なシステムの両方をよりシンプルに、より簡単に、そしてより巧妙に構築できます。 迅速に構築し、CakePHP で堅実に成長してください。</p>
<p>とまあ、公式からの抜粋を和訳してみたら説明になっていませんでしたが、個人的な見解から説明すると、CakePHP は PHP フレームワークとして必要な機能は大抵持っているので、機能面での心配はまずありません。</p>
<p>Laravel など他の PHP フレームワークと違うところは、CakePHP なりの規則が多い事です。</p>
<p>WEB アプリケーション構築時のルールが多く、Laravel に比べると多少自由を削がれている感じではありますが、結果、それに従って構築していく事によって、誰が書いても同じような構成・コードで出来上がるよ。という感じになっています。</p>
<p>日本でシェアがあるのもわかるなあって感じですが、開発しているのが「cake ソフトウェア財団」というところで、アメリカにあるんですね。</p>
<p>とはいえ公式リファレンスが充実しており、Cookbook や API リファレンスと合わせる事で結構な情報量になるので、採用するには心強い PHP フレームワークの１つです。</p>
<h2 id="cakephp3-を動かすのに必要なもの">CakePHP3 を動かすのに必要なもの</h2>
<p>インストールを行う前に、自身の環境が要件を満たしているかを確認する必要があります。</p>
<p>CakePHP3 をインストールするのに必要な環境は以下になります。</p>
<ul>
<li>PHP 5.6.0 以上</li>
<li>PHP 拡張モジュール
<ul>
<li>mbstring</li>
<li>intl</li>
<li>simplexml</li>
</ul>
</li>
<li>Composer</li>
<li>MySQL 5.1.10 以上</li>
</ul>
<h2 id="確認と環境構築">確認と環境構築</h2>
<p>ここからは、CakePHP3 のシステム要件を満たす為の確認と各ミドルウェアの導入を行います。</p>
<h3 id="php-バージョン確認">PHP バージョン確認</h3>
<p>PHP のバージョンを確認します。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">PHP のバージョンが 5.6 以上であるか確認する</span>
php -v
<span class="hljs-meta prompt_">
# </span><span class="bash">実行結果</span>
[demo@localhost ~]# php -v

PHP 7.1.11 (cli) (built: Oct 25 2017 10:24:28) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies
    with Zend OPcache v7.1.11, Copyright (c) 1999-2017, by Zend Technologies
    with Xdebug v2.5.5, Copyright (c) 2002-2017, by Derick Rethans
</code></pre>
<p>PHP にのバージョンが 5.6.0 以上であれば OK です。それ以下の場合は、5.6.0 以上の PHP に入れ替える必要があります。</p>
<h3 id="php-拡張モジュールの確認">PHP 拡張モジュールの確認</h3>
<p>CekePHP の稼働に必要な PHP 拡張モジュールが全て導入されているか確認します。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">必要な PHP 拡張モジュールが導入されているか確認する</span>
php -m | grep -e intl -e mbstring -e SimpleXML
<span class="hljs-meta prompt_">
# </span><span class="bash">実行結果</span>
[demo@localhost ~]# php -m | grep -e intl -e mbstring -e SimpleXML
intl
mbstring
SimpleXML 
</code></pre>
<p>「intl 」「mbstring 」「SimpleXML 」が表示されれば OK です。</p>
<p>SimpleXML に関しては、PHP を導入時点でデフォルトで有効になっていますが、その他２つについては手動で導入が必要な場合があります。</p>
<h3 id="composer-の確認">Composer の確認</h3>
<p>Composer が導入されているか確認します。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">Composer が入っているか確認する</span>
composer -v
<span class="hljs-meta prompt_">
# </span><span class="bash">実行結果</span>
[demo@localhost ~]# composer -v
-bash: composer: command not found
</code></pre>
<p>上記のような結果の場合、Composer が入っていないので、インストールします。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">Composer をインストールする</span>
yum -y install composer
</code></pre>
<p>インストール完了後、再度バージョン確認のコマンドを叩き、バージョンが表示されれば導入完了です。</p>
<div class="img_wrap"><img src="/images/posts/58/mai69QpicL1CTzRSeqVd.png" width="600" height="472" alt="Composer バージョン表示画面"></div>
<h2 id="cakephp3-のインストール">CakePHP3 のインストール</h2>
<p>準備が整ったので、CakePHP3 のインストールを行います。</p>
<p>プロジェクトルートへ移動し、Composer コマンドを叩いて CakePHP プロジェクトを作成します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">CakePHP ルートディレクトリへ移動</span>
cd /path/to/cakephp
<span class="hljs-meta prompt_">
# </span><span class="bash">書式</span>
composer create-project --prefer-dist cakephp/app [作成する場所]
<span class="hljs-meta prompt_">
# </span><span class="bash">CakePHP をインストールする</span>
composer create-project --prefer-dist cakephp/app ./
</code></pre>
<p>インストールが完了したら、tmp ディレクトリと logs ディレクトリのユーザーを apache へ変更します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">tmp ディレクトリと logs ディレクトリのユーザを変更する</span>
chown apache:apache tmp logs
</code></pre>
<p>最後に、bake コマンドを使うために実行権限を付与します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">CakePHP ルートディレクトリへ移動</span>
cd /path/to/cakephp
<span class="hljs-meta prompt_">
# </span><span class="bash">bin/cake に実行権限を付与する</span>
chmod +x bin/cake

</code></pre>
<p>これで導入作業は完了です。</p>
<pre><code class="hljs language-shell">[demo@localhost cakephp]# ll
total 104
drwxr-xr-x.  2 nobody nobody    47 Sep 22 06:31 bin
-rw-r--r--.  1 nobody nobody  2016 Sep 22 06:31 composer.json
-rw-r--r--.  1 nobody nobody 76288 Sep 22 06:31 composer.lock
drwxr-xr-x.  3 nobody nobody  4096 Sep 22 06:31 config
-rw-r--r--.  1 nobody nobody   649 Sep 22 06:31 index.php
drwxr-xrwx.  2 apache apache    18 Sep 22 06:31 logs
-rw-r--r--.  1 nobody nobody  1202 Sep 22 06:31 phpunit.xml.dist
drwxr-xr-x.  2 nobody nobody    18 Sep 22 06:31 plugins
-rw-r--r--.  1 nobody nobody  1663 Sep 22 06:31 README.md
drwxr-xr-x.  8 nobody nobody  4096 Sep 22 06:31 src
drwxr-xr-x.  4 nobody nobody    55 Sep 22 06:31 tests
drwxr-xrwx.  5 apache apache    45 Sep 22 06:31 tmp
drwxr-xr-x. 22 nobody nobody  4096 Sep 22 06:31 vendor
drwxr-xr-x.  6 nobody nobody    96 Sep 22 06:31 webroot
</code></pre>
<p>実際にブラウザからアクセスし、以下のような画面が表示されればインストール完了です。</p>
<div class="img_wrap"><img src="/images/posts/58/2wQ6BeaURBtm79zdy6om.png" width="600" height="594" alt="CakePHP3 初期画面"></div>
<p>next：<a href="/posts/59">【入門】 CakePHP3 をインストール後に行っておくべき初期設定</a></p>

Author