Dokumentasi ServBay: Cara Menetapkan Versi Node.js Tertentu untuk Projek, Skrip & Laman Web Anda

Sebagai persekitaran pembangunan web tempatan yang mantap, ServBay menyokong pelbagai bahasa pengaturcaraan dan teknologi, termasuk Node.js. Dalam pembangunan sebenar, anda mungkin memerlukan versi Node.js yang berbeza untuk pelbagai projek, skrip tertentu, atau keseluruhan laman web. Misalnya, sebuah projek lama mungkin bergantung kepada Node.js 14, sedangkan projek baharu perlukan ciri terbaru Node.js 20. ServBay menawarkan cara fleksibel untuk memenuhi keperluan ini.

Dokumen ini menerangkan secara terperinci cara mudah menentukan versi Node.js tertentu untuk skrip dan laman web Node.js dalam ServBay, serta bagaimana menggunakan konfigurasi peringkat projek.

Menetapkan Versi Node.js Khusus dan Konfigurasi Projek Melalui Fail .servbay.config

Bagi projek yang memerlukan kawalan ketat ke atas versi Node.js dan pembolehubah persekitaran lain, ServBay menyediakan cara konfigurasi di peringkat projek, iaitu dengan mencipta fail .servbay.config di direktori akar projek anda. Melalui fail ini, anda boleh menentukan versi Node.js yang digunakan projek tersebut, alamat repositori pengurus pakej, direktori cache dan konfigurasi berkaitan, memastikan keterasingan dan konsistensi persekitaran projek anda.

Contoh format fail .servbay.config yang menetapkan versi Node.js tertentu serta konfigurasi npm/yarn dan cache:

NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Contoh: menggunakan mirror tertentu
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Contoh: menggunakan mirror tertentu
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Contoh: tetapkan laluan cache
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Contoh: tetapkan laluan cache

Penjelasan:

• NODE_VERSION: Menetapkan nombor versi utama Node.js untuk projek ini. ServBay akan mencari dan menggunakan Node.js yang dipasang dengan versi sepadan.
• YARN_CONFIG_REGISTRY, NPM_CONFIG_REGISTRY: Konfigurasi alamat repositori bagi pengurus pakej npm atau yarn projek.
• NPM_CONFIG_CACHE, YARN_CONFIG_CACHE: Tetapan direktori cache bagi npm atau yarn projek. Dalam contoh, digunakan subdirektori di bawah direktori fail sementara ServBay /Applications/ServBay/tmp/.

Secara amnya, fail .servbay.config perlu diletakkan di direktori akar projek anda. Untuk maklumat dan panduan terperinci, sila rujuk bahagian berkaitan .servbay.config file dalam dokumentasi rasmi ServBay.

Menjalankan Skrip Node.js Versi Tertentu Melalui Terminal

Jika anda tidak ingin tetapkan versi Node.js khas di tahap projek—hanya mahu panggil mana-mana versi tertentu secara sementara—anda boleh gunakan alias terminal yang disediakan oleh ServBay.

Dalam persekitaran terminal ServBay (boleh dibuka daripada antara muka aplikasi ServBay), anda boleh gunakan arahan node-<versi> untuk menentukan versi Node.js yang digunakan oleh skrip Node.js anda. ServBay secara automatik mencipta alias seperti ini untuk setiap versi Node.js yang dipasang.

Contohnya, untuk menjalankan skrip script.js menggunakan Node.js versi 14, gunakan:

$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Contoh output, nombor versi mungkin berbeza

$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Contoh output, nombor versi mungkin berbeza

$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Contoh output, nombor versi mungkin berbeza

Penjelasan Contoh

• $ node-14 script.js: Menjalankan skrip script.js menggunakan Node.js versi 14.x.x yang dipasang melalui ServBay.
• $ node-16 script.js: Menjalankan skrip script.js menggunakan Node.js versi 16.x.x daripada ServBay.
• $ node-20 script.js: Menjalankan skrip script.js menggunakan Node.js versi 20.x.x daripada ServBay.

Dengan cara ini, anda boleh menguji dan memastikan keserasian pelbagai versi Node.js secara fleksibel, atau menjalankan tugas yang memerlukan versi tertentu dengan cepat—tanpa perlu menukar versi Node.js secara global.

Menetapkan Versi Node.js Laman Web Melalui Antara Muka Pentadbiran ServBay

ServBay membenarkan anda menentukan versi Node.js lalai bagi laman web yang dihoskan secara terus melalui antara muka pentadbirannya. Ini sangat berguna untuk laman web yang menggunakan Node.js sebagai pelayan belakang (misalnya aplikasi rangka kerja Node.js yang diproksi oleh Caddy atau Nginx), atau laman yang perlukan persekitaran Node.js tertentu.

Langkah-langkah

1. Buka Antara Muka Pentadbiran ServBay: Lancarkan aplikasi ServBay, dan akses antara muka pentadbir melalui pelayar (biasanya di http://localhost:5200 atau pautan dalam tetingkap utama aplikasi ServBay).

2. Navigasi ke Pengurusan Laman Web: Dalam bar navigasi kiri, klik pada Website (Laman Web).

3. Pilih & Edit Laman Web: Cari laman web yang ingin dikonfigurasikan (contohnya laman di /Applications/ServBay/www/servbay.demo). Klik butang edit (ikon gear atau pensel) di sebelah nama laman, atau klik nama laman untuk masuk ke halaman terperinci.

4. Tetapkan Versi Node.js: Dalam halaman konfigurasi laman web, cari tetapan versi Node.js—biasanya berupa menu jatuh-bawah. Pilih versi Node.js lalai yang anda ingin gunakan untuk laman tersebut.

5. Simpan Perubahan: Selepas memilih versi, klik butang Simpan atau Guna di bahagian bawah untuk menyimpan konfigurasi anda.

6. Mulakan Semula Laman atau ServBay (Jika Perlu): Sesetengah perubahan memerlukan pelayan web (Caddy/Nginx) atau seluruh ServBay dimulakan semula agar perubahan berkuat kuasa. ServBay akan memberi petunjuk jika perlu melakukan restart.

Perhatian

• Pastikan Versi Node.js Sudah Dipasang dan Berjalan: Versi Node.js yang anda pilih mesti telah dipasang dan diaktifkan di halaman Packages (Perisian) ServBay. Jika belum, pergi dahulu ke halaman tersebut untuk pasang atau aktifkan versi berkenaan.
• Jenis Laman Web: Tetapan ini terutamanya khas untuk laman web yang bergantung sepenuhnya pada Node.js (misalnya aplikasi Express.js, Next.js, NestJS dan sebagainya). Untuk laman web statik atau yang hanya guna PHP/Python/Go, tetapan versi Node.js ini mungkin tidak berkaitan atau hanya mempunyai kesan terhad.
• Ujian Keserasian: Selepas mengubah versi Node.js laman web anda, sentiasa lakukan ujian menyeluruh untuk memastikan semua kebergantungan dan servis berfungsi dengan betul tanpa isu keserasian.
• Hubungan dengan .servbay.config: Tetapan di peringkat laman web hanya sebagai lalai. Jika terdapat fail .servbay.config dalam direktori laman dan ia menetapkan NODE_VERSION, konfigurasi dalam .servbay.config akan diutamakan untuk kawalan lebih terperinci terhadap projek tersebut.

Ringkasan

Sebagai persekitaran pembangunan tempatan yang menyeluruh, ServBay menawarkan pelbagai cara yang fleksibel dan mantap untuk mengurus serta menetapkan persekitaran Node.js anda. Anda boleh menggunakan fail .servbay.config di akar projek bagi kawalan serta konfigurasi persekitaran dan pembolehubah yang khusus, menjalankan skrip menggunakan sintaks ringkas node-<versi> di terminal untuk versi Node.js tertentu dengan pantas, atau menetapkan versi lalai Node.js laman web secara terus dalam antara muka pentadbiran ServBay. Semua ciri ini memastikan anda boleh memenuhi keperluan versi Node.js bagi pelbagai projek dan situasi dengan mudah—sama ada untuk menjaga keserasian projek lama, menguji ciri terbaru, atau mengekalkan konsistensi antara persekitaran pembangunan dan pengeluaran. ServBay memberi sokongan yang berkesan untuk keperluan anda, meningkatkan kecekapan pembangunan dan keupayaan pengurusan persekitaran dengan ketara.