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

ابزار Zinnector® ابزار خط فرمان رایگان و دارای مجوز MIT متعلق به Zinn Digital® برای توسعه‌دهندگان WordPress است. این ابزار ساختار اولیه یک سایت را ایجاد می‌کند، یک WordPress واقعی را روی دستگاه خودتان بدون نیاز به نصب هیچ چیز دیگری جز 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® یک بار از آن استفاده می‌کند تا محیط زمان اجرای WordPress را در حافظه پنهان خود دانلود کند.
• git، فقط برای zinnector push — فرایندهای استقرار از طریق مخزن شما هدایت می‌شوند.
• Docker، فقط در صورتی که آن را با --runtime docker درخواست کنید. زمان اجرای پیش‌فرض به آن نیازی ندارد.

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

مرحله ۱ — نصب آن

npm install -g zinnector

اگر npm عبارت npm WARN EBADENGINE را چاپ کرد، نسخه Node شما قدیمی‌تر از >=24.18.1 اعلام‌شده توسط بسته است. نصب در هر صورت کامل می‌شود، اما CLI از اجرا خودداری خواهد کرد. ابتدا 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 پرچم‌های مربوط به runtime، 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® قبل از دانلود محیط زمان اجرای WordPress — حدود ۵۷۰ مگابایت، زیرا شامل تمام ساخت‌های PHP از 5.2 تا 8.5 است — در دایرکتوری حافظه پنهان خود و هرگز در پروژه شما، یک بار از شما سؤال می‌پرسد. با Y پاسخ دهید، یا --yes را ارسال کنید تا از سؤال صرف‌نظر شود. در Node نسخه ۲۶ یا جدیدتر، این ابزار همچنین یک Node 24 را صرفاً برای زمان اجرا دریافت می‌کند (حدود ۳۰ مگابایت، تایید شده در برابر چکسام‌های nodejs.org)، زیرا ماژول بومی زمان اجرا فقط برای Node نسخه‌های ۲۴ و ۲۵ باینری‌های از پیش ساخته‌شده دارد؛ شما نیازی به کامپایلر یا Visual Studio ندارید.

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

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

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

گام‌های بعدی

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

همین مستندات در README بسته روی npm و روی GitHub نیز موجود است، جایی که از ایشوها و پول ریکوئست‌ها استقبال می‌شود.