Bắt đầu với Zinnector®, CLI dành cho nhà phát triển

Zinnector® là công cụ dòng lệnh miễn phí, được cấp phép MIT của Zinn Digital® dành cho các nhà phát triển WordPress. Công cụ này tạo khung dự án trang web, chạy một bản WordPress thực tế ngay trên máy của quý vị mà không cần cài đặt bất cứ thứ gì ngoài Node — không Docker, không MAMP, không có PHP trong PATH — sau đó kiểm tra nội dung quý vị đã xây dựng với slot lưu trữ mà quý vị chuẩn bị triển khai và đẩy mã lên. Hướng dẫn này sẽ dẫn dắt quý vị từ con số không đến một trang web đang hoạt động chỉ trong khoảng hai phút, đồng thời cho quý vị biết kết quả thành công trông như thế nào ở mỗi bước để quý vị nhận biết khi có sự cố xảy ra.

Những gì quý vị cần

• Node 24 hoặc mới hơn. Chạy node --version; lệnh này phải xuất ra v24 hoặc cao hơn. Cài đặt phiên bản LTS hiện tại từ nodejs.org — trên Windows là winget install OpenJS.NodeJS.LTS, trên macOS là brew install node@24.
• npm, đi kèm sẵn với Node. Zinnector® sử dụng công cụ này một lần để tải môi trường thực thi WordPress vào bộ nhớ đệm riêng của nó.
• git, chỉ cần thiết cho lệnh zinnector push — việc triển khai được thực hiện từ kho lưu trữ của quý vị.
• Docker, chỉ cần thiết nếu quý vị yêu cầu sử dụng với --runtime docker. Môi trường thực thi mặc định không cần đến nó.

Không có nội dung nào dưới đây yêu cầu tài khoản. Khóa API chỉ cần thiết khi quý vị kết nối tới một slot lưu trữ, trong tài liệu Triển khai với Zinnector®.

Bước 1 — cài đặt công cụ

npm install -g zinnector

Nếu npm xuất thông báo npm WARN EBADENGINE, phiên bản Node của quý vị đang cũ hơn mức >=24.18.1 mà gói yêu cầu. Quá trình cài đặt vẫn sẽ hoàn tất, nhưng CLI sẽ từ chối chạy. Hãy nâng cấp Node trước, sau đó cài đặt lại.

Bước 2 — kiểm tra phiên bản

zinnector --version

Thành công: hiển thị một số phiên bản, ví dụ 0.1.2. Nếu quý vị thấy "Zinnector® needs Node 24 or newer — this is Node 20.x", tệp nhị phân đã được cài đặt nhưng phiên bản Node của quý vị quá cũ; lệnh sẽ thoát với mã lỗi 78 thay vì thực hiện bất kỳ tác vụ nào.

Bước 3 — đọc tài liệu trợ giúp

zinnector --help

Thành công: một biểu ngữ nêu tên năm lệnh trong quy trình (new, dev, link, check, push) và sau đó là từng lệnh kèm theo mục đích tóm tắt trên một dòng. Mỗi lệnh cũng hỗ trợ tùy chọn --help riêng — ví dụ zinnector dev --help sẽ liệt kê các cờ cho môi trường thực thi, PHP và cổng mạng. Danh sách đầy đủ cùng các ví dụ có trong tài liệu tham khảo lệnh.

Bước 4 — tạo khung một trang web

zinnector new my-site

Thành công: tiêu đề Created my-site và danh sách các tệp đã được ghi — zinnector.json, cấu trúc thư mục wp-content với plugins/, themes/ cùng một trình hỗ trợ mu-plugins/, một tệp .gitignore và một tệp README — theo sau là các lệnh tiếp theo cần chạy. Không có mục nào trong đó là văn bản giữ chỗ; dự án có thể khởi động ngay ở trạng thái hiện tại. Tùy chọn --template plugin hoặc --template theme sẽ tạo khung cho một plugin hoặc block theme có thể kích hoạt ngay thời điểm nó được tạo.

Bước 5 — khởi chạy

cd my-site
zinnector dev

Trong lần đầu tiên, Zinnector® sẽ hỏi một lần trước khi tải môi trường thực thi WordPress — khoảng 570 MB, do chứa toàn bộ các bản dựng PHP từ 5.2 đến 8.5 — vào thư mục bộ nhớ đệm riêng của nó, tuyệt đối không tải vào dự án của quý vị. Hãy trả lời Y, hoặc truyền thêm --yes để bỏ qua câu hỏi. Trên Node 26 hoặc mới hơn, công cụ cũng sẽ tải riêng một bản Node 24 dành cho môi trường thực thi (khoảng 30 MB, được xác thực dựa trên mã kiểm tra tính toàn vẹn của nodejs.org), vì mô-đun gốc của môi trường thực thi chỉ có các tệp nhị phân được dựng sẵn cho Node 24 và 25; quý vị không cần trình biên dịch hay Visual Studio.

Thành công: một khối hiển thị tên dự án, phiên bản PHP và phiên bản WordPress, sau đó là:

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

Bước 6 — mở trang web

Truy cập http://127.0.0.1:9400 trên trình duyệt. Thành công: một trang web WordPress mới tinh có tiêu đề My WordPress Website, được phân phối bởi phiên bản PHP mà quý vị yêu cầu. Địa chỉ http://127.0.0.1:9400/wp-admin sẽ mở bảng điều khiển với trạng thái đã đăng nhập sẵn. Hãy thả một plugin vào wp-content/plugins/ hoặc một theme vào wp-content/themes/ và nó sẽ xuất hiện ngay trong lần tải lại trang tiếp theo — môi trường thực thi phân phối các thư mục đó trực tiếp từ dự án của quý vị.

Nhấn Ctrl-C để dừng. Lệnh zinnector dev --once khởi động môi trường thực thi, in ra những gì đang thực sự chạy (phiên bản PHP, phiên bản WordPress, các phần mở rộng đã tải) rồi dừng lại — rất hữu ích khi quý vị muốn kiểm chứng thực tế thay vì một lời hứa hẹn.

Các bước tiếp theo

• Phát triển cục bộ với zinnector dev — hai môi trường thực thi, việc lựa chọn phiên bản PHP và WordPress, cùng những gì được phân phối từ đâu.
• Triển khai với Zinnector® — đăng nhập, liên kết dự án với một slot, kiểm tra sơ bộ trước khi chạy, đẩy mã.
• Tài liệu tham khảo lệnh — toàn bộ các lệnh, cờ và ví dụ.
• Xử lý sự cố — các lỗi mà người dùng thực tế hay gặp phải và cách khắc phục cho từng lỗi.

Tài liệu tương tự cũng có trong tệp README của gói trên npm và trên GitHub, nơi chúng tôi luôn hoan nghênh các vấn đề (issues) và yêu cầu kéo (pull requests).