নলেজ বেস
Zinnector® ট্রাবলশুটিং
Zinnector CLI-তে মানুষ বাস্তবে যে ত্রুটিগুলোর মুখোমুখি হয় এবং প্রতিটির সমাধান: উইন্ডোজে spawn EINVAL, npm-এর EBADENGINE সতর্কতা, Node 26-এ ভিজ্যুয়াল স্টুডিওর জন্য node-gyp-এর অনুরোধ, ইনস্টলের সময় EPERM, বুট হবে না এমন একটি রানটাইম, এবং ব্যবহারে থাকা একটি পোর্ট।
Zinnector® CLI ব্যবহারের সময় মানুষ যেসব ত্রুটির মুখোমুখি হয়, প্রতিটির অর্থ এবং তার সমাধান। প্রতিটি এন্ট্রিতে ঠিক যে লেখাটি দেখতে পাবেন তা দেওয়া আছে, যাতে আপনি এই পৃষ্ঠায় তা অনুসন্ধান করতে পারেন। যদি আপনার ত্রুটিটি এখানে না থাকে, তবে ব্যর্থ হওয়া কমান্ডটি ZINNECTOR_DEBUG=1 সহ চালান এবং আউটপুট, আপনার node --version ও আপনার অপারেটিং সিস্টেম সহ github.com/Zinn-Digital/zinnector/issues-এ একটি ইস্যু খুলুন।
রানটাইম ইনস্টল গ্রহণ করার ঠিক পরেই "spawn EINVAL" (উইন্ডোজ)
Zinnector® 0.1.0 এবং 0.1.1-এর একটি বাগ। উইন্ডোজে রানটাইম ইনস্টলারটি নাম ধরে npm.cmd চালাত এবং CVE-2024-27980-এর সংশোধনীর পর থেকে নোড শেল ছাড়া কোনো .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"
আপনার নোডের সংস্করণ ২৪-এর চেয়ে পুরানো। npm এই সতর্কতাটি প্রিন্ট করে কারণ প্যাকেজটিতে engines: >=24.18.1 ঘোষণা করা হয়েছে; ইনস্টল প্রক্রিয়াটি শেষ হয়, তবে পরবর্তীতে বিভ্রান্তিকর কোনো স্থানে ব্যর্থ হওয়ার চেয়ে zinnector তখন শুরু হতে অস্বীকার করে (প্রস্থান কোড ৭৮)। nodejs.org/en/download-এ গিয়ে বর্তমান LTS ইনস্টল করুন—উইন্ডোজে 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-এর জন্য বিদ্যমান। একটি নতুন নোডে (২০২৬ সালের সেপ্টেম্বর পর্যন্ত ২৬ এবং তার পরবর্তী সংস্করণ) এর ইনস্টলার ফলব্যাক করে সোর্স থেকে কম্পাইল করতে শুরু করে, যা একটি সাধারণ উইন্ডোজ মেশিনে Visual Studio-এর জন্য অনুরোধ জানিয়ে শেষ হয়। 0.1.2 সংস্করণে সংশোধিত: কিছু ডাউনলোড করার আগেই Zinnector® এটি শনাক্ত করে এবং শুধুমাত্র রানটাইমের জন্য একটি Node 24 নিয়ে নেয়—প্রায় ৩০ মোবাইট, যা nodejs.org-এর চেকসামের সাথে যাচাইকৃত—ফলে কখনোই কিছু কম্পাইল করা হয় না। আপনি আপগ্রেড করার পরেও যদি এটি দেখতে পান, তবে zinnector dev --reset-runtime চালান যাতে আগের অসম্পূর্ণ ইনস্টলটি প্রথমে মুছে ফেলা হয়।
পরিষ্কার করার সময় npm থেকে "EPERM" সতর্কতা (উইন্ডোজ)
প্রায় সবসময়ই এটি একটি অ্যান্টিভাইরাস স্ক্যানার বা সার্চ ইনডেক্সার যা রানটাইমের node_modules-এর অধীনে একটি ফাইলকে ধরে রাখে যখন npm এটি সরাতে চেষ্টা করে। পরবর্তী 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 মারাত্মক ত্রুটিটি দেখায়।
সম্পর্কিত
এখনও আটকে আছেন?
প্রতিটি প্ল্যানেই সহায়তা অন্তর্ভুক্ত রয়েছে এবং আপনার নিজের ভাষাতেই উত্তর দেওয়া হয়।
সহায়তার জন্য যোগাযোগ করুন → সব নিবন্ধ →