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

公開： 2018年1月21日
更新： 2018年1月22日

カテゴリ： PHP CakePHP
タグ： PHP,install,Beginner,CakePHP,3.5

日本ではまだまだシェアの高いPHPフレームワークである「CakePHP3」の導入を行っていきます。

アジェンダ

検証環境
CakePHPとは
CakePHP3を動かすのに必要なもの
確認と環境構築
CakePHP3のインストール

検証環境

linux CentOS 7
Apache 2.4
PHP 7.1
MySQL 5.7

CakePHPとは

[公式]CakePHP
https://cakephp.org/jp

CakePHP（ケイクピーエイチピー）は、Webアプリケーションをよりシンプルに、より速く、少ないコードで構築することを可能にします。近代的なPHP 7フレームワークは、柔軟性のあるデータベースアクセス層と強力な足場システムを提供し、小型システムと複雑なシステムの両方をよりシンプルに、より簡単に、そしてより巧妙に構築できます。迅速に構築し、CakePHPで堅実に成長してください。

とまあ、公式からの抜粋を和訳してみたら説明になっていませんでしたが、個人的な見解から説明すると、CakePHPはPHPフレームワークとして必要な機能は大抵持っているので、機能面での心配はまずありません。

Laravelなど他のPHPフレームワークと違うところは、CakePHPなりの規則が多い事です。

WEBアプリケーション構築時のルールが多く、Laravelに比べると多少自由を削がれている感じではありますが、結果、それに従って構築していく事によって、誰が書いても同じような構成・コードで出来上がるよ。という感じになっています。

日本でシェアがあるのもわかるなあって感じですが、開発しているのが「cakeソフトウェア財団」というところで、アメリカにあるんですね。

とはいえ公式リファレンスが充実しており、CookbookやAPIリファレンスと合わせる事で結構な情報量になるので、採用するには心強いPHPフレームワークの１つです。

CakePHP3を動かすのに必要なもの

インストールを行う前に、自身の環境が要件を満たしているかを確認する必要があります。

CakePHP3をインストールするのに必要な環境は以下になります。

PHP 5.6.0 以上
PHP拡張モジュール
- mbstring
- intl
- simplexml
Composer
MySQL 5.1.10 以上

確認と環境構築

ここからは、CakePHP3のシステム要件を満たす為の確認と各ミドルウェアの導入を行います。

PHPバージョン確認

PHPのバージョンを確認します。以下のコマンドを叩きます。

# PHPのバージョンが5.6以上であるか確認する
php -v

# 実行結果
[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

PHPにのバージョンが5.6.0以上であればOKです。それ以下の場合は、5.6.0以上のPHPに入れ替える必要があります。

PHP拡張モジュールの確認

CekePHPの稼働に必要なPHP拡張モジュールが全て導入されているか確認します。以下のコマンドを叩きます。

# 必要なPHP拡張モジュールが導入されているか確認する
php -m | grep -e intl -e mbstring -e SimpleXML

# 実行結果
[demo@localhost ~]# php -m | grep -e intl -e mbstring -e SimpleXML
intl
mbstring
SimpleXML

「intl」「mbstring」「SimpleXML」が表示されればOKです。

SimpleXMLに関しては、PHPを導入時点でデフォルトで有効になっていますが、その他２つについては手動で導入が必要な場合があります。

Composerの確認

Composerが導入されているか確認します。以下のコマンドを叩きます。

# Composerが入っているか確認する
composer -v

# 実行結果
[demo@localhost ~]# composer -v
-bash: composer: command not found

上記のような結果の場合、Composerが入っていないので、インストールします。

# Composerをインストールする
yum -y install composer

インストール完了後、再度バージョン確認のコマンドを叩き、バージョンが表示されれば導入完了です。

Composerバージョン表示画面

CakePHP3のインストール

準備が整ったので、CakePHP3のインストールを行います。

プロジェクトルートへ移動し、Composerコマンドを叩いてCakePHP プロジェクトを作成します。

# CakePHPルートディレクトリへ移動
cd /path/to/cakephp

# 書式
composer create-project --prefer-dist cakephp/app [作成する場所]

# CakePHPをインストールする
composer create-project --prefer-dist cakephp/app ./

インストールが完了したら、tmpディレクトリとlogsディレクトリのユーザーをapacheへ変更します。

# tmpディレクトリとlogsディレクトリのユーザを変更する
chown apache:apache tmp logs

最後に、bakeコマンドを使うために実行権限を付与します。

# CakePHPルートディレクトリへ移動
cd /path/to/cakephp

# bin/cakeに実行権限を付与する
chmod +x bin/cake

これで導入作業は完了です。

[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