Zinnector® সমস্যা সমাধান

যে ত্রুটিগুলোর সম্মুখীন মানুষ সাধারণত Zinnector® CLI-এর ক্ষেত্রে হন, সেগুলোর প্রতিটির অর্থ কী এবং এর সমাধান। প্রতিটি এন্ট্রিতে আপনি ঠিক যে লেখাটি দেখতে পাবেন তা উল্লেখ করা হয়েছে, যাতে আপনি এই পৃষ্ঠায় তা অনুসন্ধান করতে পারেন। আপনার ত্রুটিটি এখানে না থাকলে, ZINNECTOR_DEBUG=1 সহ ব্যর্থ কমান্ডটি চালান এবং আউটপুট, আপনার node --version ও অপারেটিং সিস্টেম সহ github.com/Zinn-Digital/zinnector/issues-এ একটি ইস্যু খুলুন।

রানটাইম ইনস্টল গ্রহণ করার ঠিক পরেই "spawn EINVAL" (Windows)

Zinnector® 0.1.0 এবং 0.1.1-এর একটি বাগ। Windows-এ রানটাইম ইনস্টলারটি নাম ধরে npm.cmd চালাত, এবং CVE-2024-27980-এর সমাধানের পর থেকে Node কোনো শেল ছাড়া একটি .cmd ফাইল স্পন করতে অস্বীকার করছে — তাই আপনি Y উত্তর দেওয়ার এক সেকেন্ড পরেই ইনস্টলেশনটি ক্র্যাশ করে। 0.1.2 সংস্করণে সমাধান করা হয়েছে: npm এখন node npm-cli.js হিসেবে চলে, যা প্রতিটি প্ল্যাটফর্মে একই এবং এর জন্য কোনো শেলের প্রয়োজন হয় না। npm install -g zinnector@latest চালান, তারপর আবার zinnector dev চালান।

ইনস্টলেশনের সময় "npm WARN EBADENGINE", অথবা "Zinnector® needs Node 24 or newer"

আপনার Node-এর সংস্করণ 24-এর চেয়ে পুরনো। npm এই সতর্কতাটি দেখায় কারণ প্যাকেজটি engines: >=24.18.1 ঘোষণা করে; ইনস্টলেশনটি তা সত্ত্বেও সম্পূর্ণ হয়, কিন্তু পরবর্তীতে বিভ্রান্তিকর কোনো জায়গায় ব্যর্থ হওয়ার চেয়ে zinnector তখন শুরু হতে অস্বীকৃতি জানায় (এক্সিট কোড 78)। nodejs.org থেকে বর্তমান LTS সংস্করণটি ইনস্টল করুন — Windows-এ winget install OpenJS.NodeJS.LTS, macOS-এ brew install node@24 — node --version কমান্ডটি v24 বা তার বেশি দেখাচ্ছে কিনা তা নিশ্চিত করুন, এবং Zinnector® আবার ইনস্টল করুন।

"gyp ERR!", "Building from source with node-gyp", অথবা "You need to install Visual Studio"

WordPress রানটাইমে একটি নেটিভ মডিউল রয়েছে যার প্রি-বিল্ট বাইনারিগুলো শুধুমাত্র Node 24 এবং 25-এর জন্য বিদ্যমান। একটি নতুন Node-এ (সেপ্টেম্বর 2026 অনুযায়ী 26 এবং তার উপরে) এর ইনস্টলারটি সোর্স থেকে কম্পাইল করার চেষ্টা করে, যা একটি সাধারণ Windows মেশিনে Visual Studio ইনস্টল করার অনুরোধের মাধ্যমে শেষ হয়। 0.1.2 সংস্করণে সমাধান করা হয়েছে: Zinnector® কোনো কিছু ডাউনলোড করার আগেই এটি শনাক্ত করে এবং শুধুমাত্র রানটাইমের জন্য একটি Node 24 সংগ্রহ করে — প্রায় 30 MB, যা nodejs.org-এর চেকসামের সাথে যাচাই করা হয় — তাই কোনো কিছুই কখনো কম্পাইল করতে হয় না। আপগ্রেড করার পরেও যদি আপনি এটি দেখতে পান, তবে zinnector dev --reset-runtime চালান যাতে আগের অর্ধেক শেষ হওয়া ইনস্টলেশনটি প্রথমে বাতিল করা হয়।

ফাইল পরিষ্কার করার সময় npm থেকে "EPERM" সতর্কতা (Windows)

npm যখন রানটাইমের node_modules-এর অধীনে থাকা ফাইল মুছে ফেলার চেষ্টা করে, তখন প্রায় সবসময়ই একটি অ্যান্টিভাইরাস স্ক্যানার বা একটি সার্চ ইনডেক্সার ফাইলটি খোলা রাখার কারণে এটি ঘটে। পরবর্তী zinnector dev-এ একটি সম্পূর্ণ খালি ডিরেক্টরি থেকে পুনরায় ইনস্টলেশন চেষ্টা করা হয়; যদি এটি বারবার ঘটতে থাকে, তবে zinnector dev --reset-runtime প্রথমে পুরো রানটাইম ডিরেক্টরিটি সরিয়ে দেয় এবং পুনরায় ইনস্টল করে।

"the local playground runtime could not be installed"

এই বার্তায় npm-এর নিজস্ব শেষ লাইনগুলো এবং Zinnector® যে কমান্ডটি চালিয়েছিল তা অন্তর্ভুক্ত থাকে, যাতে আপনি এটি নিজে চালাতে পারেন এবং সম্পূর্ণ আউটপুট দেখতে পারেন। সাধারণত নেটওয়ার্ক বা প্রক্সি সমস্যার কারণে এটি হয় — রানটাইমটি আপনার নিজস্ব npm দিয়ে সংগ্রহ করা হয়, তাই npm config set proxy … এবং একটি রেজিস্ট্রি মিরর প্রযোজ্য হয় — অথবা পূর্বে অসম্পূর্ণ থাকা কোনো ইনস্টলেশন, যা --reset-runtime পরিষ্কার করে।

"the local playground exited before it was ready", অথবা এটি কখনোই প্রস্তুত হচ্ছে না

রানটাইমের নিজস্ব আউটপুট দেখতে zinnector dev --verbose চালান। একটি পোর্ট আগে থেকেই ব্যবহৃত হওয়া একটি সাধারণ কারণ: zinnector dev --port 9401 চালান, অথবা zinnector.json-এ port সেট করুন। একটি রানটাইম যা ইনস্টল হয়েছে কিন্তু বুট হবে না: zinnector dev --reset-runtime। প্রথমবার বুট হওয়ার সময় এটি WordPress নিজেও ডাউনলোড করে, তাই ধীরগতির সংযোগে এটিকে কয়েক মিনিট সময় দিন; হ্যাং হয়ে থাকার পরিবর্তে টাইমআউট রিপোর্ট করার আগে CLI পাঁচ মিনিট পর্যন্ত অপেক্ষা করে।

পুশ করার সময় "this project is not a git repository"

ডিপ্লয়মেন্ট একটি রিপোজিটরি থেকে পরিচালিত হয়, তাই zinnector push-এর জন্য এমন একটি রিমোট সহ রিপোজিটরি প্রয়োজন যেখানে প্ল্যাটফর্মটি পৌঁছাতে পারে। git init && git add -A && git commit -m initial চালান, আপনার GitHub বা GitLab রিমোট যোগ করুন, তারপর সাইটের সাথে এটিকে যুক্ত করতে zinnector link চালান।

ডিপ্লয় করার পর সাইটটি ফাঁকা দেখাচ্ছে

zinnector check চালান। দশবারের মধ্যে নয়বারই এটি PHP সংস্করণের পার্থক্যের কারণে হয় — আপনি স্লটটি যে সংস্করণে চলে তার চেয়ে নতুন PHP সংস্করণে তৈরি করেছেন — এবং স্লটটিকে কোন সংস্করণে পরিবর্তন করতে হবে তা zinnector php <version> দিয়ে বা কোন সংস্করণে ডেভেলপ করতে হবে তা zinnector dev --php <version> দিয়ে রিপোর্টে উল্লেখ করা থাকে। zinnector logs --error মূল মারাত্মক ত্রুটিটি প্রদর্শন করে।

সম্পর্কিত

• Getting started · Local development · Deploying · Command reference