PlugBench ヘルプ
PlugBenchは、Mac用のローカルWebサーバーで、プラグインやテーマの作成とテストを目的としています。このページでは、PlugBenchのすべての機能について説明します。.
はじめる
PlugBench.dmgを開き、PlugBenchをアプリケーションフォルダにドラッグします。- PlugBenchを開きます。初回起動時には、必要なもの(nginx、PHP、MariaDB、Mailpit)が一覧表示されます。これらはすべてHomebrewからインストールされます。
- 「PlugBench をセットアップ」をクリックします。ターミナルが開き、Homebrew がインストールされていない場合はそれも含めて、すべてがインストールされます。Homebrew は一度だけ Mac のパスワードを要求する場合があります。セットアップが完了すると、PlugBench が通知します。
- 「スタート」をクリックし、 「新しいサイト」をクリックします。
必要条件:macOS 14以降、Apple SiliconまたはIntelプロセッサ、サーバー用に約2GBの空き容量。.
ウィンドウを閉じてもサイトは動作し続けます。PlugBenchはメニューバーに残ります。すべてを停止するには、PlugBenchを終了してください。.
窓
- 左側の「サイト」 :各サイトとそのCMS(コンテンツ管理システム)、アドレスが表示されます。いずれかを選択すると、詳細が表示されます。
- サービス:現在稼働中のもののみ。例えば、nginx、PHP 8.5、MariaDB、Mailpit、Redisなど。
- ツールバーのボタン:phpMyAdmin、Adminer、メール、サイト(サイトフォルダを開く)、ログ、バージョン。
- 共有バー:サイトが共有されている間表示され、リンクをコピーしたり共有を停止したりするためのボタンがあります。
- メニューバーのアイコン:開始または停止、ログインしている任意のサイトを開く、共有を停止する、メールを開く。
各サイトのページには、以下のカードが表示されます。
- ヘッダ
- 名前、住所、およびWordPress · PHP 8.5 · MariaDB 13.0のような行。サイトを開くボタンと管理画面を開くボタン。
- PHPとサーバー
- PHPバージョン、メモリ、アップロードサイズ、時間制限、Xdebug、データベースサーバー、HTTPS、ターミナル。.
- iPhone
- iPhoneシミュレーターで開くか、実際のiPhoneでQRコードをスキャンしてください。.
- オンラインで共有
- 一時的な公開HTTPSリンク。.
- 発達
- リンクされたプラグイン、デバッグモード、ログ、およびアップデート。.
- バックアップ
- バックアップ、復元、クローン作成を行う。.
- データベース
- 名前、ユーザー名、パスワード、ポート番号、そしてphpMyAdminで開くためのボタン。.
サイトの作成
「新しいサイト」をクリックし、インストールする項目を選択し、名前を付けて、 「サイトの作成」をクリックします。
| 選択 | 手に入れるもの |
|---|---|
| WordPress | 最新のWordPress。サンプルコンテンツ:なし、写真付きブログ、 17の商品、カテゴリ、顧客、注文を含むWooCommerceストア、またはテストデータ。 |
| Joomla | 最新版のJoomla、ログイン準備完了。. |
| Drupal | DrupalとDrushを使用。記事と写真を掲載した雑誌サンプル(オプション)。. |
| グラブ | フラットファイル型CMS、データベース不要。. |
| Craft CMS、TYPO3、Statamic、Laravel、Symfony | Composerを使ってレシピからインストールしました。 |
| カスタムZIP | ZIPファイルから任意のPHPサイトを抽出できます。オプションでインポート用のSQLファイルも含まれています。クライアントサイトをローカルにコピーするのに使用できます。. |
| 空白 | PHPとデータベースが入った空のフォルダ。ここに独自のコードを記述してください。. |
新規サイト作成ウィンドウのオプション: PHPバージョン、 データベース サーバー、特定のCMSリリース、 WordPressネットワーク 。
各サイトには、 http://my-site.localhost:8801のような固有のアドレス、データベース、管理者が割り当てられます。サイトは、共有設定をしない限り、Mac からのみアクセス可能です。
ワンクリックでサインイン
Open Admin と Open Siteでは、 管理者としてログインできます。パスワードを入力する必要はありません。WordPress、Joomla、Drupal、Craft、Statamicで動作します。
クリックするたびに、2分間有効な使い捨てのサインインリンクが生成されます。管理者名とパスワードは、必要に応じてサイトページに表示されます。.
プラグインのテスト
- 開発画面で、 「プラグインフォルダをリンク…」をクリックし、コーディングを行っているフォルダを選択します。
- PlugBenchはそれをサイトにリンクして有効化します。何もコピーされません。保存した内容はすべて次のページ読み込み時に反映されます。.
- デバッグモードをオンにすると、PHPの通知と警告がデバッグログに書き込まれます。ログを表示するには、 「ログを表示」をクリックしてください。
- 削除すると 、サイトからリンクが解除されます。あなたのフォルダは一切変更されません。
複数のPHPバージョンでプラグインをテストするには、サイトを別のバージョンにクローンするか( 「バックアップ」)、サイトのPHPバージョンを変更します。
サイトごとのPHP
各サイトにはそれぞれ独自のPHPバージョンがあります。 「PHPとサーバー」 。サイトはすぐに新しいバージョンで再起動します。
利用可能なバージョン: PHP 7.4、8.0、8.1、8.2、8.3、8.4、8.5。その他の バージョンは「バージョン」。PHP 7.4 と 8.0 はサポート終了バージョンであり、 Shivammathur/php Homebrew から入手できます。
クライアントのホストに合わせて、サイトごとの設定を行います。
- メモリ:
memory_limit(例:128Mまたは512M)。 - アップロードサイズ:
upload_max_filesizeおよびpost_max_size。 - 時間制限:
max_execution_time(秒単位)。
各設定は、それぞれのサイトにのみ適用されます。.
XdebugとPHP拡張機能
「バージョン」では、インストールされている各PHPに付属する拡張機能が表示されます。いずれかをクリックすると、そのPHPバージョン用にビルドされます(約1分)。
- Xdebug:ステップデバッグ。
- Redis:phpredis、オブジェクトキャッシュプラグイン用。
- Imagick:ImageMagickによる画像編集。
- Memcached:Memcachedオブジェクトキャッシュ用。
次に、 Xdebugを 。XdebugはPHPの各バージョンで無効のままなので、どのサイトでも有効にする必要がなく、コストはかかりません。
VS Code の場合:PHP Debug 拡張機能をインストールし、 [VS Code セットアップのコピー] をクリックして、 .vscode/launch.jsonに貼り付け、 Xdebug のリッスンを開始します。PlugBench はポート 9003 を使用します。PhpStorm はデフォルトで 9003 をリッスンし、同じように動作します。
データベース
デフォルトのサーバーはMariaDBで、ポート3307を使用しているため、既にポート3306で実行されているMySQLと競合することはありません。 バージョン。
- MariaDB 10.6、10.11、11.4、11.8
- MySQL 8.0、8.4、9.7
各サーバーはそれぞれ専用のポートで動作します。サイトを作成する際にポートを選択するか、 データベースサーバー メニューを使用して既存のサイトを移動してください。PlugBenchはデータベースをダンプし、別のサーバーにインポートして、サイトの設定を更新します。
phpMyAdmin と Adminerは 、既にログインした状態で起動し、すべてのサーバーが一覧表示されます。サイトのデータベースカードをクリックすると、それぞれのデータベースが直接開きます。どちらのツールもMacでのみ動作します。
PostgreSQL 17は、ポート5433でサービスとして利用可能です。ユーザー名は postgres、パスワードはMySQLのrootユーザーと同じです。
ローカルHTTPS
- バージョンで、 mkcertをインストールします。
- 「ローカルHTTPSを信頼する…」を一度クリックします。ターミナルは、ローカル認証局を追加するためにMacのパスワードを要求します。
- サイトでHTTPSを有効にします。HTTPS は、ポート番号 + 1000 で提供されます。例:
https://my-site.localhost:9801。
WordPressでは、PlugBenchはデータベース内のサイトアドレスを更新します(マルチサイトも含む)。HTTPSを無効にすると、更新されたアドレスは元に戻ります。.
WordPressマルチサイト
新規サイトでWordPressネットワークを有効にします。/shop/などのサブディレクトリにサイトが配置されたネットワークが作成されます。マイサイト、ネットワーク管理、サイトからサイトを追加してください。クローン、HTTPS、共有機能により、ネットワークは正常に動作します。
ターミナルとWP-CLI
サイト上でターミナルを開くと、そのサイトのフォルダにシェルが開きます。パスの先頭にはサイトのPHPが読み込まれ、 wpも準備完了状態になります。php 、 composer 、 wpはすべてそのサイトのPHPバージョンを使用します。ユーザー自身のシェル設定も読み込まれます。
wp plugin list wp user create editor editor@example.com --role=editor wp eval 'echo get_option("home");'
メール、ログ、デバッグ
- メールが 届きます。サイトから送信されるすべてのメール(パスワードリセット、WooCommerceの注文、問い合わせフォームなど)がそこに届きます。Macから外部に送信されるメールは一切ありません。
- デバッグモードを有効にすると、WordPress の
WP_DEBUGとWP_DEBUG_LOGが有効になります。 - Logsには デバッグログ、PHPエラーログ、nginxエラーが表示されます。clear は テスト前にこれらのログをクリアします。
バックアップ、クローン、アップデート
- 「今すぐバックアップ」を実行すると、 ファイルとデータベースが保存されます。 「復元」を実行する と、最新のバックアップが復元されます。
- クローン機能は 、サイトを新しい名前でコピーし、必要に応じて別のPHPバージョンで実行します。データベース内のアドレスも更新されます。
- 「アップデート」は データベースをバックアップしてからCMSを更新します。WordPressの場合、 「プラグインとテーマの更新」で 残りの部分を更新できます。
- 削除すると 、サイト、データベース、および証明書が削除されます。
サービス
バージョンからインストールしてください。インストール後は、PlugBench と共に起動および停止します。
| サービス | 使用 | 住所 |
|---|---|---|
| Redis | オブジェクトキャッシュプラグイン | 127.0.0.1:6379 |
| Memcached | オブジェクトキャッシュ | 127.0.0.1:11211 |
| PostgreSQL 17 | Laravel、Drupal | 127.0.0.1:5433 |
| Node.js | ブロック開発、ビルドツール | ターミナルパス |
| mkcert | ローカルHTTPS | |
| メールピット | メールを受信する | localhost:8025 |
| クラウドフレア | オンラインで共有 |
iPhone
- 「シミュレーターで開く」をクリックすると、 ログイン済みのiPhoneシミュレーターでサイトが開きます。Xcodeのシミュレーターが必要です。
- 実際のiPhoneの場合: Wi-Fiで共有、iPhoneのカメラでQRコードをスキャンしてください。iPhoneは同じWi-Fiネットワークに接続されている必要があります。完了したら共有をオフにしてください。
AIツール(MCP)
PlugBenchはモデルコンテキストプロトコルに対応しているため、Claude Code、Claude Desktop、CursorなどのAIツールから操作できます。Claude Codeとの接続は、以下のコマンド1つで完了します。
claude mcp add plugbench -- "/Applications/PlugBench.app/Contents/MacOS/plugbench" mcp
例えば、次のように質問してください。 「WooCommerce ストアを作成し、~/Code/my-plugin をリンクし、デバッグを有効にして、注文を行い、PHP の警告が表示されるかどうか教えてください。」
26種類のツール:
run_phpは 、管理者としてログインした状態でWordPress内でコードを実行します。iphone_screenshot は 、AIがiPhoneでサイトを閲覧できるようにします。
コマンドライン
アプリのすべての機能はターミナルからも動作します。ツールをパスに追加してください。
ln -s /Applications/PlugBench.app/Contents/MacOS/plugbench /opt/homebrew/bin/plugbench
| サービス | |
|---|---|
プラグベンチ 開始 | 停止 | ステータス | 制御サービス |
プラグベンチドクター | 検出されたツールを表示する |
プラグベンチバージョン | PHP、データベースサーバー、および関連サービスの一覧 |
プラグベンチ追加<formula> | php@7.4やmysql@8.0などをインストールしてください。 |
プラグベンチ拡張機能<php><name> | xdebug、redis、imagick、またはmemcachedをビルドする |
| サイト | |
プラグベンチリスト | サイト一覧 |
プラグベンチのインストール<cms><name>[ソース] | サイトを作成します。オプション: --sample、 --version、 --sql、 --database、 --php、 --multisite |
プラグベンチ情報<slug> | 詳細情報とログイン情報をJSON形式で表示 |
プラグベンチログイン<slug>[管理者|フロント] | ワンタイムサインインリンクを印刷する |
プラグベンチ削除<slug> | サイトを削除する |
プラグベンチのリネームアドレス<slug> | 古いサイトを slug.localhost |
| PHPとサーバー | |
プラグベンチphp<slug><version> | PHPのバージョンを変更する |
プラグベンチのPHP設定<slug><name><value> | メモリ制限、アップロード最大ファイルサイズ、最大実行時間 |
プラグベンチ xdebug<slug>オン|オフ | ポート9003でXdebugを実行 |
plugbench move-db<slug><formula> | データベースを移動するか、 デフォルト設定 |
プラグベンチ https<slug>オン|オフ | ローカルHTTPS |
プラグベンチ端子<slug> | サイトのPHPとWP-CLIが動作するターミナル |
| プラグインとデバッグ | |
プラグベンチリンク<slug><folder> | プラグインをリンクして有効化する |
プラグベンチリンク解除<slug><folder> | リンクされたプラグインを削除する |
プラグベンチプラグイン<slug> | プラグインをJSON形式で一覧表示 |
プラグベンチデバッグ<slug>オン|オフ | WP_DEBUG ログ |
プラグベンチログ<slug>[行] | ログを表示する |
プラグベンチログのクリア<slug> | 空のログ |
プラグベンチ実行<slug><file.php|-> | サイト内でPHPを実行する |
プラグベンチメール | 受信したメールの一覧 |
| バックアップとアップデート | |
プラグベンチのバックアップ | リストア<slug> | バックアップまたは復元 |
プラグベンチクローン<slug><name>[php] | サイトをコピーする |
プラグベンチバージョン<slug> | インストール済み、最新のCMSバージョン |
プラグベンチのアップデート<slug> | CMSを更新する |
プラグベンチのアップデート拡張機能<slug> | プラグインとテーマを更新する |
| ツールと共有 | |
プラグベンチ phpmyadmin [slug] | phpMyAdminアドレス |
プラグベンチ管理者 | 管理者アドレス |
プラグベンチ共有オン|オフ | Wi-Fi共有 |
プラグベンチ共有オンライン<slug>[メール|停止] | 公開リンク |
プラグベンチ iPhone<slug> [パス] | シミュレーターとスクリーンショット |
プラグベンチのレシピ | レシピ一覧 |
プラグベンチライセンス[有効化]<key> | 無効化] | ライセンス |
プラグベンチmcp | MCPサーバーを実行する |
レシピ:独自のCMSを追加
レシピとは、PlugBenchにCMSやフレームワークのインストール方法を指示する小さなJSONファイルです。レシピを ~/Library/Application Support/PlugBench/recipes/ と、「新規サイト」に表示されます。
{ "id": "winter", "title": "Winter CMS", "summary": "LaravelベースのCMS。", "minimumPHP": "8.1", "composer": "wintercms/winter", "docroot": "", "adminPath": "/backend", "env": { "file": ".env", "copyFrom": ".env.example", "values": { "APP_URL": "{url}", "DB_HOST": "{db_host}", "DB_PORT": "{db_port}", "DB_DATABASE": "{db_name}", "DB_USERNAME": "{db_user}", "DB_PASSWORD": "{db_password}" } }, "steps": [ ["php", "artisan", "winter:up"] ] }
メインフィールド:ソースの場合はcomposerまたはzip 、配信フォルダの場合はdocroot 、フラットファイル CMS の場合はdatabase: false 、ワンクリックサインインの場合はloginWithEmailとloginCommand 。プレースホルダー: {url} 、 {root} 、 {db_host} 、 {db_port} 、 {db_name} 、 {db_user} 、 {db_password} 、 {admin_user} 、 {admin_password} 、 {admin_email} 。
「新規サイト」で「レシピを追加…」をクリックすることもできます。信頼できるレシピのみを追加してください。レシピの手順は、あなたのユーザーアカウントで実行されます。
plugbench recipes には、 PlugBench が認識するレシピが一覧表示されます。
無料版とプロ版
| 無料 | プロ版、29ドル(初回のみ) | |
|---|---|---|
| サイト | 3 | 無制限 |
| すべてのCMS、PHP、データベースのバージョン、Xdebug、HTTPS、バックアップ、phpMyAdmin、Mailpit | はい | はい |
| オンライン共有とWi-Fi共有 | はい | |
| iPhoneツール | はい | |
| AIツール(MCP) | はい |
メインページのライセンスカードでキーを有効化するか、 plugbenchライセンスでKEYを有効化してください。キーはMacで使用できます。キーを移動するには、無効化してください。PlugBenchは週に一度キーをチェックし、オフライン状態でも30日間動作します。
物がどこにあるか
| サイト | ~/PlugBench/<slug> |
| 設定、ログ、データベース、バックアップ | ~/Library/Application Support/PlugBench |
| あなたのレシピ | …/PlugBench/recipes |
| バックアップ | …/PlugBench/backups |
| ログ | …/PlugBench/logs |
| サーバー | Homebrew、 /opt/homebrew |
港
| サイト | ポート8801以上、HTTPSは同じポート+1000で利用可能 |
| phpMyAdmin | 8799 |
| 管理者 | 8800 |
| メールピット | 8025 (Web)、1025 (SMTP) |
| MariaDB、デフォルト | 3307 |
| その他のデータベースサーバー | 3308以上 |
| Redis、Memcached、PostgreSQL | 6379, 11211, 5433 |
| Xdebug | 9003(編集者は耳を傾けています) |
Wi-Fi共有がオンになっている間は、サイトを除き、すべてが127.0.0.1のみでリッスンします。
トラブルシューティング
起動に失敗するか、サービスが停止したままになる
ログを開いてエラーを確認してください。ポートは、MAMP や Valet などの別のサーバーによって既に使用されている可能性があります。そのサーバーを終了して、再度「開始」をクリックしてください。plugbench doctor は、 PlugBench が検出した内容を一覧表示します。
セットアップがターミナルで停止しました
ターミナルに表示される最後の行を読んでください。HomebrewはパスワードまたはXcodeコマンドラインツールを要求する場合があります。それらに答えてから、 「PlugBenchの設定」を もう一度クリックしてください。処理は中断したところから再開されます。
Open Adminではサインインページが表示されます
ログインリンクは2分間有効で、一度だけ機能します。もう一度「管理者を開く」をクリックしてください。それでも失敗する場合は、管理者パスワードがサイトページに記載されています。.
ブラウザがHTTPSについて警告する
「バージョン」で「ローカルHTTPSを信頼する…」を一度クリックしてから、ブラウザを再起動してください。Firefoxが信頼するには、Homebrewからインストールされたnssが必要です。
拡張機能は構築しません
PHPへの拡張機能の追加はHomebrewからのみ可能です。ターミナルの出力をログで確認してください。xcode -select --installコマンド 多くの場合問題が解決します。
Xdebugはブレークポイントで停止しない
サイトのXdebugが有効になっていること、エディタがポート9003でリッスンしていること、そしてブラウザのリクエストが同じサイトから送信されていることを確認してください。ターミナルでのコマンドはXdebugを無効にして実行されます。.
iPhoneではサイトを開くことができません
Wi-Fi共有をオンにし、両方のデバイスが同じWi-Fiネットワークに接続されていることを確認し、macOSから着信接続の許可を求められた場合は許可してください。ゲストネットワークは、デバイス同士の通信をブロックすることがよくあります。.
共有リンクが機能しなくなりました
Cloudflare Quick Tunnelのリンクは一時的なもので、共有が停止したりMacがスリープ状態になったりすると無効になります。新しいリンクを取得するには、再度共有してください。.
PlugBenchを完全に削除するにはどうすればよいですか?
PlugBenchを終了し、アプリケーションフォルダから削除してください。さらに、 ~/Library/Application Support/PlugBenchと~/PlugBenchも削除してください。Homebrewパッケージは残りますので、必要に応じてbrew uninstallコマンドで削除してください。