Konfigurasi Persekitaran Peringkat Projek dengan Fail .servbay.config

Pengenalan

ServBay ialah perisian persekitaran pembangunan web tempatan yang hebat dan membolehkan pembangun menetapkan persekitaran runtime yang khusus untuk setiap projek. Fungsi teras ini direalisasikan melalui sokongan fail bernama .servbay.config yang boleh diletakkan dalam setiap direktori projek.

Dengan fail .servbay.config, anda boleh dengan mudah menetapkan versi PHP, Node.js, Python, Go, Java, dan bahasa lain yang diperlukan untuk projek tertentu, serta mengkonfigurasi tetapan pengurus pakej Node.js (seperti NPM, Yarn) termasuk alamat repositori dan direktori cache. Pengawalan terperinci di peringkat projek sebegini sangat meningkatkan kecekapan dan kemudahan pembangunan, memastikan setiap projek berjalan di persekitaran khususnya dengan stabil, dan mengelakkan konflik versi.

Bagaimana Fail .servbay.config Berfungsi

Apabila ServBay dimulakan atau laman web dimuat semula, ia akan menyemak sama ada terdapat fail .servbay.config di direktori akar laman web. Jika fail ini wujud, ServBay akan membaca konfigurasi di dalamnya dan aplikasi konfigurasi tersebut pada persekitaran runtime projek tersebut sahaja. Sebarang konfigurasi di peringkat projek ini akan menindih (override) tetapan global dalam ServBay untuk item konfigurasi yang sama. Jika fail .servbay.config tiada, atau mana-mana nilai tidak ditetapkan, tetapan global ServBay akan digunakan sebagai nilai lalai.

Mekanisme ini membolehkan penukaran antara projek yang lancar - setiap projek membawa konfigurasi persekitaran sendiri.

Cara Membuat dan Mengkonfigurasi .servbay.config

Penyediaan fail .servbay.config adalah sangat mudah.

Lokasi Fail

Cipta fail bernama .servbay.config di direktori akar projek anda. Lazimnya, direktori akar projek berada dalam folder web ServBay, contohnya /Applications/ServBay/www/nama-projek-anda/.

Sintaks Konfigurasi

Fail .servbay.config menggunakan format ringkas KEY=VALUE untuk menentukan tetapan, satu konfigurasi bagi setiap baris. Anda boleh menggunakan simbol # untuk menambah komen demi menjadikan konfigurasi lebih mudah difahami.

Contoh Opsyen Konfigurasi

Berikut ialah contoh konfigurasi dalam fail .servbay.config, menunjukkan bagaimana untuk menetapkan pelbagai versi persekitaran dan tetapan pengurus pakej:

# Contoh fail .servbay.config

# Menetapkan versi PHP yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
PHP_VERSION=8.5

# Menetapkan versi Node.js yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
NODE_VERSION=20

# Menetapkan alamat mirror Yarn untuk mempercepatkan muat turun kebergantungan.
YARN_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/

# Menetapkan alamat mirror NPM untuk mempercepatkan muat turun kebergantungan.
NPM_CONFIG_REGISTRY=https://npmreg.proxy.ustclug.org/

# Tetapkan direktori cache tempatan untuk NPM. Nota: laluan ini adalah relatif kepada direktori pemasangan ServBay.
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache

# Tetapkan direktori cache tempatan untuk Yarn. Nota: laluan ini adalah relatif kepada direktori pemasangan ServBay.
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache

# Menetapkan versi Ruby yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
RUBY_VERSION=2.7

# Menetapkan versi Java (OpenJDK) yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
JAVA_VERSION=21

# Menetapkan versi Python yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
PYTHON_VERSION=3.11

# Menetapkan versi .NET yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
DOTNET_VERSION=5.0

# Menetapkan versi Go yang digunakan. Pastikan versi ini telah dipasang dalam ServBay.
GO_VERSION=1.12

# Menetapkan server proksi modul Go untuk mempercepatkan muat turun modul.
GOPROXY=https://goproxy.cn,direct

Sila ambil perhatian: Nombor versi dalam contoh di atas (PHP_VERSION=8.5, NODE_VERSION=20, dan lain-lain) adalah untuk tujuan demonstrasi sahaja. Dalam penggunaan sebenar, isikan versi yang diperlukan bergantung pada keperluan projek anda, serta versi yang sudah dipasang dan disokong oleh ServBay. Jika versi yang dinyatakan tidak dipasang, ServBay mungkin akan menggunakan versi lalai atau memaparkan ralat.

Jenis Item Konfigurasi yang Disokong

Berdasarkan contoh di atas, fail .servbay.config menyokong jenis konfigurasi berikut:

1. Penetapan Versi Persekitaran:

   • PHP_VERSION: Tetapkan versi PHP.
   • NODE_VERSION: Tetapkan versi Node.js.
   • RUBY_VERSION: Tetapkan versi Ruby.
   • JAVA_VERSION: Tetapkan versi Java (OpenJDK).
   • PYTHON_VERSION: Tetapkan versi Python.
   • DOTNET_VERSION: Tetapkan versi .NET.
   • GO_VERSION: Tetapkan versi Go.
   • (Sila rujuk dokumen rasmi atau antaramuka ServBay untuk senarai penuh jenis persekitaran yang disokong serta nama pembolehubah konfigurasi.)

2. Konfigurasi Pengurus Pakej (Node.js):

   • YARN_CONFIG_REGISTRY: Alamat mirror Yarn.
   • NPM_CONFIG_REGISTRY: Alamat mirror NPM.
   • NPM_CONFIG_CACHE: Laluan direktori cache tempatan untuk NPM.
   • YARN_CONFIG_CACHE: Laluan direktori cache tempatan untuk Yarn.

3. Konfigurasi Proksi Modul Go:

   • GOPROXY: Alamat server proksi modul Go.

Konfigurasi ini membolehkan anda menetapkan persekitaran yang benar-benar bebas untuk setiap projek tanpa mengganggu projek lain.

Penggunaan Sebenar dan Pengesahan

Selepas mengkonfigurasi fail .servbay.config, pastikan projek anda telah dimuatkan dalam ServBay (iaitu, projek tersebut tersenarai dalam senarai “Laman Web” aplikasi ServBay). ServBay akan membaca fail konfigurasi setiap kali laman web dimuat/mula semula.

Untuk mengesahkan sama ada konfigurasi telah berkuat kuasa, anda boleh melakukan perkara berikut:

1. Lihat pada Antaramuka Aplikasi ServBay: Selalunya, versi persekitaran yang telah diterapkan untuk projek dipaparkan pada halaman butiran laman web atau bahagian berkaitan.

2. Sahkan melalui Terminal: Buka fungsi terminal ServBay dan pastikan direktori semasa adalah root projek anda. Kemudian, jalankan arahan di bawah untuk menyemak versi:

   • Periksa versi PHP: php -v
   • Periksa versi Node.js: node -v
   • Periksa versi Yarn: yarn -v
   • Periksa versi NPM: npm -v
   • Periksa versi Python: python -V atau python3 -V
   • Periksa versi Go: go version
   • Periksa versi Java: java -version
   • Periksa versi .NET: dotnet --version
   • Periksa versi Ruby: ruby -v Pastikan output sepadan dengan versi yang anda tetapkan dalam fail .servbay.config.

3. Sahkan melalui Laman Web (untuk PHP): Dalam direktori root projek, cipta satu fail PHP mudah (seperti info.php) dengan kandungan <?php phpinfo(); ?>. Akses fail ini melalui pelayar (http://projek-anda.servbay.demo/info.php) dan cari maklumat versi PHP pada halaman untuk mengesahkan ia mengikut spesifikasi anda.

Ilustrasi di bawah mungkin menunjukkan contoh paparan konfigurasi peringkat projek dalam antaramuka ServBay:

(Sila rujuk paparan sebenar aplikasi ServBay bagi melihat hasil sebenar selepas konfigurasi.)

Perkara Penting

• Nama fail .servbay.config mesti tepat, tanpa sebarang kesilapan ejaan.
• Letakkan fail ini di direktori akar projek.
• Hanya versi yang telah dipasang dan disokong dalam ServBay boleh digunakan dalam konfigurasi.
• Pisahkan item konfigurasi dengan baris baharu, satu KEY=VALUE untuk setiap baris.
• Jika terdapat ralat sintaks, keseluruhan fail mungkin diabaikan atau sebahagian konfigurasi tidak berfungsi.
• Konfigurasi dalam .servbay.config akan menindih tetapan global ServBay dan hanya terpakai untuk projek itu sahaja.

Soalan Lazim (FAQ)

S: Bagaimana jika tiada fail .servbay.config di direktori root projek saya?

J: Jika tiada fail tersebut, ServBay akan menggunakan persekitaran global yang anda tetapkan dalam antaramuka aplikasi untuk projek tersebut.

S: Apa yang berlaku jika saya isytiharkan versi yang belum dipasang dalam fail .servbay.config?

J: ServBay akan memaparkan ralat. Tindakan tepat bergantung pada versi dan konfigurasi ServBay. Untuk memastikan versi berkenaan dapat digunakan, pastikan versi yang diperlukan dipasang melalui aplikasi ServBay terlebih dahulu.

S: Perlukah saya mulakan semula ServBay selepas mengubah fail .servbay.config?

J: Biasanya, selepas mengubah fail .servbay.config, anda hanya perlu muat semula atau berhenti dan hidupkan semula laman web yang terlibat di dalam aplikasi ServBay, tanpa perlu restart aplikasi tersebut sepenuhnya.

S: Adakah konfigurasi dalam .servbay.config akan mempengaruhi projek lain saya?

J: Tidak. Fail .servbay.config khusus untuk satu projek ServBay sahaja dan hanya sah dalam folder laman web tersebut.

Rumusan

Dengan fail .servbay.config, ServBay memberikan kebebasan mutlak kepada pembangun untuk mengurus persekitaran pada peringkat projek. Sama ada anda menyelenggara projek lama yang memerlukan versi persekitaran lama, atau membangunkan projek baharu dengan teknologi terkini, konfigurasi mudah menggunakan fail ini membolehkan penukaran dan pengasingan persekitaran yang pantas. Ini sangat meningkatkan kelenturan dan kecekapan aliran kerja pembangunan anda. Manfaatkan fungsi ini kemaksimum mungkin untuk pengalaman pembangunan yang lebih lancar!