Αντιμετώπιση προβλημάτων του Zinnector®

Τα σφάλματα που αντιμετωπίζουν συνήθως οι χρήστες με το Zinnector® CLI, τι σημαίνει το καθένα και η αντίστοιχη διόρθωση. Κάθε καταχώριση αναφέρει το ακριβές κείμενο που θα δείτε, ώστε να μπορείτε να το αναζητήσετε σε αυτή τη σελίδα. Εάν το δικό σας δεν βρίσκεται εδώ, εκτελέστε την εντολή που αποτυγχάνει με ZINNECTOR_DEBUG=1 και ανοίξτε ένα ζήτημα (issue) στο github.com/Zinn-Digital/zinnector/issues με το αποτέλεσμα, το node --version σας και το λειτουργικό σας σύστημα.

«spawn EINVAL» αμέσως μετά την αποδοχή της εγκατάστασης του περιβάλλοντος εκτέλεσης (Windows)

Ένα σφάλμα (bug) στο Zinnector® 0.1.0 και 0.1.1. Στα Windows, το πρόγραμμα εγκατάστασης του περιβάλλοντος εκτέλεσης εκτελούσε το npm.cmd ονομαστικά, και το Node αρνείται να εκτελέσει αρχείο .cmd χωρίς κέλυφος (shell) από τη διόρθωσή του για το CVE-2024-27980 — με αποτέλεσμα η εγκατάσταση να καταρρέει ένα δευτερόλεπτο αφού απαντούσατε Y. Διορθώθηκε στην έκδοση 0.1.2: το npm εκτελείται πλέον ως node npm-cli.js, το οποίο είναι ίδιο σε κάθε πλατφόρμα και δεν απαιτεί κέλυφος. Εκτελέστε npm install -g zinnector@latest, και στη συνέχεια ξανά zinnector dev.

«npm WARN EBADENGINE» κατά την εγκατάσταση, ή «Το Zinnector® χρειάζεται Node 24 ή νεότερο»

Η έκδοση του Node σας είναι παλαιότερη από την 24. Το npm εμφανίζει την προειδοποίηση επειδή το πακέτο δηλώνει engines: >=24.18.1· η εγκατάσταση ολοκληρώνεται ούτως ή άλλως, αλλά το zinnector στη συνέχεια αρνείται να ξεκινήσει (κωδικός εξόδου 78) αντί να αποτύχει αργότερα με ασαφή τρόπο. Εγκαταστήστε την τρέχουσα έκδοση LTS από το nodejs.org — winget install OpenJS.NodeJS.LTS στα Windows, brew install node@24 στο macOS — επιβεβαιώστε ότι το node --version επιστρέφει v24 ή νεότερο, και εγκαταστήστε ξανά το Zinnector®.

«gyp ERR!», «Building from source with node-gyp», ή «You need to install Visual Studio»

Το περιβάλλον εκτέλεσης WordPress διαθέτει ένα εγγενές πρόσθετο (native module) του οποίου τα προκατασκευασμένα εκτελέσιμα αρχεία (binaries) υπάρχουν μόνο για το Node 24 και 25. Σε νεότερο Node (26 και άνω, από τον Σεπτέμβριο του 2026), το πρόγραμμα εγκατάστασής του καταφεύγει στη μεταγλώττιση από τον πηγαίο κώδικα, η οποία σε ένα απλό μηχάνημα Windows καταλήγει σε αίτημα για το Visual Studio. Διορθώθηκε στην έκδοση 0.1.2: Το Zinnector® το εντοπίζει αυτό πριν από τη λήψη οποιουδήποτε αρχείου και πραγματοποιεί λήψη ενός Node 24 αποκλειστικά για το περιβάλλον εκτέλεσης — περίπου 30 MB, επαληθευμένο βάσει των αθροισμάτων ελέγχου (checksums) του nodejs.org — επομένως δεν μεταγλωττίζεται ποτέ τίποτα. Εάν εξακολουθείτε να το βλέπετε μετά την αναβάθμιση, εκτελέστε zinnector dev --reset-runtime ώστε να απορριφθεί πρώτα η ημιτελής προηγούμενη εγκατάσταση.

Προειδοποιήσεις «EPERM» από το npm κατά τον καθαρισμό (Windows)

Σχεδόν πάντα οφείλεται σε πρόγραμμα προστασίας από ιούς ή σε λειτουργία ευρετηρίασης αναζήτησης που διατηρεί ένα αρχείο ανοιχτό στο node_modules του περιβάλλοντος εκτέλεσης ενώ το npm προσπαθεί να το καταργήσει. Η εγκατάσταση επιχειρείται ξανά από έναν καθαρό κατάλογο στην επόμενη εκτέλεση του zinnector dev· εάν συνεχίσει να συμβαίνει, το zinnector dev --reset-runtime καταργεί πρώτα ολόκληρο τον κατάλογο του περιβάλλοντος εκτέλεσης και εγκαθιστά εκ νέου.

«the local playground runtime could not be installed»

Το μήνυμα περιλαμβάνει τις τελευταίες γραμμές του ίδιου του npm και την ακριβή εντολή που εκτέλεσε το Zinnector®, ώστε να μπορείτε να την εκτελέσετε εσείς οι ίδιοι και να δείτε την πλήρη έξοδο. Οι συνήθεις αιτίες είναι ένα πρόβλημα δικτύου ή διακομιστή μεσολάβησης (proxy) — η λήψη του περιβάλλοντος εκτέλεσης γίνεται με το δικό σας npm, επομένως ισχύουν οι ρυθμίσεις npm config set proxy … και τα είδωλα μητρώου (registry mirrors) — ή μια ημιτελής προηγούμενη εγκατάσταση, την οποία απαλείφει το --reset-runtime.

«the local playground exited before it was ready», ή δεν καθίσταται ποτέ έτοιμο

Εκτελέστε zinnector dev --verbose για να δείτε την έξοδο του ίδιου του περιβάλλοντος εκτέλεσης. Μια θύρα που χρησιμοποιείται ήδη είναι η συνηθέστερη αιτία: zinnector dev --port 9401, ή ορίστε το port στο zinnector.json. Για ένα περιβάλλον εκτέλεσης που εγκαταστάθηκε αλλά δεν εκκινεί: zinnector dev --reset-runtime. Η πρώτη εκκίνηση πραγματοποιεί επίσης λήψη του ίδιου του WordPress, επομένως σε μια αργή σύνδεση δώστε του λίγα λεπτά· το CLI περιμένει έως και πέντε λεπτά πριν αναφέρει λήξη χρονικού ορίου αντί να παγώσει.

«this project is not a git repository» κατά το push

Οι αναπτύξεις (deploys) καθοδηγούνται από ένα αποθετήριο, επομένως το zinnector push χρειάζεται ένα αποθετήριο με απομακρυσμένο προορισμό (remote) στον οποίο η πλατφόρμα έχει πρόσβαση. git init && git add -A && git commit -m initial, προσθέστε το απομακρυσμένο σας αποθετήριο στο GitHub ή το GitLab, και στη συνέχεια εκτελέστε zinnector link για να το συνδέσετε με τον ιστότοπο.

Ο ιστότοπος εμφανίζει λευκή οθόνη μετά από μια ανάπτυξη

Εκτελέστε zinnector check. Εννέα στις δέκα φορές πρόκειται για διαφορά έκδοσης PHP — κάνατε build σε νεότερη PHP από αυτήν που εκτελεί η υποδοχή (slot) — και η αναφορά δηλώνει σε ποια έκδοση να αλλάξετε την υποδοχή με το zinnector php <version>, ή για ποια έκδοση να αναπτύξετε με το zinnector dev --php <version>. Η εντολή zinnector logs --error εμφανίζει το ίδιο το ανεπανόρθωτο σφάλμα (fatal error).

Σχετικά

• Γρήγορη εκκίνηση · Τοπική ανάπτυξη · Ανάπτυξη εφαρμογής · Οδηγός εντολών