Zinnector®

WordPress ホスティング向けデベロッパー CLI

Zinnector®は、Node以外のインストールが不要な環境(DockerやMAMPも不要)でWordPressをローカルに構築し、デプロイ予定のホスティングスロットとビルド結果を比較して不一致箇所をプッシュ前に通知します。「npm install -g zinnector」でインストールできます。完全無料でMITライセンスの下で提供されており、当社の他のすべての機能と同じ公開APIを基に構築されています。

5つのコマンド、その真ん中が要点です

ほとんどのホスティングCLIはデプロイから始まります。Zinnector®はそれよりも前から始まります。サイトをあなたと一緒に構築し、その後に送信先のサーバー環境と照らし合わせてコードを検証します。「自分のラップトップで動いた」と「サーバーで動く」の間のギャップに貴重な午後が奪われていき、そのギャップは計測可能です。

zinnector新規作成

すぐに起動するサイト、プラグイン、またはブロックテーマの基盤を作成します。プレースホルダーファイルやTODOはなく、プラグインは有効化され、作成した瞬間にテーマを選択できるようになります。

zinnector dev

DockerもPATH上のPHPも不要で、数秒でお手元のマシンに実際のWordPress環境を構築し、独自のプラグインやテーマを稼働させることができます。5.2から8.5までの任意のPHPバージョンを選択して開発を行えます。

zinnector チェック

プレフライト。構築した内容と、デプロイ予定のスロットを比較し、プッシュする前に、すべての不一致と、実行できなかったすべてのチェックを特定します。

zinnector プッシュ

デプロイ前にコミットをプッシュし、デプロイを開始して完了まで見届けましょう。失敗した場合も、ビルドログは1つのコマンドで確認できます。

zinnector ai

プロジェクトとサイトをコンテキストとして、ターミナルからアシスタントに質問します。プラットフォーム上であなたのアカウントに紐づいて実行されるため、モデルキーがあなたのマシンに保存されることは一切ありません。

Test it works in two minutes, no account needed

Six commands, in order, and what success looks like at each one. Everything here runs on your own machine; an API key is only needed when you reach a hosting slot.

  1. Install it

    Run npm install -g zinnector on Node 24 or newer. If npm prints EBADENGINE, your Node is older than 24 — install the current LTS from nodejs.org and run the install again.

  2. Check the version

    zinnector --version prints a version number such as 0.1.2. On a Node older than 24 it prints a message saying Node 24 or newer is needed, and exits.

  3. Read the help

    zinnector --help lists every command below with a one-line purpose. Every command also takes --help of its own.

  4. Scaffold a site

    zinnector new my-site creates a project that boots immediately — a zinnector.json, a wp-content tree and a README — and prints the next commands to run.

  5. Run it

    cd my-site, then zinnector dev. The first run asks once to download the WordPress runtime (about 570 MB, kept in the CLI’s own cache, never in your project). Success looks like “running at http://127.0.0.1:9400”.

  6. Open it in a browser

    http://127.0.0.1:9400 is a fresh WordPress site; /wp-admin opens the dashboard already signed in. Drop a plugin into wp-content/plugins and it is there on the next reload.

  7. Then, with a hosting slot

    zinnector login, zinnector link, zinnector check, zinnector push — pre-flight what you built against the slot, then deploy and watch it finish.

事前チェックの詳細

あなたはPHP 8.3で構築しましたが、スロット側は8.1で実行されています。サイトがホワイトアウトするまで、誰もそれに気づきません。それがこのコマンドが存在する理由であり、このプラットフォームのオーナーが名指しで求めた機能です。Zinnector®は両方の環境を読み込んで並べて表示し、何らかの理由がある場合に備えて、そのままデプロイできるようにします。

評価が明確なPHP

メジャーバージョンのギャップは確実にサイトに不具合を引き起こすため重大な警告としてフラグが立てられますが、マイナーギャップのフラグはそれより低くなります。すべてを重大として評価すると、人々が警告を無視するようになってしまいます。

ディスクとファイル数(個別)

WordPressのツリー構造は数万個の小さなファイルで構成されており、サイトはディスク容量の制限を大きく下回っている状態でも、inode(アイノード)の割当上限に達することがあります。どちらも、プランに対してではなく、スロットに実際に残っている空き容量に対して確認されます。

「確認できませんでした」がその答えです

検査対象が見えないチェックは未検査と報告され、合格することは決してありません。クリーンな実行は検証できなかった項目の数を伝えます。なぜなら、誤った「異常なし」こそ誰も二度見しないものだからです。

警告するが、ブロックはしない

すべての検出結果は `--force` で上書きでき、サマリーにもその旨が表示されます。CI環境では代わりに終了コードがゲートの役割を果たすため、パイプラインを厳格に保ちながら、人間がコントロールし続けることができます。

2つのローカルランタイム、どちらも本物

WordPress Playgroundがデフォルトです。Node上で実行されるWebAssemblyにコンパイルされたPHPにより、Node以外何もインストールされていないラップトップでも、この文を読むのにかかるほどの時間で、何もない状態から稼働するWordPress環境へと移行できます。

ネイティブのPHP(imagickなどの拡張機能)や実際のMySQLが必要な場合は、`--runtime docker`を指定して、代わりにphp-fpmとMariaDBのコンテナを取得してください。どちらも同じプロジェクトから同じファイルを処理するため、切り替えてもエンジンが変わるだけで、他には何も変わりません。

パネル内ですでに行っているその他の作業はすべてこちらで行えます

Zinnector®はダッシュボードと同じパブリックAPIを基盤としているため、コントロールパネルでできることはすべて実行できます。また、すべてのコマンドはプライベートなエンドポイントではなく、OpenAPI仕様書に文書化された操作となります。

サイトとデプロイ

サイトの一覧表示、プラットフォームが認識しているサイト情報の取得、再デプロイ、およびデプロイ履歴とビルドログの取得を行います。

ドメイン、DNS、メール

ドメインの一覧表示、書き込み前のレコード表示によるDNSレコードの読み取りと変更、およびメールサービスの読み取りを行います。

PHP、クォータ、データベース、ログ

PHP バージョンを切り替え、プランで許可されている容量に対するディスクおよび inode の使用量を確認し、phpMyAdmin への使い捨てリンクを取得し、アクセスログやエラーログをリアルタイムで監視します。

WP-CLI および一括操作

許可リストに登録されたWP-CLIコマンドをサイトに対して実行し、1サイトずつではなく、1回のリクエストで複数サイトを一括してキャッシュの削除やマルウェアスキャンを行います。

Every command, exactly as --help lists it

The full list, one line each. The complete reference — every flag, a runnable example and what each command prints — is generated from the CLI itself and lives in the developer docs and the knowledge base, so it cannot drift from the tool you have installed.

zinnector new

Scaffold a WordPress project you can run immediately.

zinnector dev

Run this project locally — no Docker required.

zinnector login

Sign in with a Zinn Digital® API key.

zinnector logout

Forget a stored API key.

zinnector whoami

Show who this CLI is authenticated as.

zinnector sites

List the sites this key can see.

zinnector status

Everything the platform knows about one site.

zinnector share

Give one person access to a single site — a developer, a designer, a client — with a role and a reason.

zinnector collaborators

See who has been given access to a site, their role, and whether they have accepted yet.

zinnector unshare

Take a person's access back, by email or grant id.

zinnector invitations

The invitations waiting for you, and accept one.

zinnector link

Point this project at a hosting slot (and connect its repository).

zinnector pull

Pull a hosted site's files into this project for local development, and re-run to re-sync. Takes the fast path when the site syncs to its own repository, otherwise works from the latest backup.

zinnector clone

Make a local project from a hosted site in one step: clone its repository or pull its files, write the project file, and leave you ready to run zinnector dev.

zinnector check

Compare this project against the slot you are about to deploy to.

zinnector push

Pre-flight, push your commits, and deploy.

zinnector deploy

Redeploy what the platform already has, without pushing.

zinnector deploys

A site's deploy history.

zinnector php

Show or switch a site's PHP version.

zinnector quota

Disk, files and database usage against what the plan grants.

zinnector db

Database size, and single-use links into phpMyAdmin and the file manager.

zinnector logs

Tail a site's access and error logs.

zinnector wp

Run an allow-listed WP-CLI command on a site.

zinnector backup

List and take site backups. Subcommands: list, now.

zinnector domains

List the domains this key can see.

zinnector dns

Read and change DNS records. Subcommands: list, add, rm.

zinnector mail

List mail services.

zinnector bulk

Run one operation across many sites (cache_purge, malware_scan, sitemap, block_ip).

zinnector ai

Ask the Zinn Digital® assistant, with this project as context.

質問

Zinn Digital®を利用するのに、お客様である必要がありますか?

いいえ。`zinnector new` と `zinnector dev` はアカウントがまったく不要です。プラグイン、テーマ、またはサイト全体を構築してローカルで無料で永久に実行できます。APIキーは、ホスティングと通信するコマンドにのみ必要です。

Dockerが必要ですか?

デフォルトのランタイム用ではありません。WordPress PlaygroundはPHPをWebAssemblyにコンパイルしてNode内で実行するため、`zinnector dev`は何もインストールしなくても数秒で本物のWordPressを起動します。imagickやionCubeなどの拡張機能をテストするためにネイティブのPHPが必要な場合は、`--runtime docker`を使用すると、代わりにphp-fpmとMariaDBのコンテナが提供されます。どちらもサポートされており、どちらか一方がフォールバックになるわけではありません。

プレフライトチェックは実際には何を比較していますか?

お使いのローカルのPHPバージョンとスロットのバージョンとの比較、スロットが構築したバージョンに切り替え可能かどうか、スロットのPHPがすでにサポート終了(EOL)を迎えているかどうか、マシンに実際にそれが適用されているかどうか、プロジェクトのサイズおよびファイル数と残りのディスクおよびinodeの空き容量との比較、双方のWordPressのバージョン、スロットのプロビジョニングが完了しているかどうか、およびデプロイ元のGitリポジトリが接続されているかどうか。確認できなかった項目は合格ではなく、未確認として報告されます。

デプロイを阻止できますか?

いいえ、それは意図的なものです。Pre-flightは警告を出した上で通過させます。「`--force`」を使用すれば、検出結果に関わらずデプロイを実行できます。チェッカーには分からないご自身のサイトの事情もあるはずであり、デプロイを拒否するようなツールはユーザーにアンインストールされてしまうからです。

APIキーは安全ですか?

キーはコマンドラインから読み取られることはなく、プロンプトまたはパイプされた標準入力からのみ読み取られるため、シェル履歴やプロセス一覧に残ることはありません。キーはファイルモード600でご自身のconfigディレクトリに保存され、Zinnector®は書き込みを行うたびにそれらの権限を再適用します。

CI環境でも使用できますか?

はい。`ZINNECTOR_TOKEN` を設定すると、すべてのコマンドで `--json` が使用可能になります。人間の読み取る出力は stderr に、データは stdout に出力されるため、パイプラインをクリーンに保つことができます。`zinnector check` は問題を発見した際に応答コード 0 以外で終了するためパイプラインのゲートとして機能し、さらに `--strict` を指定すると比較が行えなかった場合にも失敗します。

インストールして次の1分以内にサイトを実行する

npm install -g zinnectorを実行するか、npx zinnector new my-siteで一度お試しください。無料でMITライセンスの下、パブリックAPIを基に構築されています。プロジェクトを構築し、Dockerなしでローカル実行し、デプロイ前にプレフライトチェックを行えます。

ドキュメントを読む