CakePHP 3 のクイックスタートを改めて見てたら composer create-project … ってでてきて何だこいつは…ってなった話。
php composer.phar create-project --prefer-dist cakephp/app bookmarker
composer create-project がやること
要はドキュメントにあるので読めって話になる。
Command-line interface / Commands - Composer
You can use Composer to create new projects from an existing package. This is the equivalent of doing a git clone/svn checkout followed by a "composer install" of the vendors.There are several applications for this:
- You can deploy application packages.
- You can check out any package and start developing on patches for example.
- Projects with multiple developers can use this feature to bootstrap the initial application for development.
To create a new project using Composer you can use the “create-project” command. Pass it a package name, and the directory to create the project in. You can also provide a version as third argument, otherwise the latest version is used.
ざっくりと翻訳してみると、こんなことが書かれているようだ。
既にあるパッケージから新しいプロジェクトを作ります。それは git clone または svn checkout をして composer install を行うのと同等です。
- アプリケーションパッケージをデプロイできる
- パッケージをチェックアウトして開発をしていける
- 新しい開発のため、ブートストラップな初期化を提供ができる
“create-project” コマンドによってそれは実行できる。パッケージ名、プロジェクトのディレクトリ名、そしてパッケージバージョンを指定できる。
CakePHP のドキュメントにあったコマンドを読み解く
php composer.phar create-project --prefer-dist cakephp/app bookmarker
まず指定されているパッケージを見てみる。
A skeleton for creating applications with CakePHP 3.x.
なるほど。つまり、空っぽの CakePHP アプリケーションがパッケージ登録されているので、それをもってくることで新規に空っぽの CakePHP アプリケーション作れるやん！ということだそうだ。
ところで –prefer-dist はなんだろう。 composer のドキュメントをもう一度見る。
--prefer-dist: Install packages from dist when available.
んーむ。 dist があればインストールするよって言ってるけどなんのことやら…？ → install の項目にガッツリと書いてある。
--prefer-dist: Reverse of --prefer-source, Composer will install from dist if possible. This can speed up installs substantially on build servers and other use cases where you typically do not run updates of the vendors. It is also a way to circumvent problems with git if you do not have a proper setup.
--prefer-source の逆で、 dist からのインストールを優先する。これによってビルドサーバやアップデートをしないような環境では高速に動作する。あるいは git の設定をしてないときに問題を解決出来る。
–prefer-source の説明も合わせて読んだところ、どうやら composer は dist って呼ばれるところを基本的には利用するらしい。 source はバージョン管理リポジトリで、直接 git clone するようなものになっているので、設定をしてないと問題が起きたりするそう。 GitHub を直接見に行ってエラー、とかそういう感じなのかな？まあ、デフォルトでは dist なので –prefer-dist はあまり気にしなくても良さそう。
で。
3 つめの引数に書いてある bookmarker が作られるディレクトリだ。 カレントディレクトリに bookmarker というディレクトリが作られ、その中に cakephp/app パッケージの内容が展開されているはず。加えて composer install も行われているので bookmarker/vendor ディレクトリも作られている。
まとめ
要は git clone しまっせ、みたいなものだと思っておけばだいたい良さそうだ。