Cakephp2 の理想的なディレクトリ構成を教えてください。

Question

Cakephp の理想的なディレクトリ構成についてです。

Vagrant でローカル開発環境を作り、Cakephp2 の勉強を始めようとしています。
何度か Cakephp2 を使ってアプリ開発はしたことがあるのですが、今回 Composer や bake を使ってみたいと思い、Vagrant で開発をしています。

composer を使って cakephp や Debug_Kit をインストールしてみたのですが、いまいちしっくりこないので、cakephp の理想のディレクトリ構造が知りたいのです。

また、git での管理も考えているので管理しやすい構成だと嬉しいです。

composer.jsonはこのように書きました。

{
    "name": "tutorial",
    "repositories": [
        {
            "type": "pear",
            "url": "http://pear.cakephp.org"
        }
    ],
    "require": {
        "cakephp/cakephp": ">=2.6.4,<3.0.0"
    },
    "require-dev": {
        "phpunit/phpunit": "3.7.37",
        "cakephp/debug_kit" : ">=2.2.4,<3.0.0"
    },
    "config": {
        "vendor-dir": "Vendor/"
    }
}

このcomposer.jsonでインストールを実行し、bake を使ってtutorialというアプリを生成すると、以下のようになりました。

vagrant/
├── Plugin
│   └── DebugKit
├── Vendor
│   ├── autoload.php
│   ├── bin
│   ├── cakephp
│   │   └── cakephp
│   │       ├── app
│   │       ├── lib
│   │       ├── plugins
│   │       └── vendors
│   └── phpunit
├── html
│   ├── css
│   ├── index.php
│   └── js
└── tutorial
	├── Config
	├── Console
	├── Controller
	├── Lib
	├── Locale
	├── Model
	├── Plugin
	├── Test
	├── Vendor
	├── View
	├── index.php
	├── tmp
	└── webroot

/vagrant/html が DocumentRoot になっているので、webroot の中身を
/vagrant/htmlに移し、定数の設定などを行ったのですが、うまく動きませんでした。

###試したこと
/vagrant/tutorial を /Vendor/cakephp/cakephp の中に作成すると、cakephp のインストール完了画面が正しく表示されました。
ただ、Debug_Kit がうまく読み込めませんでした。

また、cakephp をまるごと DocumentRoot内に配置することも考えたのですが、セキュリティ的に好ましくないと聞いたので、できれば外に出したいなと考えています。

###補足情報(言語/FW/ツール等のバージョンなど)
macOS 10.12.3
vagrant
CentOS 7.0
php 5.6
cakephp 2.9

Answer 1

DocumentRootをvagrant/tutorial/webrootに設定してはダメなのでしょうか？

Answer 2

私も同じ疑問をずっと持ち続けていましたが、最近、以下のいずれかの方法に落ち着きました。

方法1: GitHub からダウンロードした CakePHP 2.x の app/ を使用する

CakePHP 2.x のアーカイブをダウンロードして、その app/ ディレクトリ配下をプロジェクトとして使用します。

app/composer.json ファイルが、2.8.5 で追加されています。その中に

"description": "CakePHP Application skeleton"

と書かれていますので、この app/ のディレクトリ構成を使用するのが適当なのだと思われます。

方法2: bake project する

CakePHP 2.x Cookbook の「応用インストール」の頁にある「CakePHP プロジェクトの作成」に従って作成しますが、bake project コマンドで .（カレントディレクトリ）を指定すると、方法1の場合と同じようなディレクトリ構成になります。

$ Vendor/bin/cake bake project .

方法3: FriendsOfCake/app-template を利用する

Composer の create-project でこのテンプレートを指定してプロジェクトを作成します。

以下の特徴があるようです。

• Composer の autoloader を設定済み
• 構成設定で環境変数が使用される
• Heroku に対応しやすい

構成設定が標準のやり方と少し違ってきますので、初級者向けではないかもしれません。

実際のプロダクトでは、開発/ステージング/本番などの環境によって、構成設定を分ける必要が出てきます。
そのような場合は、このテンプレートを利用していると比較的楽そうですので、検討しても良いかなと思います。

上記いずれかの方法で作成したプロジェクトの app/webroot/ を DocumentRoot として設定すれば動くと思います。