Ξεκινώντας με το Zinnector®, το CLI για προγραμματιστές

Το Zinnector® είναι το δωρεάν, αδειοδοτημένο κατά MIT εργαλείο γραμμής εντολών της Zinn Digital® για προγραμματιστές WordPress. Δημιουργεί τη δομή ενός ιστότοπου, εκτελεί ένα πραγματικό WordPress στον υπολογιστή σας χωρίς τίποτε άλλο εγκατεστημένο εκτός από το Node — ούτε Docker, ούτε MAMP, ούτε PHP στο PATH σας — στη συνέχεια ελέγχει αυτό που κατασκευάσατε σε σχέση με τη θέση φιλοξενίας στην οποία πρόκειται να κάνετε ανάπτυξη και το αποστέλλει. Αυτός ο οδηγός σάς μεταφέρει από το μηδέν σε έναν ιστότοπο σε λειτουργία σε περίπου δύο λεπτά, και σας ενημερώνει πώς φαίνεται η επιτυχία σε κάθε βήμα, ώστε να γνωρίζετε πότε κάτι έχει πάει στραβά.

Τι χρειάζεστε

• Node 24 ή νεότερο. Εκτελέστε node --version· πρέπει να εμφανίσει v24 ή υψηλότερη. Εγκαταστήστε την τρέχουσα έκδοση LTS από το nodejs.org — στα Windows winget install OpenJS.NodeJS.LTS, σε macOS brew install node@24.
• npm, το οποίο συνοδεύει το Node. Το Zinnector® το χρησιμοποιεί μία φορά, για να κατεβάσει τον χρόνο εκτέλεσης του WordPress στη δική του κρυφή μνήμη.
• git, μόνο για το zinnector push — οι αναπτύξεις εκκινούν από το αποθετήριο σας.
• Docker, μόνο εάν το ζητήσετε με --runtime docker. Ο προεπιλεγμένος χρόνος εκτέλεσης δεν χρειάζεται κανένα.

Τίποτα από τα παρακάτω δεν απαιτεί λογαριασμό. Ένα κλειδί API απαιτείται μόνο όταν φτάσετε σε μια θέση φιλοξενίας, στην ενότητα Ανάπτυξη με το Zinnector®.

Βήμα 1 — εγκατάστασή του

npm install -g zinnector

Εάν το npm εκτυπώσει npm WARN EBADENGINE, το Node σας είναι παλαιότερο από το >=24.18.1 που δηλώνει το πακέτο. Η εγκατάσταση ολοκληρώνεται ούτως ή άλλως, αλλά η CLI θα αρνηθεί να εκτελεστεί. Αναβαθμίστε πρώτα το Node και, στη συνέχεια, εγκαταστήστε ξανά.

Βήμα 2 — έλεγχος της έκδοσης

zinnector --version

Επιτυχία: ένας αριθμός έκδοσης, για παράδειγμα 0.1.2. Εάν δείτε "Zinnector® needs Node 24 or newer — this is Node 20.x" το δυαδικό αρχείο είναι εγκατεστημένο αλλά το Node σας είναι πολύ παλιό· η εντολή τερματίζεται με κωδικό 78 αντί να κάνει οτιδήποτε.

Βήμα 3 — ανάγνωση της βοήθειας

zinnector --help

Επιτυχία: ένα banner που ονομάζει τις πέντε εντολές της ροής (new, dev, link, check, push) και στη συνέχεια κάθε εντολή με έναν σκοπό μίας γραμμής. Κάθε εντολή δέχεται επίσης το δικό της --help — το zinnector dev --help παραθέτει τις σημαίες χρόνου εκτέλεσης, PHP και θύρας. Η πλήρης λίστα, με παραδείγματα, βρίσκεται στην αναφορά εντολών.

Βήμα 4 — δημιουργία δομής ιστότοπου

zinnector new my-site

Επιτυχία: μια κεφαλίδα Created my-site και μια λίστα με τα αρχεία που έγραψε — zinnector.json, ένα δέντρο wp-content με plugins/, themes/ και έναν βοηθό mu-plugins/, ένα .gitignore και ένα README — ακολουθούμενα από τις επόμενες εντολές προς εκτέλεση. Τίποτα σε αυτό δεν είναι σύμβολο κράτησης θέσης· το έργο εκκινεί όπως είναι. Το --template plugin ή --template theme δημιουργεί τη δομή ενός πρόσθετου ή ενός θέματος μπλοκ που ενεργοποιείται τη στιγμή που υπάρχει.

Βήμα 5 — εκτέλεσή του

cd my-site
zinnector dev

Την πρώτη φορά, το Zinnector® ρωτάει μία φορά πριν κατεβάσει τον χρόνο εκτέλεσης του WordPress — περίπου 570 MB, επειδή μεταφέρει κάθε έκδοση PHP από 5.2 έως 8.5 — στον δικό του κατάλογο κρυφής μνήμης, ποτέ στο έργο σας. Απαντήστε Y, ή περάστε --yes για να παραλείψετε την ερώτηση. Στο Node 26 ή νεότερο, ανακτά επίσης ένα Node 24 αποκλειστικά για τον χρόνο εκτέλεσης (περίπου 30 MB, επαληθευμένο έναντι των αθροισμάτων ελέγχου του nodejs.org), επειδή το εγγενές δομικό στοιχείο του χρόνου εκτέλεσης διαθέτει προμεταφρασμένα δυαδικά αρχεία μόνο για Node 24 και 25· δεν χρειάζεστε μεταγλωττιστή ή Visual Studio.

Επιτυχία: ένα μπλοκ που ονομάζει το έργο, την έκδοση PHP και την έκδοση WordPress, στη συνέχεια:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Βήμα 6 — άνοιγμά του

Επισκεφθείτε τη διεύθυνση http://127.0.0.1:9400 σε ένα πρόγραμμα περιήγησης. Επιτυχία: ένας νέος ιστότοπος WordPress με τίτλο My WordPress Website, ο οποίος εξυπηρετείται από την έκδοση PHP που ζητήσατε. Το http://127.0.0.1:9400/wp-admin ανοίγει τον πίνακα ελέγχου ήδη συνδεδεμένος. Αποθέστε ένα πρόσθετο στο wp-content/plugins/ ή ένα θέμα στο wp-content/themes/ και βρίσκεται εκεί στην επόμενη επαναφόρτωση — ο χρόνος εκτέλεσης εξυπηρετεί αυτούς τους καταλόγους απευθείας από το έργο σας.

Πατήστε Ctrl-C για διακοπή. Το zinnector dev --once εκκινεί τον χρόνο εκτέλεσης, εκτυπώνει αυτό που εκτελείται πραγματικά (έκδοση PHP, έκδοση WordPress, φορτωμένες επεκτάσεις) και σταματά — χρήσιμο όταν θέλετε απόδειξη αντί για υπόσχεση.

Πού να μεταβείτε στη συνέχεια

• Τοπική ανάπτυξη με το zinnector dev — οι δύο χρόνοι εκτέλεσης, η επιλογή εκδόσεων PHP και WordPress, και τι εξυπηρετείται από πού.
• Ανάπτυξη με το Zinnector® — σύνδεση, σύνδεση του έργου σε μια θέση, προετοιμασία πτήσης, αποστολή.
• Η αναφορά εντολών — κάθε εντολή, σημαία και παράδειγμα.
• Αντιμετώπιση προβλημάτων — τα σφάλματα που συναντούν πραγματικά οι χρήστες, και η λύση για καθένα.

Η ίδια τεκμηρίωση βρίσκεται στο README του πακέτου στο npm και στο GitHub, όπου τα ζητήματα και τα αιτήματα έλξης είναι ευπρόσδεκτα.