FuelPHPの開発環境を20分で構築する（Vagrant編）

FuelPHP Advent Calendar 2013の2日目です。昨日は、@sharkppさんの「FuelPHPをphar化してポータブルに！」でした。

従来は、FuelPHPの開発環境を構築する場合、XAMPPやMAMPを使う方法が一般的でした。この方法は簡単に手許のPCに開発環境を構築でき便利なのですが、開発環境と本番環境のPHPのバージョンが異なったり、開発環境はWindowsやMacだが本番環境はLinuxであったりと、ほとんどの場合、本番環境と開発環境が異なるという問題がありました。

PHPのポータビリティはかなり高いので、多くの場合、実際には問題は生じませんが、ファイル名の大文字小文字の違いやパーミッション、PHPのバグなど、本番環境だけで問題が発生するということも可能性としてはあります。

この問題を解消するには、開発環境と本番環境をできる限り一致させることが望ましいです。そこで、本番と同じような仮想マシンを作成し、そこで開発をすれば開発環境と本番環境をほとんど一致させることが可能になります。

本日は、VirtualBoxとVagrantを使って、FuelPHPのためのそのような開発環境を簡単に作成する方法を解説します。

なお、この方法のデメリットは、仮想マシンを維持するためのリソースが余計に必要となることです。OSからまるごとインストールするわけですから、ハードディクスの容量もその分多く必要になりますし、仮想マシン実行のオーバーヘッドがありますので、実効速度もネイティブで動作しているWebサーバ／PHPより、多くの場合、遅くなるでしょう。

VirtualBoxとVagrantのインストール

フリーな仮想化ソフトウェアであるVirtualBoxを、以下からダウンロードしインストールします（執筆時の動作確認バージョンはVirtualBox 4.3.2）。

https://www.virtualbox.org/wiki/Downloads

VirtualBoxの仮想イメージを操作するツールであるVagrantを、以下からダウンロードしインストールします（執筆時の動作確認バージョンはVagrant 1.3.5）。

http://downloads.vagrantup.com/

これで準備は完了です。

仮想マシンの作成

FuelPHPのプロジェクト用のフォルダを作成し、その中にVagrant用のファイルを配置します。

$ mkdir fuelphp
$ cd fuelphp/
$ git clone git@github.com:kenjis/vagrant-fuelphp-centos6.git
$ cd vagrant-fuelphp-centos6/
$ git submodule update --init --recursive

仮想マシンを構築します。

$ vagrant up

初回はCentOS6の仮想イメージをダウンロードするため、かなり時間がかかりますので気長に待ちます（このダウンロード時間を含めると20分で開発環境を構築するのは無理です）。

これで、仮想マシンが作成され、FuelPHPの開発に必要なサーバなどもインストール設定されます。

FuelPHPがインストールされていない場合は、oil createコマンドでインストールされます。

これで、http://localhost:8000/にアクセスすれば、おなじみのFuelPHPのWelcomeページが表示されます。

ディレクトリ構成

ホスト（手許のPC）側

fuelphp/（FuelPHPプロジェクトのトップ）
├── docs
├── fuel
├── public
└── vagrant-fuelphp-centos6

ゲスト（仮想マシン）側

/mnt/fuelphp/
├── docs
├── fuel
├── public
└── vagrant-fuelphp-centos6

仮想マシンから、ホスト側のfuelphpフォルダを共有しているので、ホスト側から好きなエディタでソースを変更すれば、仮想マシンに自動的に反映されます。

テストの実行

vagrant-fuelphp-centos6フォルダから、vagrant sshコマンドで仮想マシンにSSHで接続できます（Windowsを除く）。

$ cd fuelphp/vagrant-fuelphp-centos6/
$ vagrant ssh
Last login: Mon Dec  2 01:11:37 2013 from 10.0.2.2
Welcome to your Vagrant-built virtual machine.

ホームディレクトリにシンボリックリンクが張ってあるので、/mnt/fuelphpフォルダには~/fuelphpでアクセスできます。

oilコマンドとphpunitもインストール済みなのですぐに実行できます。

[vagrant@localhost ~]$ cd fuelphp/
[vagrant@localhost fuelphp]$ oil test --group=Core
Tests Running...This may take a few moments.
PHPUnit 3.7.28 by Sebastian Bergmann.

Configuration read from /mnt/fuelphp/fuel/core/phpunit.xml

...............................................................  63 / 361 ( 17%)
............................................................... 126 / 361 ( 34%)
............................................................... 189 / 361 ( 52%)
............................................................... 252 / 361 ( 69%)
............................................................... 315 / 361 ( 87%)
..............................................

Time: 7.92 seconds, Memory: 19.25Mb

OK (361 tests, 413 assertions)