ਉਹ ਗਲਤੀਆਂ ਜਿਨ੍ਹਾਂ ਦਾ ਲੋਕ ਅਸਲ ਵਿੱਚ 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 ਚਲਾਇਆ ਸੀ, ਅਤੇ Node ਨੇ 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"
ਤੁਹਾਡਾ 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)
ਲਗਭਗ ਹਮੇਸ਼ਾ ਇੱਕ ਐਂਟੀਵਾਇਰਸ ਸਕੈਨਰ ਜਾਂ ਇੱਕ ਖੋਜ ਇੰਡੈਕਸਰ ਰਨਟਾਈਮ ਦੇ 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 ਖ਼ੁਦ ਫ਼ੈਟਲ ਐਰਰ ਦਿਖਾਉਂਦਾ ਹੈ।
ਸੰਬੰਧਿਤ