開発者向け CLI である Zinnector® の使い方

Node 24以降に無料の Zinnector CLIをインストールし、2分で動作することを確認します（--version、--help、サイトの構築、Dockerなしでのローカルでの実際の WordPress の実行、ブラウザでのオープン。各ステップでの成功状態も確認できます）。

Zinnector® は、WordPress 開発者向けの Zinn Digital® 製無料 MIT ライセンスコマンドラインツールです。サイトの雛形を作成し、Node 以外のインストール不要で（Docker も MAMP も PATH 上の PHP も不要）、ご自分のマシン上で実際の WordPress を実行します。次に、これからデプロイするホスティング枠に対してビルド内容をチェックし、プッシュします。このガイドでは、何もない状態から約 2 分でサイトを稼働させる手順を説明し、各ステップで成功している状態がどういうものかを示すことで、どこかで問題が発生した際にそれを把握できるようにします。

必要なもの

Node 24 以降。 node --version を実行してください。v24 またはそれ以降が表示される必要があります。現在の LTS を nodejs.org からインストールします（Windows の場合は winget install OpenJS.NodeJS.LTS、macOS の場合は brew install node@24）。
npm（Node に付属しています）。Zinnector® は、WordPress ランタイムを独自のキャッシュにダウンロードするために一度だけこれを使用します。
git（zinnector push のみで使用。デプロイはリポジトリから実行されます）。
Docker（--runtime docker を指定した場合のみ）。デフォルトのランタイムでは不要です。

以下の手順では、アカウントは一切必要ありません。Zinnector® を使用したデプロイでホスティング枠に到達した場合にのみ API キーが必要になります。

ステップ 1 — インストールする

npm install -g zinnector

npm が npm WARN EBADENGINE を出力した場合、お使いの Node のバージョンが、パッケージが宣言している >=24.18.1 よりも古いです。インストール自体は完了しますが、CLI は実行を拒否します。まず Node をアップグレードしてから、再度インストールしてください。

ステップ 2 — バージョンを確認する

zinnector --version

成功: バージョン番号（例: 0.1.2）。“Zinnector® needs Node 24 or newer — this is Node 20.x” と表示された場合、バイナリはインストールされていますが Node が古すぎます。コマンドは何も実行せず、終了コード 78 で終了します。

ステップ 3 — ヘルプを読む

zinnector --help

成功: フローの 5 つのコマンド（new、dev、link、check、push）の名前を挙げたバナーが表示され、続いて各コマンドの 1 行の目的が表示されます。各コマンドは独自の --help も受け付けます（zinnector dev --help は、ランタイム、PHP、およびポートのフラグを一覧表示します）。例を含む完全なリストは、コマンドリファレンスにあります。

ステップ 4 — サイトの雛形を作成する

zinnector new my-site

成功: Created my-site という見出しと、書き込まれたファイルの一覧（zinnector.json、plugins/、themes/、および mu-plugins/ ヘルパーを含む wp-content ツリー、.gitignore、README）が表示され、その後に次に実行すべきコマンドが続きます。プレースホルダーは含まれておらず、プロジェクトはそのままで起動します。--template plugin または --template theme を使用すると、存在した瞬間に有効化されるプラグインまたはブロックテーマの雛形が作成されます。

ステップ 5 — 実行する

cd my-site
zinnector dev

初回実行時、Zinnector® は WordPress ランタイムをプロジェクト内ではなく独自のキャッシュディレクトリにダウンロードする前に、1 度確認を求めます（5.2 から 8.5 までのすべての PHP ビルドが含まれているため、約 570 MB です）。Y と答えるか、--yes を渡して質問をスキップしてください。Node 26 以降では、ランタイムのネイティブモジュールに Node 24 および 25 用のビルド済みバイナリしか含まれていないため、ランタイム専用の Node 24（nodejs.org のチェックサムで検証済み、約 30 MB）も取得します。コンパイラや Visual Studio は必要ありません。

成功: プロジェクト名、PHP バージョン、WordPress バージョンを名前として挙げるブロックが表示され、その後に以下が続きます。

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

ステップ 6 — 開く

ブラウザで http://127.0.0.1:9400 にアクセスします。成功: My WordPress Website というタイトルの新しい WordPress サイトが、指定した PHP バージョンで配信されます。http://127.0.0.1:9400/wp-admin を開くと、すでにログインした状態でダッシュボードが開きます。wp-content/plugins/ にプラグインを配置するか、wp-content/themes/ にテーマを配置すると、次回の再読み込み時にそこに反映されます。ランタイムはプロジェクトから直接それらのディレクトリを配信します。

停止するには Ctrl-C を押してください。zinnector dev --once はランタイムを起動し、実際に実行されているもの（PHP バージョン、WordPress バージョン、読み込まれた拡張機能）を表示して停止します。これは約束ではなく証拠が欲しい場合に便利です。

次に読むべきページ

zinnector dev によるローカル開発 — 2 つのランタイム、PHP および WordPress バージョンの選択、およびどこから何が配信されるかについて。
Zinnector® を使用したデプロイ — サインイン、プロジェクトをスロットへのリンク、プリフライト、プッシュ。
コマンドリファレンス — すべてのコマンド、フラグ、および例。
トラブルシューティング — ユーザーが実際に直面するエラーと、それぞれの修正方法。

同じドキュメントが、npm および GitHub 上のパッケージの README にも掲載されています。Issue やプルリクエストも歓迎します。