Kennisbank
Probleemoplossing voor Zinnector®
De fouten die mensen daadwerkelijk tegenkomen bij de Zinnector CLI en de oplossing voor elk ervan: spawn EINVAL op Windows, de EBADENGINE-waarschuwing van npm, node-gyp dat om Visual Studio vraagt op Node 26, EPERM tijdens installatie, een runtime die niet wil opstarten, en een poort in gebruik.
De fouten die mensen daadwerkelijk tegenkomen met de Zinnector® CLI, wat ze elk betekenen en de oplossingen. Elk item vermeldt de exacte tekst die u zult zien, zodat u deze pagina daarop kunt doorzoeken. Als de uwe er niet tussen staat, voer dan het mislukte commando uit met ZINNECTOR_DEBUG=1 en open een issue op github.com/Zinn-Digital/zinnector/issues met de uitvoer, uw node --version en uw besturingssysteem.
"spawn EINVAL" direct na het accepteren van de runtime-installatie (Windows)
Een bug in Zinnector® 0.1.0 en 0.1.1. Op Windows voerde het runtime-installatieprogramma npm.cmd uit bij naam, en Node weigert om een .cmd-bestand te starten zonder shell sinds de fix voor CVE-2024-27980 — waardoor de installatie crashte een seconde nadat u Y had beantwoord. Opgelost in 0.1.2: npm wordt nu uitgevoerd als node npm-cli.js, wat op elk platform hetzelfde is en geen shell nodig heeft. Voer npm install -g zinnector@latest uit en daarna opnieuw zinnector dev.
"npm WARN EBADENGINE" tijdens de installatie, of "Zinnector® needs Node 24 or newer"
Uw Node is ouder dan 24. npm drukt de waarschuwing af omdat het pakket engines: >=24.18.1 declareert; de installatie wordt alsnog voltooid, maar zinnector weigert vervolgens op te starten (afsluitcode 78) in plaats van ergens later op een verwarrende manier te falen. Installeer de huidige LTS van nodejs.org — winget install OpenJS.NodeJS.LTS op Windows, brew install node@24 op macOS — bevestig dat node --version v24 of hoger afdrukt en installeer Zinnector® opnieuw.
"gyp ERR!", "Building from source with node-gyp", or "You need to install Visual Studio"
De WordPress-runtime heeft een native module waarvan vooraf gecompileerde binaire bestanden alleen bestaan voor Node 24 en 25. Op een nieuwere Node (26 en hoger, vanaf september 2026) valt het installatieprogramma terug op compileren vanuit de broncode, wat op een standaard Windows-machine eindigt in een verzoek om Visual Studio. Opgelost in 0.1.2: Zinnector® detecteert dit voordat er iets wordt gedownload en haalt speciaal voor de runtime een Node 24 op — ongeveer 30 MB, geverifieerd tegen de controlesommen van nodejs.org — zodat er nooit iets wordt gecompileerd. Als u dit na de upgrade nog steeds ziet, voer dan zinnector dev --reset-runtime uit zodat de halfgeslagen installatie van hiervoor eerst wordt weggegooid.
"EPERM" waarschuwingen van npm tijdens het opruimen (Windows)
Vrijwel altijd een antivirusscanner of zoekindexeerder die een bestand openhoudt onder de node_modules van de runtime terwijl npm probeert dit te verwijderen. De installatie wordt opnieuw geprobeerd vanuit een schone map bij de volgende zinnector dev; als dit blijft gebeuren, verwijdert zinnector dev --reset-runtime eerst de hele runtime-map en installeert opnieuw.
"the local playground runtime could not be installed"
Het bericht bevat de laatste regels van npm zelf en het exacte commando dat Zinnector® heeft uitgevoerd, zodat u het zelf kunt uitvoeren en de volledige uitvoer kunt zien. De gebruikelijke oorzaken zijn een netwerk- of proxyprobleem — de runtime wordt opgehaald met uw eigen npm, dus npm config set proxy … en een registerspiegel zijn van toepassing — of een halfvoltooide eerdere installatie, die --reset-runtime wist.
"the local playground exited before it was ready", of het wordt nooit gereed
Voer zinnector dev --verbose uit om de eigen uitvoer van de runtime te bekijken. Een poort die al in gebruik is komt veel voor: zinnector dev --port 9401, of stel port in zinnector.json in. Een runtime die is geïnstalleerd maar niet wil opstarten: zinnector dev --reset-runtime. De eerste opstart downloadt ook WordPress zelf, dus geef het bij een trage verbinding een paar minuten; de CLI wacht maximaal vijf minuten voordat een time-out wordt gemeld in plaats van vast te lopen.
"this project is not a git repository" bij push
Implementaties worden aangestuurd vanuit een repository, dus zinnector push heeft er een nodig met een remote die het platform kan bereiken. git init && git add -A && git commit -m initial, voeg uw GitHub- of GitLab-remote toe en voer vervolgens zinnector link uit om deze aan de site te koppelen.
De site is wit na een implementatie
Voer zinnector check uit. Negen van de tien keer is het een PHP-versieverschil — u heeft gebouwd op een nieuwere PHP dan waarop de sleuf draait — en het rapport geeft aan naar welke versie u de sleuf moet overschakelen met zinnector php <version>, of tegen welke u moet ontwikkelen met zinnector dev --php <version>. zinnector logs --error toont de fatale fout zelf.
Verwant
Kom je er niet uit?
Ondersteuning is inbegrepen in elk abonnement en antwoorden in je eigen taal.
Contact opnemen met support → Alle artikelen →