統合開発環境にNetBeansを、テスト環境にXAMPPを導入する方法を紹介します。

XAMPP for Windows

XAMPPは、いわゆるLAMP環境（Linux, Apache, MySQL/MariaDB, PHP/Perl）をWindows上に構築するソフトウェアです。

りゅう

VirtualBox等の仮想マシンやDockerのコンテナでLinuxを起動して、LAMP環境を構築する方法もあります。

XAMPPには、大きく分けるとインストーラ版と手動インストール版の2種類があります。ここでは後者のZIP版をダウンロードすることにします。

https://www.apachefriends.org/jp/

大きいファイルですので、ダウンロードには少々時間がかかります。

XAMPPの解凍とインストール

ダウンロードが完了したら、C:ドライブ直下に解凍しましょう。xamppというフォルダの中にゴチャゴチャとファイルができていればOKです。

このフォルダ構成は「標準的な構成」であり、これでインストールは完了です。

もし上記以外のフォルダ構成にした場合は、解凍したファイルにあるsetup_xampp.batを実行しておきましょう。これでXAMPPの構成設定が更新されます。

XAMPPの設定変更

このままでも既にXAMPPは実行可能な状態なのですが、ここではNetBeansでPHPアプリケーションの開発を行うという前提で、必要となる設定をしていきます。

PHPのモジュールを設定する

当然のように使用するモジュールが使えなかったりするので、php.iniをテキストエディタで開いて編集します。

エクスプローラから直接エディタを起動しても良いですし、xampp-control.exeを実行してApacheの「Config」ボタンをクリックしても設定ファイルを開くことができます。というか後者のほうがラクでしょう。

右側にある「Config」から、使用するエディタの設定もできたりします。

いずれかの方法でphp.iniを編集できる状態になったら、990行目あたり以降のextension=php_*.dllが羅列してある部分を変更します。

;extension=php_openssl.dll

↓ コメントを外す

extension=php_openssl.dll

これでSSLモジュールが使用できるようになりました。PHPのComposerが動かない！といった場合はコレが悪さをしている可能性大です。なぜ無効にしてあるのかは不明です。

他に、せっかくXAMPPにはMercuryという聞きなれないメールサーバも付属していますので、imapモジュールも有効にしておきたいところです。

;extension=php_imap.dll

↓ コメントを外す

extension=php_imap.dll

PHPのXdebugを有効にする

これも、主に開発環境の一部として使われるXAMPPでなぜ無効にしてあるのかわかりませんが、デバッグを行うためのXdebugが無効になっているので有効にします。

;zend_extension = "C:¥xampp¥php¥ext¥php_xdebug.dll"

↓ コメントを外す

zend_extension = "C:¥xampp¥php¥ext¥php_xdebug.dll"

そして設定値が色々ありますが、面倒なので以下をコピペして最終行に追記しておきましょう。

xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000
xdebug.remote_handler="dbgp"
xdebug.profiler_enable=1
xdebug.profiler_output_dir="C:¥xampp¥tmp"

MySQLの設定を変更する

同じようにして、MySQLの設定ファイルであるmy.iniを編集します。Linux等では/etc/my.cnfだったりするアレです。

デフォルトで使用する文字コードをUTF-8にする設定です。

まずは[mysqld]の下に以下の行を追記します。

character-set-server = utf8

そして[mysql]と[mysqldump]それぞれの下に以下の行を追記します。

default-character-set = utf8

XAMPPの実行と自動実行の設定

ここまでで、大抵の本番環境と似た状態になったと思います。

早速XAMPPを起動してみましょう。起動するのはxamppフォルダにあるxampp-control.exeです。

デスクトップなどにショートカットを作っておくと便利です。

起動したら、まず右端にある「Config」ボタンをクリックしましょう。そして、今後のXAMPP起動時に自動実行したい項目を選択しておきます。

ここではApache, MySQL, Mercuryを自動実行するよう設定しておきました。よく見るとテキストエディタも変更してあります。

ほかに、起動時に最小化してくれる「Start Control Panel Minimized」も地味に便利です。

「Save」したら再起動しても良いですし、このままApacheなどの「Start」ボタンをクリックしてもOKです。

NetBeansの設定

NetBeansで、XAMPPを使用するための設定をしておきます。

まずは「ツール」→「オプション」と進み、オプションダイアログの上部アイコン「PHP」をクリックします。

そして「一般」タブにある「PHP 5インタプリタ」の項目に、インストールしたXAMPPのphp.exeを指定します。

次に「デバッグ」タブを開き、不要だと思われる「最初の行で停止」のチェックを外しておきます。

まとめ

これで、NetBeansとXAMPPを使ったWebアプリケーション開発とデバッグができるようになりました。

NetBeansでは、さらにPHPUnitによるユニットテストや、各種PHPフレームワークのプラグインなども豊富に揃っていますので、公式サイトやGoogle先生を参考に色々調べてみてください。

りゅう

大手のSymfonyやZend Frameworkだけでなく、CakePHPやFuelPHP等のプラグインもあります。

CentOS 6の開発環境を一発で構築するスクリプトを公開しました。NetBeansやRedmineも紹介します。

GitHubのリポジトリ

https://github.com/ryu-blacknd/bootstrap

りゅう

気が向いた時に更新するかもしれません。

想定している開発フロー

1. Redmineでプロジェクト管理
2. NetBeansで開発
3. ローカルのGitリポジトリでコミット
4. リモートのベアリポジトリへプッシュ(Redmineが参照するのはココ)
5. 本番環境リポジトリ(/var/www/html以下)で自動プル

スクリプトの概要

• セキュリティ関係の設定(ローカル開発環境なので甘々に設定)
• yumのリポジトリを追加(epel, remi)
• yum updateと、必要なパッケージのインストール
• 不要なサービスの停止
• LAMP環境のインストールと最低限の設定
• RubyとPassenger周りのインストール
• Gitユーザーの作成と関連する設定
• phpMyAdminのインストール
• Redmine本体、テーマ、プラグインをインストール
• おまけ：ベアリポジトリ用フックスクリプトの雛形

詳細は、シェルスクリプトを読んでみてください。たいしてトリッキーなことはしていません。

動作環境

• LAN内のサーバPC、またはVirtualBox等の仮想マシン(Vagrant可)
• CentOS6 x86/64 minimal isoイメージでのインストール直後であること

インストール

rootでログインし、gitをインストール後、取得したbootstrap.shを実行するだけです。

yum -y install git
cd
git clone https://github.com/ryu-blacknd/bootstrap.git
chmod +x bootstrap/bootstrap.sh
bootstrap/bootstrap.sh

ほぼノンストップで進みますが、Passengerのインストール時のみ画面に表示される通りEnterを押して進んでください。

※2013.10.16 追記：Passengerインストール時にEnterを自動入力することで、ノンストップになりました。

インストール後はシステムを再起動します。

reboot

開発に関する情報

*1 NetBeansでのプッシュ先リポジトリ = Redmineでの参照リポジトリ

*2 開発ユーザー毎にSSH公開鍵を作成し、このファイルに追記していく(後述)

初回の開発フロー

初回のみGit絡みで面倒ですが、以下のフローが済めば、以降は自動化され楽になります。

1. [サーバ] ユーザーgituserでSSHログイン
2. [サーバ] /var/repos/[プロジェクト名]を作成し、ディレクトリ内でgit init --bare
3. [ローカル] NetBeansでローカルのリポジトリにファーストコミット
4. [ローカル] NetBeansから先ほど作成したベアリポジトリにプッシュ
5. [ローカル] Redmineで新規プロジェクトを作成、リポジトリを設定、ユーザー割り当て
6. [サーバ] cd /var/www/htmlしてgit clone /var/repos/[プロジェクト名]
7. [サーバ] /var/repos/[プロジェクト名]/.git/hooks/にpost-updateをコピーして編集

post-updateファイルはユーザーrootのホームディレクトリにあるため、gituserはアクセスできません。

chown gituser. post-update

としておき、gituserのホームディレクトリにでもコピーしておくとよいでしょう。

post-updateのコピーと編集

フックスクリプトpost-updateは、プロジェクトを作成する毎に手動でコピー、****の部分を編集します。

#!/bin/sh
/usr/bin/wget -q -O /dev/null http://localhost/redmine/sys/fetch_changesets?key=****
(cd /var/www/html/**** && git --git-dir=.git pull)

2行目は、Redmineの 管理 → 設定 → リポジトリ で生成したAPIキーを記述します。

3行目は、上記手順のプロジェクト名(=リポジトリのディレクトリ名)を記述します。

これで冒頭に書いたようなフローの準備が整いました。

以後はNetBeansで、ローカルコミットとベアリポジトリへのプッシュを繰り返して開発を進めます。

コミット・メッセージでチケットの状態を更新する

NetBeansからのコミット時は、コミット・メッセージの文末にrefs #1 @1.5h等を付与すると、Redmineのチケットと連携することができます。

このとき、作成者とコミッタをRedmineのユーザー名に合わせるようにしてください。

上記ユーザー名がRedmine側と一致しない場合は、チケット連携が正常に行われません。その場合はプロジェクト毎の 設定 → リポジトリ から、ユーザーの関連付けを行ってください。

※詳しくはこちらを参照してください。

http://blog.redmine.jp/articles/new-feature-1_1/automatic-spent-time-logging/

リポジトリへのアクセスにSSH鍵認証を利用する

ユーザー毎のSSH公開鍵をユーザーgituserのauthorized_keysに追記していきます。

以下の手順でSSH公開鍵と秘密鍵のペアを生成します。

ssh-keygen -C user@example.com

なお、この鍵ペアを外部サーバへの接続用途に使わないのであれば、パスフレーズは無視して構いません。

これでユーザーのホームディレクトリに2つの鍵ファイルが作成されます。

この公開鍵をサーバ管理者に渡し、管理者はgituserユーザーで~/.ssh/authorized_keysに追記します。

cd ~/.ssh
cat id_rsa.pub >> authorized_keys

次にNetBeans側で、「秘密鍵ファイル」に上記の秘密鍵ファイルを指定すれば、リポジトリにアクセスすることができるようになります。