شروع کار با Zinnector®، ابزار خط فرمان توسعه‌دهنده

ابزار خط فرمان رایگان و تحت مجوز MIT شرکت Zinn Digital® برای توسعه‌دهندگان WordPress است که Zinnector® نام دارد. این ابزار یک سایت را دارابست‌بندی می‌کند، یک وردپرس واقعی را روی سیستم شخصی شما تنها با نصب بودن Node اجرا می‌کند — بدون Docker، بدون MAMP، بدون PHP در متغیرهای محیطی (PATH) شما — سپس آنچه را که ساخته‌اید با اسلات میزبانی که قصد استقرار روی آن را دارید بررسی کرده و ارسال می‌کند. این راهنما شما را از صفر به یک سایت در حال اجرا در حدود دو دقیقه می‌رساند و در هر مرحله نشان می‌دهد که موفقیت چه شکلی است تا بدانید چه زمانی مشکلی رخ داده است.

آنچه نیاز دارید

• Node نسخه ۲۴ یا جدیدتر. دستور node --version را اجرا کنید؛ این دستور باید v24 یا بالاتر را نمایش دهد. نسخه LTS فعلی را از nodejs.org نصب کنید — در ویندوز winget install OpenJS.NodeJS.LTS، و در macOS brew install node@24.
• npm که به همراه Node نصب می‌شود. Zinnector® یک بار از آن برای دانلود موتور اجرایی وردپرس در حافظه پنهان خود استفاده می‌کند.
• git، فقط برای دستور zinnector push — استقرارها از طریق مخزن شما هدایت می‌شوند.
• Docker، فقط در صورتی که آن را با پارامتر --runtime docker درخواست کنید. موتور پیش‌فرض به آن نیازی ندارد.

هیچ‌یک از موارد زیر نیازی به حساب کاربری ندارند. کلید API تنها زمانی مورد نیاز است که به یک اسلات میزبانی برسید، که در بخش استقرار با Zinnector® توضیح داده شده است.

گام ۱ — نصب ابزار

npm install -g zinnector

اگر npm پیام npm WARN EBADENGINE را نمایش داد، نسخه Node شما قدیمی‌تر از نسخه >=24.18.1 است که بسته اعلام کرده است. نصب در هر صورت به پایان می‌رسد، اما ابزار خط فرمان از اجرا سر باز خواهد زد. ابتدا Node را ارتقا دهید و سپس دوباره نصب کنید.

گام ۲ — بررسی نسخه

zinnector --version

موفقیت: نمایش شماره نسخه، برای مثال 0.1.2. اگر پیام "Zinnector® needs Node 24 or newer — this is Node 20.x" را مشاهده کردید، یعنی فایل اجرایی نصب شده اما نسخه Node شما خیلی قدیمی است؛ دستور به جای انجام هر کاری با کد ۷۸ خارج می‌شود.

گام ۳ — مطالعه راهنما

zinnector --help

موفقیت: نمایشی از پنج دستور جریان کار (new، dev، link، check، push) و سپس هر دستور به همراه هدف یک‌خطی آن. هر دستور همچنین پارامتر --help مخصوص به خود را دارد — دستور zinnector dev --help پرچم‌های موتور اجرایی، PHP و پورت را فهرست می‌کند. فهرست کامل به همراه مثال‌ها در مرجع دستورات موجود است.

گام ۴ — دارابست‌بندی یک سایت

zinnector new my-site

موفقیت: یک سر تیتر Created my-site و فهرستی از فایل‌هایی که ایجاد کرده است — zinnector.json، ساختار پوشه wp-content شامل plugins/، themes/ و یک کمکی mu-plugins/، یک فایل .gitignore و یک فایل README — به دنبال دستورات بعدی که باید اجرا شوند. هیچ‌چقدر در این بخش به عنوان نگهدارنده جا نیست؛ پروژه همان‌طور که هست راه‌اندازی می‌شود. استفاده از --template plugin یا --template theme یک افزونه یا قالب بلوکی را دارابست‌بندی می‌کند که به محض ایجاد شدن فعال می‌شود.

گام ۵ — اجرای سایت

cd my-site
zinnector dev

در بار اول، Zinnector® یک بار پیش از دانلود موتور اجرایی وردپرس (حجم آن حدود ۵۷۰ مگابایت است زیرا شامل تمام نسخه‌های PHP از ۵.۲ تا ۸.۵ می‌شود) در پوشه حافظه پنهان خود و نه در پروژه شما، سوالی می‌پرسد. پاسخ Y را وارد کنید یا برای رد کردن سوال، پارامتر --yes را ارسال کنید. در نسخه Node 26 یا جدیدتر، این ابزار همچنین یک Node 24 را صرفاً برای موتور اجرایی دانلود می‌کند (حدود ۳۰ مگابایت، که با مجموعه‌کنترل‌های (checksums) سایت nodejs.org مطابقت داده شده است)، زیرا ماژول بومی موتور اجرایی دارای فایل‌های باینری از پیش ساخته شده فقط برای نسخه‌های 24 و 25 است؛ بنابراین شما نیازی به کامپایلر یا Visual Studio ندارید.

موفقیت: بلوکی که نام پروژه، نسخه PHP و نسخه وردپرس را نمایش می‌دهد، به همراه:

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

گام ۶ — باز کردن سایت

آدرس http://127.0.0.1:9400 را در مرورگر باز کنید. موفقیت: یک سایت تازه وردپرس با عنوان My WordPress Website که توسط نسخه PHP درخواستی شما سرویس‌دهی می‌شود. آدرس http://127.0.0.1:9400/wp-admin داشبورد را در حالی که از قبل وارد شده‌اید باز می‌کند. یک افزونه را در wp-content/plugins/ یا یک قالب را در wp-content/themes/ قرار دهید و در بارگذاری مجدد بعدی آن را خواهید دید — موتور اجرایی این پوشه‌ها را مستقیماً از پروژه شما سرویس‌دهی می‌کند.

برای توقف، کلیدهای Ctrl-C را فشار دهید. دستور zinnector dev --once موتور اجرایی را راه‌اندازی می‌کند، مواردی که در حال حاضر در حال اجرا هستند (نسخه PHP، نسخه وردپرس، افزونه‌های بارگذاری شده) را چاپ کرده و متوقف می‌شود — این کار زمانی مفید است که به جای یک وعده، به مدرک نیاز دارید.

گام‌های بعدی

• توسعه محلی با zinnector dev — دو موتور اجرایی، انتخاب نسخه‌های PHP و وردپرس، و اینکه چه چیزی از کجا سرویس‌دهی می‌شود.
• استقرار با Zinnector® — ورود به سیستم، پیوند دادن پروژه به یک اسلات، بررسی پیش از پرواز (pre-flight) و ارسال.
• مرجع دستورات — هر دستور، پرچم و مثال.
• عیب‌یابی — خطاهایی که کاربران عموماً با آن‌ها مواجه می‌شوند و راه‌حل هر کدام.

مستندات مشابه در فایل README بسته در npm و در GitHub موجود است، جایی که از مسائل (issues) و درخواست‌های کش (pull requests) استقبال می‌شود.