Memulakan Zinnector®, CLI pembangun

Zinnector® ialah alat baris perintah berlesen MIT dan percuma daripada Zinn Digital® untuk pembangun WordPress. Ia menyediakan struktur tapak, menjalankan WordPress sebenar pada mesin anda sendiri tanpa apa-apa yang dipasang melainkan Node — tiada Docker, tiada MAMP, tiada PHP pada PATH anda — kemudian menyemak apa yang anda bina berbanding slot pengehosan yang anda bakal lancarkan dan menolaknya. Panduan ini membawa anda daripada tiada apa-apa kepada tapak yang berfungsi dalam masa kira-kira dua minit, dan memberitahu anda rupa kejayaan pada setiap langkah supaya anda tahu apabila sesuatu telah berlaku kesilapan.

Perkara yang anda perlukan

• Node 24 atau lebih baharu. Jalankan node --version; ia mesti mencetak v24 atau lebih tinggi. Pasang LTS semasa daripada nodejs.org — pada Windows winget install OpenJS.NodeJS.LTS, pada macOS brew install node@24.
• npm, yang disertakan bersama Node. Zinnector® menggunakannya sekali, untuk memuat turun masa togol WordPress ke dalam cache sendiri.
• git, hanya untuk zinnector push — pelancaran didorong dari repositori anda.
• Docker, hanya jika anda memintanya dengan --runtime docker. Masa togol lalai tidak memerlukan apa-apa.

Tiada apa-apa di bawah memerlukan akaun. Kunci API hanya diperlukan apabila anda mencapai slot pengehosan, dalam Melancarkan dengan Zinnector®.

Langkah 1 — pasang ia

npm install -g zinnector

Jika npm mencetak npm WARN EBADENGINE, Node anda lebih lama daripada >=24.18.1 yang diisytiharkan oleh pakej. Pemasangan selesai juga, tetapi CLI akan enggan berjalan. Naik taraf Node dahulu, kemudian pasang semula.

Langkah 2 — semak versi

zinnector --version

Kejayaan: nombor versi, contohnya 0.1.2. Jika anda melihat "Zinnector® memerlukan Node 24 atau lebih baharu — ini ialah Node 20.x" binari dipasang tetapi Node anda terlalu lama; arahan keluar dengan kod 78 daripada melakukan apa-apa.

Langkah 3 — baca bantuan

zinnector --help

Kejayaan: sepanduk yang menamakan lima arahan aliran (new, dev, link, check, push) dan kemudian setiap arahan dengan tujuan satu baris. Setiap arahan juga mengambil --help sendiri — zinnector dev --help menyenaraikan bendera masa togol, PHP dan port. Senarai lengkap, dengan contoh, ada dalam rujukan arahan.

Langkah 4 — bina struktur tapak

zinnector new my-site

Kejayaan: tajuk Created my-site dan senarai fail yang ditulisnya — zinnector.json, pokok wp-content dengan plugins/, themes/ dan pembantu mu-plugins/, .gitignore dan README — diikuti dengan arahan seterusnya untuk dijalankan. Tiada apa-apa di dalamnya adalah pemegang tempat; projek diboot seperti sedia ada. --template plugin atau --template theme menyusun atur palam atau tema blok yang diaktifkan sebaik sahaja ia wujud.

Langkah 5 — jalankan ia

cd my-site
zinnector dev

Kali pertama, Zinnector® bertanya sekali sebelum memuat turun masa togol WordPress — kira-kira 570 MB, kerana ia membawa setiap binaan PHP daripada 5.2 kepada 8.5 — ke dalam direktori cachenya sendiri, tidak pernah ke dalam projek anda. Jawab Y, atau luluskan --yes untuk melangkau soalan. Pada Node 26 atau lebih baharu, ia juga mengambil Node 24 untuk masa togol sahaja (kira-kira 30 MB, disahkan terhadap hasil tambah semak nodejs.org), kerana modul asal masa togol hanya mempunyai binari prabina untuk Node 24 dan 25; anda tidak memerlukan pengkompil atau Visual Studio.

Kejayaan: blok yang menamakan projek, versi PHP dan versi WordPress, kemudian:

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

Langkah 6 — buka ia

Lawati http://127.0.0.1:9400 dalam pelayar. Kejayaan: tapak WordPress baharu bertajuk My WordPress Website, disajikan oleh versi PHP yang anda minta. http://127.0.0.1:9400/wp-admin membuka papan pemuka yang telah log masuk. Gugurkan palam ke dalam wp-content/plugins/ atau tema ke dalam wp-content/themes/ dan ia berada di sana pada muat semula seterusnya — masa togol menyajikan direktori tersebut terus dari projek anda.

Tekan Ctrl-C untuk berhenti. zinnector dev --once memboot masa togol, mencetak perkara yang sebenarnya berjalan (versi PHP, versi WordPress, sambungan dimuatkan) dan berhenti — berguna apabila anda mahukan bukti dan bukannya janji.

Ke mana hendak pergi seterusnya

• Pembangunan tempatan dengan zinnector dev — dua masa togol, memilih versi PHP dan WordPress, dan perkara yang disajikan dari mana.
• Melancarkan dengan Zinnector® — log masuk, pautkan projek ke slot, pratempah, tolak.
• Rujukan arahan — setiap arahan, bendera dan contoh.
• Penyelesaian masalah — ralat yang benar-benar dilanda orang, dan pembetulan untuk setiap satu.

Dokumentasi yang sama ada dalam README pakej pada npm dan pada GitHub, di mana isu dan permintaan tarik dialu-alukan.