CakePHP3のバージョンを指定してインストールする詳細な手順を解説

2017/10/28

CakePHP3のバージョンを指定してインストールする方法

CakePHP3のバージョンを指定してインストールする方法の解説

　
CakePHP3のバージョンを指定してインストールする方法の解説です。
　
CakePHP3のバージョンを指定してインストールする場合は、下記の様にバージョンを指定してインストールを行います。
　

【最新版をインストールする場合】
composer create-project --prefer-dist cakephp/app [my_app_name]

【マイナーバージョンを指定する場合】
composer create-project --prefer-dist cakephp/app:3.4.* [my_app_name]

【メンテナンスバージョンまで指定する場合】
composer create-project --prefer-dist cakephp/app:3.4.4 [my_app_name]

【Composerにパスが通っていない場合】
php composer.phar create-project --prefer-dist cakephp/app [my_app_name]

【最新版をインストールする場合】

composer create-project --prefer-dist cakephp/app [my_app_name]

【マイナーバージョンを指定する場合】

composer create-project --prefer-dist cakephp/app:3.4.* [my_app_name]

【メンテナンスバージョンまで指定する場合】

composer create-project --prefer-dist cakephp/app:3.4.4 [my_app_name]

【Composerにパスが通っていない場合】

php composer.phar create-project --prefer-dist cakephp/app [my_app_name]

CakePHP3のバージョンを指定してインストールする必要がある場面

　
CakePHP3で会員管理システムの開発を行う機会がありました。
　
その際、CakePHP3で会員管理システムと言えば、CakeDCが提供するプラグイン「CakeDC/Usersプラグイン」がありますので、この「CakeDC/Usersプラグイン」を使って会員管理システムを構築しようと思いました。
　
ですが、「CakeDC/Usersプラグイン」は CakeDCが作っているとはいえ、CakePHP3のバージョンアップと同時にバージョンアップはしていきませんので、CakePHP3の最新版をインストールした場合は、「CakeDC/Usersプラグイン」が使えない、という状況になることが多々あります。
　
その場合、「CakeDC/Usersプラグイン」が最新バージョンに対応するまで待つという方法もありますが、一般的には「CakeDC/Usersプラグイン」が対応している CakePHP3のバージョンに合わせてインストールをする、という選択をするでしょう。
　
そんなわけで、CakePHP3のバージョンを指定してインストールする方法が必要になったわけです。
　
　
その他にも、本番で稼働しているサイトの開発環境を構築するため、本番と同じバージョンの CakePHP3をインストールする、という場合などにも必要になってくるでしょう。
　
　

CakePHP3のインストール手順

　
最初に CakePHP3のバージョンを指定してインストールする方法を解説しましたが、CakePHP3をインストールする方法について、改めて書いておきます。
　
CakePHP3公式サイト　インストール
https://book.cakephp.org/3.0/ja/installation.html
　
　

Composerのインストール

　
CakePHP3は、Composerを使ってインストールを行います。
そのため、Composerをインストールする必要があります。
　
Composerは、PHPのパッケージ管理システムで、ライブラリなどのパッケージをインストールする際に、コマンド一つで関連するパッケージも含めてインストールしてくれるシステムです。
　
　
Composerをインストールする方法については、下記のサイトなどが参考になるかと思います。
https://weblabo.oscasierra.net/php-composer-windows-install/
https://qiita.com/ozawan/items/caf6e7ddec7c6b31f01e
　
　

CakePHP3を Composerを使ってインストール

　
前項でインストールした Composerを使って、CakePHP3をインストールします。
　
インストールする際に使用するコマンドは、最初に解説した下記になります。
　

composer create-project --prefer-dist cakephp/app [my_app_name]

1	composer create-project --prefer-dist cakephp/app [my_app_name]

　
「[my_app_name]」は、作成するサイトのフォルダ名になります。
コマンドを実行したフォルダの中に「[my_app_name]」のフォルダ名でフォルダが作成され、その中に CakePHP3がインストールされます。
　
実行中に、下記の質問をされますので、通所は「Y」を入力しておきましょう。
　

Set Folder Permissions ? (Default to Y) [Y,n]? y

1	Set Folder Permissions ? (Default to Y) [Y,n]? y

　
　
インストールには数分程度かかりますが、待つだけでインストールが完了します。
　
　

動作確認

　
インストールが完了したら動作確認を行います。
　
不具合がある場合や、違うバージョンをインストールし直す場合などで、インストールした CakePHP3を削除したい場合は、フォルダごと削除すれば OKです。
　
　

データベースの接続

　
Composerを使ってインストールするようになりましたので、CakePHP3を使うために必要なのセットアップの大半は自動化されて、ほぼ何もせずに利用することができます。
　
一つだけ対応する必要がありますが、それはデータベースへの接続情報の設定です。
　
　
データベースの設定情報は、
　/config/app.php
にあります。
　
この「app.php」の 220行目辺りからがデータベースの設定情報です。
下記の情報などを設定しましょう。
　

'host' => 'localhost',
'port' => '3306',
'username' => 'root',
'password' => 'pass',
'database' => 'cake3',

'host' => 'localhost',

'port' => '3306',

'username' => 'root',

'password' => 'pass',

'database' => 'cake3',

　
ちなみに、ポート番号の指定は、「port」に値を指定せずに、下記の様に「host」に指定してしまうことも可能です。
　

'host' => 'localhost:3306',

1	'host' => 'localhost:3306',

CakePHP3のシステム要件

　
最後に CakePHP3を利用するためのシステム要件も記載しておきます。
　

HTTP サーバー。例: Apache。mod_rewrite が推奨されますが、必須ではありません。
PHP 5.6.0 以上（PHP 7.1 も含む）
mbstring PHP 拡張
intl PHP 拡張
simplexml PHP 拡張

　
公式サイトにも書いてありますが、Webサーバは Apacheだけでなく、nginxや lighttpd、Microsoft IISでも動作します。
また、XAMPPでも動作します。
　
　
データベースは必須ではありませんが、使う場合は下記の条件を満たすものが求められます。
　

MySQL（5.1.10 以上）
PostgreSQL
Microsoft SQL Server（2008 以上）
SQLite 3

- CakePHP 2.x　3.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3にWYSIWYGエディタのCKEditor4を設置、カスタマイズ方法を解説

WYSIWYGエディタであるCKEditor4をCDNを利用して簡単にCakePHP3に導入する方法とカスタマイズする方法を解説。CakePHP3にはページごとの振り分けを行うブロック化を利用する。

: CakePHP3のCakeDC/Usersのログイン後のリダイレクトとユーザ権限管理の設定解説

CakeDC謹製Usersプラグインの紹介。ログイン認証後にリダイレクトする先の設定方法についての解説と実運用するために必要なコツを解説。便利な仕組みも仕様の理解があって初めてうまく使いこなせる。

: CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法

CakePHP3の標準設定のタイムゾーンは「UTC（協定世界時）」に設定されている。これを日本標準時に変更する方法（app.php、bootstrap.phpの変更方法）の解説。

: CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法

CakePHP3でPHPExcelを利用してエクセルを編集、出力するサンプルソース＋解説。PHPExcelのインストール方法の解説からファイル保存とダウンロードの方法なども解説。

: CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングする方法

CakePHP3でPHP Simple HTML DOM Parserを使ってスクレイピングをする方法を解説。インストール方法、読み込み方法。および、具体的なスクレイピングを実行するサンプルソースも。

: CakePHP3の画像、ファイルアップロードプラグインUpload Plugin 3.0の設置解説・その１

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその1で基本的な導入方法の解説で読みながら簡単に導入が可能。

: CakePHP3でComposerでインストールできないプラグイン、外部ライブラリを vendorに入れて手動で読み込む方法

CakePHP3にComposerからインストールできないプラグインやライブラリなどを利用する方法、vendorにファイルを設置し、composer.jsonを更新し、それを呼び出す方法を詳細に解説。

: CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その３

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその3で記事を更新する際のファイルの取り回しなどについてを解説。

: CakePHP3のビューで受取ったテーブルのオブジェクトを連想配列に変換する方法

コントローラーからビューに送ったテーブルのオブジェクトを連想配列に変換し、ビューの中で自由に使えるようにするメソッド「toArray()」の解説。連想配列に変換できれば利用度アップ！

: CakePHP3でQRコードを作成、表示するライブラリ「cakePHP-QR-Code-Helper」

CakePHPでQRコードを生成するライブラリ「cakePHP-QR-Code-Helper」の紹介。GDライブラリのインストールも必要ないHelperとして提供されているため、ファイルを設置すればすぐに使用可能。