HmPHPSimpleServer

秀丸エディタのブラウザ枠機能を利用して、PHPやHTMLファイルのプレビューをリアルタイムで行うための簡易HTTPサーバーです。

解説ページ

主な機能

• 簡易Webサーバー: PHPのビルトインサーバー機能を利用して、ローカルWebサーバーを起動します。
• ライブリロード: ファイルを保存すると、表示中のブラウザ枠が自動的にリロードされます。
• フォルダ監視: CSS/JavaScript/画像ファイルなど、指定した拡張子のファイルが変更された場合も、自動でリロードします。
• 動的ドキュメントルート: 秀丸エディタで開いているファイルの場所を基準に、ドキュメントルートが自動で設定されます。
• ポート自動選択: 起動時に利用可能なポートを自動で検索するため、ポートの競合を心配する必要がありません。
• 簡単な導入: 秀丸エディタのマクロフォルダにファイルを配置するだけで、すぐに利用を開始できます。

動作環境

• 秀丸エディタ: v9.22 以降
• .NET Framework: 4.7.2 以降
• PHP: 7.x / 8.x (別途インストールが必要です)

インストール方法

1. PHPの準備:

   • PCにPHPがインストールされていない場合は、PHP for Windows から「Zip」版をダウンロードし、任意のフォルダに展開してください。
   • 例: C:\usr\php

2. マクロのダウンロード:

   • リリースページから最新版のHmPHPSimpleServer.zipをダウンロードします。

3. ファイルの配置:

   • ダウンロードしたzipファイルを展開します。
   • 中に含まれている以下の2つのファイルを、秀丸エディタのマクロ用フォルダ（hidemaru.exeがある場所のmacフォルダなど）にコピーします。
     • HmPHPSimpleServer.mac
     • HmPHPSimpleServer.dll

設定方法

設定は、マクロファイル HmPHPSimpleServer.mac を直接編集して行います。

// =================================================
// ● PHP実行ファイルへのフルパス
// =================================================
// PCにインストールしたphp.exeのフルパスを指定してください。
$PHP_FULLPATH = @"C:\usr\php\php.exe";

// =================================================
// ● ファイル監視による自動リロードの有効化
// =================================================
// 1: 有効, 0: 無効
#NOTIFY_FILE_WATCHER = 1;

// =================================================
// ● 自動リロードの対象となるファイルの拡張子（正規表現）
// =================================================
// この正規表現にマッチするファイルが変更されると、ブラウザがリロードされます。
$NOTIFY_FOLDER_CHANGE_FILTER = "\.php|\.html|\.htm|\.css|\.js|\.png|\.jpg|\.jpeg";

// =================================================
// ● PHPサーバーのドキュメントルート（上級者向け）
// =================================================
// 通常は空白のままで問題ありません。
// 空白の場合、現在開いているファイルのフォルダがドキュメントルートになります。
$PHP_DOCUMENTROOT = getarg(0);

特に、$PHP_FULLPATHはご自身の環境に合わせて必ず設定してください。

使い方

1. プレビューしたいPHPまたはHTMLファイルを秀丸エディタで開きます。
2. [マクロ]メニューからHmPHPSimpleServer.macを実行します。
3. 秀丸エディタのブラウザ枠が開き、プレビューが表示されます。
4. ファイルを編集して保存すると、プレビューが自動的に更新されます。

ライセンス

このプロジェクトは MITライセンス の下で公開されています。