EclipseでPHPの開発環境を構築する

2019年4月13日

どうも。

私が普段PHP書くときはVS Codeを使っているのですが…
EclipseでのPHP開発もメジャーだということでちょっと試してみようと思います。

Eclipseは昔Javaで仕事していた時に使ってて、Javaの統合開発環境というイメージが強いのですが、PHPの開発はやりやすいのでしょうか…。

よくわかるPHPの教科書【PHP7対応版】

1. インストール
- 1.1. ダウンロード
- 1.2. インストール
2. PHPプロジェクトを作成する
3. PHPバージョンの切り替え
4. 追加の設定
- 4.1. ダークテーマの設定
- 4.2. JVM使用メモリ増量

インストール

ダウンロード

公式サイトよりPleiadesの最新版をダウンロードします。
PleiadesはEclipseと日本語化プラグインが一体になったインストールパッケージですね。
https://mergedoc.osdn.jp/

私の環境に合わせ、Windows 64bitのPHPのFull Editionを選択します。

パッケージ内にXAMPPやxdebugも含まれているようですね。

インストール

Eclipseはインストーラー型のソフトウェアではないので、ダウンロードしたZIPを展開して、お好みの場所に配置します。
私はこの手のポータブルアプリは、ユーザディレクトリの配下にtoolsというディレクトリを切ってまとめているのでそこに置きます。

eclipseフォルダの中に入って、「eclipse.exe」を実行します。
XAMPPの構成が一緒に行われます。

ワークスペース（プロジェクトフォルダのベース）になるディレクトリを選択します。
XAMPPで実行するにはそのままの方がいいでしょう。
後で切り替えもできます。

Eclipseが立ち上がりました。

PHPプロジェクトを作成する

それでは簡単なPHPプロジェクトを作っていきます。

ファイル->新規->PHPプロジェクトを選択します。

「新規 PHP プロジェクト」のダイアログが開くので設定していきます。

プロジェクト名
プロジェクト名を設定します設定した名前がプロジェクトフォルダの名前になります。

PHP バージョン
利用するPHPのバージョンを指定します。

JavaScript サポート
JavaScriptのコードインテリジェントを有効にするかを選択します。

ワーキング・セット
ワーキング・セットはワークスペース内のプロジェクトをまとめるグループのことです。
必要なら設定しましょう。

「次へ」を押すと、フォルダの追加やインクルードパスの設定が行えますが、「完了」でプロジェクトを作成しましょう。

プロジェクトが出来上がるので、右クリックして新規PHPファイルを作ります。

ファイル名を設定して「完了」を押します。

簡単なテストコードを書いて実行してみましょう。

Webサーバを起動するため、
pleiadesのフォルダに行きxamppフォルダ内の「xampp-control.exe」を実行。
Apacheを起動します。

「PHP Web アプリケーション」として実行します。

デバッグモードになり実行が止まるので、再開を押して処理を進めます。

ブラウザプレビューが表示され、実行が確認できました。

ただ、プロジェクト作成時PHPのバージョンを7.3にしたはずが5.6になっています。
XAMPPのPHPモジュールを切り替える必要がありそうですね。

PHPバージョンの切り替え

折角なので最新バージョンのPHP7.3を使えるようにします。
PHPのサイトに行き最新版のZIPをダウンロードします。

https://windows.php.net/download#php-7.3

EclipseとXAMPPをいったん終了させて、もともとあった「pleiades\xampp\php」フォルダを「php5.6」にリネームし、ダウンロードしたZIPを回答しphpフォルダとして配置します。

「pleiades\xampp\apache\conf\extra\httpsd-xampp.conf」を開き「php5」を「php7」に置換します。

新しく作ったphpフォルダ内の「php.ini-development」をリネームし「php.ini」にします。
さらに古い方の「php5.6」フォルダの「php.ini」を開き、「pleiades」で検索。
以下のテキストを探し新しい方の「php.ini」に追加or上書きします。

error_log="C:\Users\snish\tools\pleiades\xampp\php\logs\php_error_log"
include_path = C:\Users\snish\tools\pleiades\xampp\php\PEAR
extension_dir = "C:\Users\snish\tools\pleiades\xampp\php\ext"
upload_tmp_dir = "C:\Users\snish\tools\pleiades\xampp\tmp"
browscap = "C:\Users\snish\tools\pleiades\xampp\php\extras\browscap.ini"
session.save_path = "C:\Users\snish\tools\pleiades\xampp\tmp"
curl.cainfo = "C:\Users\snish\tools\pleiades\xampp\apache\bin\curl-ca-bundle.crt"
openssl.cafile = "C:\Users\snish\tools\pleiades\xampp\apache\bin\curl-ca-bundle.crt"
;----------------------------
; Pleiades All in One CUSTOM
;----------------------------
date.timezone = Asia/Tokyo
zend_extension = "C:\Users\snish\tools\pleiades\xampp\php\ext\php_xdebug.dll"
xdebug.remote_enable = 1
xdebug.remote_autostart = 1

古い方のextrasフォルダの中身をすべて新しい方に上書きします。

「php_xdebug.dll」が必要なので下記のサイトにアクセスし、バージョンにあったDLLをダウンロードします。
https://xdebug.org/wizard.php

テキストボックスにコマンドプロンプトで「php -i | clip」をした結果を張り付けてボタンを押すと、対象のDLLのダウンロードリンクが表示されます。

ダウンロードしたものを「php_xdebug.dll」にリネームして「ext」フォルダに配置します。

これで準備完了。EclipseとXAMPP（Apache）を起動して、再度Helloプロジェクトを実行してみる。

「Could not initialize class org.eclipse.php.internal.debug.core.debugger.DebuggerSettingsManager」みたいなエラーが出たので一度ワークスペースを削除し、再度ワークスペースとHelloプロジェクトを作り直します。