Zinnector®

CLI-и таҳиягар барои мизбонии WordPress

Zinnector® WordPress-ро дар сатҳи маҳаллӣ бе ҳеҷ як барномаи дигар ба ғайр аз Node (бе Docker, бе MAMP) месозад, сипас он чизеро, ки шумо сохтаед, бо слоти хостинг, ки ба он ҷойгир карданӣ ҳастед, муқоиса мекунад ва пеш аз фиристодан ба шумо мегӯяд, ки чӣ чиз мутобиқат намекунад. Онро бо npm install -g zinnector насб кунед. Он ройгон аст, литсензияи MIT дорад ва дар асоси ҳамон API-и оммавӣ сохта шудааст, ки ҳама чизи дигари ин ҷо истифода мебарад.

Панҷ фармон, ва фармони миёна нуқта аст

Бештари CLI-ҳои мизбонӣ аз марҳилаи ҷойгиркунӣ оғоз мешаванд. Zinnector® пештар аз он оғоз мешавад — он сомонаро бо шумо месозад ва сипас кори шуморо бо мошине, ки мехоҳед онро ба он фиристед, муқоиса мекунад. Фосилаи байни «он дар ноутбуки ман кор кард» ва «он дар сервер кор мекунад» вақти зиёдеро мегирад ва ин фосила назаррас аст.

зиннектори нав

Соite, плагин ё блоки мавзӯеро созед, ки фавран кор медарояд. Ҳеҷ гуна файлҳои ҷойгир, ҳеҷ гуна TODO-ҳо вуҷуд надоранд — плагин фаъол мешавад ва мавзӯъро дар ҳамон лаҳзае, ки вуҷуд дорад, интихоб кардан мумкин аст.

zinnector dev

WordPress-и воқеӣ дар компютери шумо дар тӯли сонияҳо, ки плагинҳо ва мавзӯъҳои худро пешниҳод мекунад, бидуни Docker ва бидуни PHP дар PATH-и шумо. Барои таҳия ягон PHP-ро аз 5.2 то 8.5 интихоб кунед.

Санҷиши zinnector

Пеш аз парвоз. Он чизеро, ки сохтаед, бо слотӣ барои ҷойгиркунӣ муқоиса мекунад ва пеш аз фиристодан ҳар як номувофиқатӣ ва ҳар як санҷиши анҷомнопазирро номбар мекунад.

интиқоли zinnector

Пеш аз парвоз, папкаҳои худро фиристед, боркуниро оғоз кунед ва онро то ба охир расидан назорат кунед. Агар он ноком шавад, гузориши сохтмон бо як фармон дастрас аст.

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 ба ҷои ин рамзи баромад монеъа мешавад, то ки хатти корӣ сахтгир бошад ва шахс назоратро нигоҳ дорад.

Ду муҳити иҷрои маҳаллӣ, ҳарду воқеӣ

WordPress Playground пешфарз аст: PHP-и ба WebAssembly табдилшуда, ки дар дохили Node кор мекунад, аз ин рӯ ноутбуке, ки ба ҷуз Node чизи дигаре насб нашудааст, аз сифр то иҷрои WordPress-ро дар тақрибан ҳамон вақте, ки барои хондани ин ҷумла лозим аст, тай мекунад.

Вақте ки ба шумо PHP-и аслӣ — як васеъкунӣ ба монанди imagick, ё MySQL-и воқеӣ лозим аст, --runtime docker-ро истифода баред ва ба ҷои он контейнерҳои php-fpm ва MariaDB-ро гиред. Ҳарду ҳамон файлҳоро аз ҳамон лоиҳа пешниҳод мекунанд, бинобар ин гузариш байни онҳо танҳо муҳаррикро иваз мекунад ва дигар ҳеҷ чизро.

Ҳамаи дигар корҳоро шумо аллакай дар панел иҷро мекунед

Zinnector® дар ҳамон API-и умумии дороии панели идоракунӣ сохта шудааст, бинобар ин, ҳар коре, ки панел карда метавонад, он низ карда метавонад — ва ҳар як фармон на як нуқтаи ниҳоии хусусӣ, балки амалиёти ҳуҷҷатгузоришуда дар мушаххасоти OpenAPI мебошад.

Сойтҳо ва ҷойгиркуниҳо

Рӯйхати сайтҳоро гиред, ҳама гуна маълумотеро, ки платформа дар бораи он медонад, хонед, дубора ҷойгир кунед ва таърихи ҷойгиркурӣ ва гузоришҳои сохтмонро мутолиа кунед.

Доменҳо, DNS ва почта

Феҳристи доменҳо, хондан ва тағйир додани сабтҳои DNS бо сабти пеш аз навишташавӣ нишондодашуда ва хондани хидматҳои почтаи худ.

PHP, квота, пойгоҳи додаҳо ва гузоришҳо

Versiyaҳои PHP-ро иваз кунед, истифодаи диск ва inode-ро мувофиқи нақшаатон санҷед, истинодҳои яквақта ба phpMyAdmin-ро гиред ва журналҳои дастрасӣ ва хатогиҳоро пайгирӣ кунед.

WP-CLI ва амалиётҳои дастаҷамъӣ

Фмонҳои WP-CLI-и иҷозатдодашударо дар як сайт иҷро кунед ва кэшҳоро тоза кунед ё дар тамоми интихоб бо як даъват ба ҷои як сайр дар як вақт сканҳои зараррасонро оғоз кунед.

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-и воқеиро дар чанд сония бидуни насби ягон чизи дигар фаъол мекунад. Агар ба шумо PHP-и маҳаллӣ лозим бошад — то васеъкуние ба монанди imagick ё ionCube-ро санҷед — `--runtime docker` ба ҷои он контейнерҳои php-fpm ва MariaDB-ро пешниҳод мекунад. Ҳарду дастгирӣ мешаванд; ҳеҷ кадоме ивазкунандаи муваққатӣ нест.

Санҷиши пеш аз парвоз дар асл чиро муқоиса мекунад?

Versiyai маҳаллии PHP-и шумо дар муқобили версияи слот, инчунин оё слот умуман метавонад ба версияе, ки шумо сохтаед, гузарад, оё PHP-и слот ба охири мӯҳлати истифода расидааст ва оё мошин онро воқеан татбиқ кардааст, ҳаҷми лоиҳаи шумо ва шумораи файлҳо дар муқобили фазои боқимондаи диск ва inode, версияҳои WordPress дар ҳарду тараф, оё слот танзими худро ба охир расонидааст ва оё репозиторийи git барои ҷойгиркунӣ пайваст аст. Ҳар чизе, ки он санҷида наметавонад, ба ҷои ҳамчун муваффақ ҳисоб шудан, ҳамчун санҷиданашуда гузориш дода мешавад.

Оё он метавонад монеи ҷойгиркунии ман шавад?

Не, ва ин қасдан карда шудааст. Санҷиши пеш аз парвоз огоҳ мекунад ва ба шумо иҷоза медиҳад — `--force` сарфи назар аз ҳар гуна дарёфт густариш медиҳад. Шумо чизҳоеро дар бораи сайти худ медонед, ки санҷишгар намедонад ва абзоре, ки аз густариш саркашӣ мекунад, абзорест, ки корбарон онро нест мекунанд.

Оё калиди API-и ман бехатар аст?

Калид ҳеҷ гоҳ аз сатри фармон хонда намешавад — танҳо аз дархости вуруд ё орри шунавоии пайвастшуда (piped stdin) — бинобар ин он наметавонад дар таърихи shell-и шумо ё дар рӯйхати равандҳо ҷой гирад. Он дар директорияи танзимоти худи шумо бо ҳолати файли 600 нигоҳ дошта мешавад ва Zinnector® ҳар бор ҳангоми навиштан ин ҳуқуқҳои дастрасиро дубора тасдиқ мекунад.

Оё ман онро дар CI истифода бурда метавонам?

Бале. `ZINNECTOR_TOKEN`-ро танзим кунед ва ҳар як фармон `--json`-ро қабул мекунад. Натиҷаи одам ба stderr ва маълумот ба stdout меравад, то ки найчаҳо тоза монанд. `zinnector check` ҳангоми ёфтани чизе рақами ғайрисифрӣ мебарорад, бинобар ин он ҳамчун даромадгоҳи қувур кор мекунад ва `--strict` инчунин ҳангоми иҷро нашудани муқоиса ноком мешавад.

Онро насб кунед ва дар давоми як дақиқаи оянда сомонаеро иҷро кунед

Амри `npm install -g zinnector`-ро иҷро кунед, ё онро як бор тавассути `npx zinnector new my-site` санҷед. Бепул, бо литсензияи MIT ва дар асоси API-и кушода сохта шудааст. Лоиҳаро эҷод кунед, онро маҳаллӣ бидуни Docker оғоз диҳед ва пеш аз истиқрор (deploy) санҷиши пешакӣ гузаронед.

Ҳujjatҳоро хонед