LaravelはPHPのフレームワークのひとつで、2016年現在、もっとも注目度が高いフレームワーク(参考)。
Laravel(というか、昨今のトレンドとして)は、コマンドラインで環境構築やライブラリの導入を行うことを前提としているが
今回はCLIに不慣れな開発者が、GUIで一通りの作業がこなせるようにEclipseのプラグインを駆使して開発環境を構築する方法をまとめた。
プラグインの挙動が怪しい & やはりCLIで使えるようになった方が最終的には楽ということで、コマンドラインでの操作も含むこととする。
なお、Windowsでの環境構築を前提とする。
WindowsにはデフォルトでPHPが入っていないので、XAMPPをインストールする。
こちらよりXAMPPのWindows版をダウンロードし、インストールする。
本番サーバの都合上、PHP5.6が入っているバージョンを使うことを推奨する。
今回はC:\xampp
にインストールする前提とする。
内部的にphpコマンドが発行されるため、パスが通っていないと色々失敗する。
こちらを参考に、環境変数のPathにC:\xampp\php
を追加する。
コマンドプロンプトを開いてphp -v
でPHPのパスが通っていることを確認しておくこと。
今回はEclipse 4.6 Neonを使うこととする。
こちらよりEclipse for PHP DevelopersのWindows版をダウンロードし、zipを解凍する。
XAMPPと違って、32bitと64bitがあるので注意。開発マシンは基本64bit機なので、64bitを選択すること。
今回はC:\xampp\eclipse
へ解凍する前提とする。
なお、日本語化すると色々面倒なので、基本英語バージョンで頑張ること。
色々初期設定をしないと、Laravelプロジェクトの生成に失敗する。何事も事前準備が肝要。
EclipseにPHPがどこにインストールされているかを教えてあげる。
Window > Preferences
でPreferencesウインドウを開くPHP > PHP Executables
を選択Add...
ボタンを押してNew PHP Excutableウインドウを開くBrowse...
ボタンを押してファイル選択ダイアログを開くC:\xampp\php\php.exe
を指定するNext >
ボタンを押してDebbger Settingsに遷移するFinish
ボタンで登録、New PHP Excutableウインドウが閉じるOK
ボタンを押して設定完了、ウインドウが閉じるComposerとはPHPでライブラリ間の依存関係を解決するツール。
JavaでいえばMavenやGradle、Node.jsでいうところのnpmと同じ役割。
従来PHPでは、PEARなどで外部ライブラリを管理することが多かったが、OS上に展開されるため、追加にroot権限が必要だったり、複数システムを同一OS上に稼働しているとバージョン競合が起きるなどしていた。
現在、アプリ配下で完結するような依存管理ツールが主流となっており、Composerもそれに沿ったツールとなっている。
本来、ComposerはCLIを想定しているが、PDT Extensions GroupがEclipseのプラグインとして稼働するものを実装しているのでそれを使う。
Help > Install New Software...
でInstallウインドウを開くAdd...
ボタンを押してAdd Repositoryウインドウを開くOK
ボタンで登録、ウインドウが閉じるPDT Extensions
http://p2.pdt-extensions.org/
PDT Extensions - http://p2-dev.pdt-extensions.org/
を選択PHP Development Tools
Toolchains
内のComposer
Next >
ボタンを押してInstall Detailsに遷移Next >
ボタンを押してReview Licensesに遷移I accept the terms of the license agreements
をチェックし、Finish
ボタンを押してインストール開始OK
ボタンを押すYes
ボタンを押してEclipseを再起動するEclipse上でLaravelプロジェクトを新規追加する方法
File > New > Other...
でNewウインドウを開くComposer Project from existing package
を選択してNext >
ボタンを押してNew composer Project from existing packageウインドウに遷移Next >
ボタンを押してSelect packageに遷移laravel
を入力、一覧に出てきたライブラリリストの中からlaravel/laravel (The Laravel Framework.)
のダウンロードボタン(○に↓+ダウンロード数)を押すと右側にバージョンを選択するリストボックスが現れるのでv5.3.16
を選択し、Finish
ボタンを押すと構築が始まるEclipse上でコマンド実行できた方が、別ウインドウでコマンドプロンプトを開くよりも便利なケースがあるのでその設定をしておく。
Run > External Tools > External Tools Configrations...
を選択してExternal Tools Configurationsウインドウを開くNew
アイコンを押すCmd
C:\Windows\System32\cmd.exe
${project_loc}
Run
ボタンを押すせっかくEclipseを使っているので、クラス名やメソッド名を入力補完したいので以下の設定を行う。
> composer require barryvdh/laravel-ide-helper --dev
providers
に以下を追加'providers' => [ ・・・ Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider::class, ],
>php artisan ide-helper:generate