PlugBench ヘルプ

PlugBenchは、Mac用のローカルWebサーバーで、プラグインやテーマの作成とテストを目的としています。このページでは、PlugBenchのすべての機能について説明します。.

はじめる

  1. PlugBench.dmgを開き、PlugBenchをアプリケーションフォルダにドラッグします。
  2. PlugBenchを開きます。初回起動時には、必要なもの(nginx、PHP、MariaDB、Mailpit)が一覧表示されます。これらはすべてHomebrewからインストールされます。
  3. 「PlugBench をセットアップ」をクリックします。ターミナルが開き、Homebrew がインストールされていない場合はそれも含めて、すべてがインストールされます。Homebrew は一度だけ Mac のパスワードを要求する場合があります。セットアップが完了すると、PlugBench が通知します。
  4. 「スタート」をクリックし、 「新しいサイト」をクリックします。

必要条件: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、ログイン準備完了。.
DrupalDrupalとDrushを使用。記事と写真を掲載した雑誌サンプル(オプション)。.
グラブフラットファイル型CMS、データベース不要。.
Craft CMS、TYPO3、Statamic、Laravel、SymfonyComposerを使ってレシピからインストールしました。
カスタムZIPZIPファイルから任意のPHPサイトを抽出できます。オプションでインポート用のSQLファイルも含まれています。クライアントサイトをローカルにコピーするのに使用できます。.
空白PHPとデータベースが入った空のフォルダ。ここに独自のコードを記述してください。.

新規サイト作成ウィンドウのオプション: PHPバージョン、 データベース サーバー、特定のCMSリリース、 WordPressネットワーク 。

各サイトには、 http://my-site.localhost:8801のような固有のアドレス、データベース、管理者が割り当てられます。サイトは、共有設定をしない限り、Mac からのみアクセス可能です。

ワンクリックでサインイン

Open Admin と Open Siteでは、 管理者としてログインできます。パスワードを入力する必要はありません。WordPress、Joomla、Drupal、Craft、Statamicで動作します。

クリックするたびに、2分間有効な使い捨てのサインインリンクが生成されます。管理者名とパスワードは、必要に応じてサイトページに表示されます。.

プラグインのテスト

  1. 開発画面で、 「プラグインフォルダをリンク…」をクリックし、コーディングを行っているフォルダを選択します。
  2. PlugBenchはそれをサイトにリンクして有効化します。何もコピーされません。保存した内容はすべて次のページ読み込み時に反映されます。.
  3. デバッグモードをオンにすると、PHPの通知と警告がデバッグログに書き込まれます。ログを表示するには、 「ログを表示」をクリックしてください。
  4. 削除すると 、サイトからリンクが解除されます。あなたのフォルダは一切変更されません。

複数の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

  1. バージョンで、 mkcertをインストールします。
  2. 「ローカルHTTPSを信頼する…」を一度クリックします。ターミナルは、ローカル認証局を追加するためにMacのパスワードを要求します。
  3. サイトで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 17Laravel、Drupal127.0.0.1:5433
Node.jsブロック開発、ビルドツールターミナルパス
mkcertローカルHTTPS
メールピットメールを受信するlocalhost:8025
クラウドフレアオンラインで共有

iPhone

  • 「シミュレーターで開く」をクリックすると、 ログイン済みのiPhoneシミュレーターでサイトが開きます。Xcodeのシミュレーターが必要です。
  • 実際のiPhoneの場合: Wi-Fiで共有、iPhoneのカメラでQRコードをスキャンしてください。iPhoneは同じWi-Fiネットワークに接続されている必要があります。完了したら共有をオフにしてください。

サイトを共有する

Share Onlineは、 サイトに一時的な https://…trycloudflare.com リンクを提供します。アカウントは不要です。このリンクをクライアントに送信して、Mac上で動作するサイトを確認してもらいましょう。

  • 閲覧できるユーザーを制限するには、メールアドレスまたは *@client.com。Cloudflare は、訪問者に最初にメールアドレスの確認を求めます。
  • 「オンラインで共有」と「リンクをコピー」をクリックすると 、共有が開始され、リンクがクリップボードにコピーされます。 「招待状をコピー」をクリックすると、 リンク付きの送信準備済みのメッセージがコピーされます。
  • サイト上の「オンライン共有を停止」 、共有バーの「すべて停止」 、またはメニューバーの「すべての共有を停止」をクリックすると、共有が即座に停止します。リンクは機能しなくなります。

WordPressのページ、画像、ログインリンクは、訪問者が使用するアドレスに関係なく表示されます。.

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種類のツール:

サイト一覧サイト情報 ステータスサービス作成サイト 一覧 PHP設定Xデバッグ設定データベース移動 一覧 プラグインリンク プラグインリンク解除プラグインアクティブ 設定デバッグ設定 ログ読み取り ログクリアPHP実行 メール読み取り サイトバックアップ サイト復元ログインURLiPhoneスクリーン ショット オンライン共有ネットワーク共有

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> | 無効化]ライセンス
プラグベンチmcpMCPサーバーを実行する

レシピ:独自の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で利用可能
phpMyAdmin8799
管理者8800
メールピット8025 (Web)、1025 (SMTP)
MariaDB、デフォルト3307
その他のデータベースサーバー3308以上
Redis、Memcached、PostgreSQL6379, 11211, 5433
Xdebug9003(編集者は耳を傾けています)

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コマンドで削除してください。

ご質問は support@nextstarsystems.comまで。