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

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

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

Ένα σφάλμα στο 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® needs Node 24 or newer"

Η έκδοση της 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) του οποίου τα προκατασκευασμένα δυαδικά αρχεία υπάρχουν μόνο για τη 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)

Σχεδόν πάντα πρόκειται για λογισμικό προστασίας από ιούς (antivirus) ή ευρετηριαστή αναζήτησης που διατηρεί ένα αρχείο ανοιχτό στο φάκελο 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 mirror) — ή μια ημιτελής προηγούμενη εγκατάσταση, την οποία καθαρίζει η παράμετρος --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 περιμένει έως και πέντε λεπτά πριν αναφέρει λήξη χρονικού ορίου (timeout) αντί να κολλήσει.

"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 για να τη συνδέσετε με τον ιστότοπο.

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

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

Σχετικά

• Ξεκινώντας · Τοπική ανάπτυξη · Ανάπτυξη εφαρμογών · Αναφορά εντολών