Bermula dengan Zinnector®, CLI pembangun

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

Apa yang anda perlukan

• Node 24 atau lebih baharu. Jalankan node --version; ia mesti memaparkan 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 jalan WordPress ke dalam cache miliknya sendiri.
• git, hanya untuk zinnector push — penggunaan dipacu daripada repositori anda.
• Docker, hanya jika anda memintanya dengan --runtime docker. Masa jalan lalai tidak memerlukannya.

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

Langkah 1 — pasangkannya

npm install -g zinnector

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

Langkah 2 — semak versi

zinnector --version

Kejayaan: nombor versi, contohnya 0.1.2. Jika anda melihat "Zinnector® needs Node 24 or newer — this is Node 20.x" binari telah dipasang tetapi Node anda terlalu lama; perintah tersebut keluar dengan kod 78 dan bukannya melakukan apa-apa.

Langkah 3 — baca bantuan

zinnector --help

Kejayaan: sepanduk yang menamakan lima perintah aliran tersebut (new, dev, link, check, push) dan kemudian setiap perintah bersama tujuan satu baris. Setiap perintah juga menerima --help miliknya sendiri — zinnector dev --help menyenaraikan bendera masa jalan, PHP dan port. Senarai lengkap, berserta contoh, terdapat dalam rujukan perintah.

Langkah 4 — bina perancah tapak

zinnector new my-site

Kejayaan: tajuk Created my-site dan senarai fail yang ditulisnya — zinnector.json, pepohon wp-content dengan plugins/, themes/ dan pembantu mu-plugins/, satu .gitignore serta README — diikuti dengan perintah seterusnya untuk dijalankan. Tiada apa-apa di dalamnya merupakan pemegang tempat; projek ini membut mengikut keadaannya sekarang. --template plugin atau --template theme membina perancah pemalam atau tema blok yang diaktifkan sebaik sahaja ia wujud.

Langkah 5 — jalankannya

cd my-site
zinnector dev

Kali pertama, Zinnector® bertanya sekali sebelum memuat turun masa jalan WordPress — kira-kira 570 MB, kerana ia membawa setiap binaan PHP daripada 5.2 hingga 8.5 — ke dalam direktori cachenya sendiri, tidak sekali-kali ke dalam projek anda. Jawab Y, atau hantarkan --yes untuk melangkau soalan tersebut. Pada Node 26 atau lebih baharu ia juga mengambil Node 24 untuk masa jalan sahaja (kira-kira 30 MB, disahkan terhadap hasil tambah semak nodejs.org), kerana modul asli masa jalan tersebut mempunyai binari prabina hanya untuk Node 24 dan 25; anda tidak memerlukan penyusun 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 — bukanya

Lawati http://127.0.0.1:9400 dalam pelayar. Kejayaan: tapak WordPress baharu bertajuk My WordPress Website, yang dihidangkan oleh versi PHP yang anda minta. http://127.0.0.1:9400/wp-admin membuka papan pemuka dalam keadaan sedia dilog masuk. Letakkan pemalam ke dalam wp-content/plugins/ atau tema ke dalam wp-content/themes/ dan ia sedia ada pada muat semula seterusnya — masa jalan menghidangkan direktori tersebut terus daripada projek anda.

Tekan Ctrl-C untuk berhenti. zinnector dev --once membut masa jalan, memaparkan apa yang sebenarnya sedang berjalan (versi PHP, versi WordPress, sambungan yang dimuatkan) dan berhenti — berguna apabila anda mahukan bukti dan bukannya janji semata-mata.

Ke mana hendak dituju seterusnya

• Pembangunan setempat dengan zinnector dev — dua masa jalan, memilih versi PHP dan WordPress, dan apa yang dihidangkan dari mana.
• Menerapkan dengan Zinnector® — log masuk, pautkan projek ke slot, lakukan pra-pemeriksaan, tolak.
• Rujukan perintah — setiap perintah, bendera dan contoh.
• Penyelesaian masalah — ralat yang benar-benar dihadapi orang ramai, dan pembetulan untuk setiap satu.

Dokumentasi yang sama terdapat dalam README pakej di npm dan di GitHub, tempat isu dan permintaan tarikan sentiasa dialu-alukan.