開発者向け CLI である Zinnector®の利用を開始する

Zinnector®は、Zinn Digital®による WordPress 開発者向けの無料かつ MIT ライセンスのコマンドラインツールです。サイトの雛形を作成し、Node 以外何もインストールされていないご自身のマシン上で本物の WordPress を実行し (Docker 不要、MAMP 不要、PATH への PHP 設定も不要)、構築した内容をデプロイ先となるホスティングスロットと照合してプッシュします。このガイドでは、何もない状態から約2分でサイトを実行するまでの手順を説明し、何か問題が発生した際にすぐ把握できるよう、各ステップでの正常な状態を示します。

必要なもの

• Node 24以降。 node --versionを実行してください。v24以上が出力される必要があります。[nodejs.org] (https://nodejs.org/en/download)から現行のLTSをインストールしてください — Windows ではwinget install OpenJS.NodeJS.LTS、macOS ではbrew install node@24を実行します。
• npm (Node に付属)。Zinnector®は WordPress ランタイムを専用のキャッシュにダウンロードするために、これを1回使用します。
• git (zinnector pushでのみ使用) — デプロイはリポジトリを起点に行われます。
• Docker (--runtime dockerを指定した場合のみ使用)。デフォルトのランタイムでは一切不要です。

以下に記載された手順ではアカウントは不要です。API キーが必要になるのは、[Zinnector®によるデプロイ] (/kb/zinnector-deploying) でホスティングスロットにアクセスする段階のみです。

ステップ 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、ポートのフラグが一覧表示されます。用例を含んだ完全な一覧は、[コマンドリファレンス] (/kb/zinnector-command-reference) に記載されています。

ステップ 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 ランタイムをご自身のプロジェクト内ではなく専用のキャッシュディレクトリにダウンロードする前に確認を求めます (5.2から8.5までの各 PHP ビルドが含まれているため、約570 MB あります)。Yと答えるか、--yesを渡して確認をスキップしてください。Node 26以降では、ランタイムのネイティブモジュールに Node 24および25向けのビルド済みバイナリしか用意されていないため、ランタイム専用の Node 24 (約30 MB、nodejs.org のチェックサムで検証済み) もあわせて取得します。コンパイラや 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 によるローカル開発] (/kb/zinnector-local-development) — 2つのランタイム、PHP および WordPress バージョンの選択、配信元の構成について。
• [Zinnector®によるデプロイ] (/kb/zinnector-deploying) — サインイン、プロジェクトのスロットへの紐付け、事前検証、プッシュ。
• [コマンドリファレンス] (/kb/zinnector-command-reference) — すべてのコマンド、フラグ、用例。
• [トラブルシューティング] (/kb/zinnector-troubleshooting) — 実際に発生しやすいエラーとその解決策。

同様のドキュメントは、[npm] (https://www.npmjs.com/package/zinnector)およびGitHubのパッケージREADMEにも掲載されており、Issueやプルリクエストも受け付けています。