Zinnector® ডেভেলপার সিএলআই (CLI) দিয়ে শুরু করা

Zinnector® হলো WordPress ডেভেলপারদের জন্য Zinn Digital®-এর একটি বিনামূল্যে, MIT-লাইসেন্সপ্রাপ্ত কমান্ড-লাইন টুল। এটি একটি সাইট স্ফ্যাফোল্ড করে, Node ছাড়া আর কিছুই ইনস্টল করা নেই এমন আপনার নিজস্ব মেশিনে একটি আসল WordPress চালায়—কোনো Docker নেই, কোনো MAMP নেই, আপনার PATH-এ কোনো PHP নেই—এরপর আপনি যে হোস্টিং স্লটে ডিপ্লয় করতে চলেছেন তার বিপরীতে আপনি যা তৈরি করেছেন তা পরীক্ষা করে এবং তা পুশ করে। এই নির্দেশিকাটি আপনাকে প্রায় দুই মিনিটের মধ্যে শূন্য থেকে একটি চলমান সাইটে নিয়ে যায়, এবং প্রতিটি ধাপে সফলতার রূপ কেমন তা জানিয়ে দেয় যাতে কখন কোনো সমস্যা হয়েছে তা আপনি বুঝতে পারেন।

আপনার যা প্রয়োজন

• Node 24 বা নতুন সংস্করণ। node --version রান করুন; এটি অবশ্যই v24 বা উচ্চতর সংস্করণ প্রিন্ট করবে। nodejs.org থেকে বর্তমান LTS ইনস্টল করুন—Windows-এর জন্য winget install OpenJS.NodeJS.LTS, macOS-এর জন্য brew install node@24।
• npm, যা Node-এর সাথেই আসে। Zinnector® এর নিজস্ব ক্যাশে WordPress রানটাইম ডাউনলোড করার জন্য এটি একবার ব্যবহার করে।
• git, শুধুমাত্র zinnector push-এর জন্য—ডিপ্লয়গুলো আপনার রিপোজিটরি থেকে চালিত হয়।
• Docker, শুধুমাত্র আপনি যদি --runtime docker দিয়ে এটি চান। ডিফল্ট রানটাইমের কোনোটিরই প্রয়োজন হয় না।

নিচের কোনোটির জন্যই অ্যাকাউন্টের প্রয়োজন নেই। Zinnector® দিয়ে ডিপ্লয় করা-এ, আপনি যখন একটি হোস্টিং স্লটে পৌঁছাবেন শুধুমাত্র তখনই একটি API কী প্রয়োজন হবে।

ধাপ ১ — এটি ইনস্টল করুন

npm install -g zinnector

যদি npm npm WARN EBADENGINE প্রিন্ট করে, তবে আপনার Node প্যাকেজটিতে ঘোষিত >=24.18.1-এর চেয়ে পুরোনো। ইনস্টলেশন তবুও শেষ হয়, কিন্তু CLI রান হতে অস্বীকার করবে। প্রথমে Node আপগ্রেড করুন, তারপর আবার ইনস্টল করুন।

ধাপ ২ — সংস্করণ পরীক্ষা করুন

zinnector --version

সফলতা: একটি সংস্করণের নম্বর, উদাহরণস্বরূপ 0.1.2। আপনি যদি "Zinnector®-এর Node 24 বা নতুন সংস্করণ প্রয়োজন — এটি Node 20.x" দেখতে পান তবে বাইনারিটি ইনস্টল হয়েছে কিন্তু আপনার Node অত্যন্ত পুরোনো; কমান্ডটি কোনো কাজ না করে কোড 78 সহ প্রস্থান করে।

ধাপ ৩ — সহায়তা পড়ুন

zinnector --help

সফলতা: একটি ব্যানার যা ফ্লো-এর পাঁচটি কমান্ড (new, dev, link, check, push) এর নাম দেয় এবং তারপরে এক-লাইনের উদ্দেশ্যসহ প্রতিটি কমান্ডের নাম দেয়। প্রতিটি কমান্ড নিজস্ব --help ও গ্রহণ করে—zinnector dev --help রানটাইম, PHP এবং পোর্ট ফ্ল্যাগগুলো তালিকাভুক্ত করে। উদাহরণের সাথে সম্পূর্ণ তালিকাটি কমান্ড রেফারেন্স-এ রয়েছে।

ধাপ ৪ — একটি সাইট স্ফ্যাফোল্ড করুন

zinnector new my-site

সফলতা: একটি Created my-site শিরোনাম এবং এটি যে ফাইলগুলো লিখেছে তার একটি তালিকা—zinnector.json, plugins/, themes/ এবং একটি mu-plugins/ সহায়ক সহ একটি wp-content ট্রি, একটি .gitignore এবং একটি README—এরপর রান করার পরবর্তী কমান্ডগুলো। এর মধ্যে কোনোটিই প্লেসহোল্ডার নয়; প্রজেক্টটি যেমন আছে তেমনই বুট হয়। --template plugin অথবা --template theme কোনো প্লাগইন বা ব্লক থিম স্ফ্যাফোল্ড করে যা অস্তিত্বে আসার সাথেই সক্রিয় হয়।

ধাপ ৫ — এটি রান করুন

cd my-site
zinnector dev

প্রথমবারে, Zinnector® তার নিজস্ব ক্যাশে ডিরেক্টরিতে WordPress রানটাইম—প্রায় 570 MB, কারণ এতে 5.2 থেকে 8.5 পর্যন্ত প্রতিটি PHP বিল্ড রয়েছে—ডাউনলোড করার আগে একবার জিজ্ঞেস করে, এটি কখনোই আপনার প্রজেক্টে ডাউনলোড হয় না। Y উত্তর দিন, অথবা প্রশ্নটি এড়িয়ে যেতে --yes পাস করুন। Node 26 বা নতুন সংস্করণে এটি শুধুমাত্র রানটাইমের জন্য একটি Node 24 ও ফেচ করে (প্রায় 30 MB, nodejs.org-এর চেকসামের বিপরীতে যাচাইকৃত), কারণ রানটাইমের নেটিভ মডিউলে শুধুমাত্র Node 24 এবং 25-এর জন্য প্রিবিল্ট বাইনারি রয়েছে; আপনার কোনো কম্পাইলার বা 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 ভিজিট করুন। সফলতা: 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-এর সাথে স্থানীয় ডেভেলপমেন্ট — দুটি রানটাইম, PHP এবং WordPress সংস্করণ নির্বাচন করা, এবং কোথা থেকে কী পরিবেশন করা হয়।
• Zinnector® দিয়ে ডিপ্লয় করা — সাইন ইন করুন, প্রজেক্টটিকে একটি স্লটের সাথে লিঙ্ক করুন, প্রি-ফ্লাইট করুন, পুশ করুন।
• কমান্ড রেফারেন্স — প্রতিটি কমান্ড, ফ্ল্যাগ এবং উদাহরণ।
• সমস্যা সমাধান — যে ত্রুটিগুলোর মুখোমুখি মানুষ আসলেই হয়, এবং প্রতিটির সমাধান।

একই ডকুমেন্টেশন রয়েছে npm-এ এবং GitHub-এ প্যাকেজের README-তে, যেখানে সমস্যা এবং পুল রিকোয়েস্টগুলো স্বাগত।