Lokasi & Pengurusan Fail Konfigurasi ServBay

Sebagai persekitaran pembangunan web tempatan yang berkuasa, teras ServBay adalah keupayaan konfigurasi fleksibel untuk pelbagai pakej perisian (seperti pelayan web, pangkalan data, persekitaran bahasa dan lain-lain). Bagi memudahkan pengurusan dan mengekalkan kestabilan, semua fail konfigurasi pakej ServBay disusun di lokasi terpusat dengan struktur direktori yang jelas. Dokumen ini akan menerangkan secara terperinci lokasi fail konfigurasi ServBay dan panduan bagaimana untuk mencari serta melihat fail penting ini.

Amaran Penting: Jangan Ubah Fail Konfigurasi Secara Manual

Fail konfigurasi ServBay dijana secara automatik oleh aplikasi berdasarkan tetapan anda (melalui antaramuka UI). Sila elakkan mengedit secara terus fail konfigurasi di bawah /Applications/ServBay/etc atau mana-mana direktori ServBay lain.

Ubah suai manual pada fail konfigurasi berisiko menyebabkan perubahan anda hilang apabila berlaku kemas kini, servis dimulakan semula, atau anda membuat perubahan lain melalui UI – serta boleh mencetuskan ralat yang tidak dijangka.

Segala perubahan konfigurasi wajib dibuat melalui antaramuka pengguna grafik (UI) yang disediakan oleh ServBay atau alat baris perintah rasmi untuk menjamin perubahan kekal & sistem stabil. Tujuan dokumen ini hanyalah untuk membantu anda memahami struktur dalaman ServBay atau ketika ingin melakukan diagnostik.

Gambaran Umum Struktur Direktori

Fail konfigurasi utama ServBay terletak dalam beberapa direktori teras, diklasifikasikan mengikut nama dan versi pakej:

• /Applications/ServBay/etc: Ini adalah direktori utama untuk fail konfigurasi ServBay, merangkumi kebanyakan pelayan web (seperti Nginx, Caddy, Apache), persekitaran bahasa (misalnya, php.ini untuk PHP), pangkalan data (seperti petikan konfigurasi MySQL, MariaDB) dan servis lain (seperti Redis, Memcached).
• /Applications/ServBay/db: Direktori ini menempatkan fail data berkaitan pangkalan data dan juga beberapa fail konfigurasi khusus seperti fail kawalan akses PostgreSQL.
• /Applications/ServBay/package/common: Beberapa pakej biasa, misalnya OpenSSL, menyimpan fail konfigurasi dalam direktor ini.

Lokasi Fail Konfigurasi Bagi Pakej Perisian

Berikut adalah contoh lokasi fail konfigurasi bagi beberapa pakej utama dalam ServBay:

Pelayan Web (Web Servers)

Fail konfigurasi pelayan web lazimnya disusun di bawah /Applications/ServBay/etc dalam subdirektori mengikut nama. ServBay menyokong pelbagai versi serentak, jadi fail konfigurasi juga akan dikategorikan berdasarkan versinya.

• Nginx: Direktori utama konfigurasi: /Applications/ServBay/etc/nginx Contoh laluan fail bagi Nginx versi 1.25:

  /Applications/ServBay/etc/nginx/1.25/nginx.conf

  Fail konfigurasi berkaitan — seperti konfigurasi laman web, SSL, dsb. — juga akan ditempatkan di direktori ini atau subdirektorinya.

• Caddy: Direktori utama konfigurasi: /Applications/ServBay/etc/caddy Fail konfigurasi utama:

  /Applications/ServBay/etc/caddy/Caddyfile

• Apache: Direktori utama konfigurasi: /Applications/ServBay/etc/apache Contoh laluan fail untuk Apache versi 2.4:

  /Applications/ServBay/etc/apache/2.4/httpd.conf

  Konfigurasi maya hos biasanya disusun di subdirektori extra.

Persekitaran Bahasa (Language Runtimes)

Semua konfigurasi untuk bahasa seperti PHP, Python, Node.js, Go, Java dan lain-lain biasanya ditempatkan di bawah /Applications/ServBay/etc, dan diklasifikasikan berdasarkan nama & versi bahasa.

• PHP: Direktori utama konfigurasi: /Applications/ServBay/etc/php Contoh laluan fail untuk php.ini bagi PHP versi 8.2:

  /Applications/ServBay/etc/php/8.2/php.ini

  Fail konfigurasi PHP-FPM juga berada dalam direktori versi yang sama.

• Python: Konfigurasi Python biasanya dikendalikan menerusi pemboleh ubah persekitaran atau fail dalaman projek. Bagi Python yang disertakan dalam ServBay, fail boleh laksana utama berada di /Applications/ServBay/package/python/{version}/bin, manakala konfigurasi global tidak diletakkan di /etc ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET: Sama seperti Python, konfigurasi untuk bahasa-bahasa ini bergantung kepada projek, pemboleh ubah persekitaran atau amalan dalam alat mereka sendiri. ServBay hanya membekalkan persekitaran larian/SDK, dan tiada konfigurasi global dikendali secara terpusat di /Applications/ServBay/etc.

Pangkalan Data (Databases)

Fail konfigurasi bagi pangkalan data wujud di kedua-dua direktori /Applications/ServBay/etc dan /Applications/ServBay/db.

• MySQL / MariaDB: Direktori utama konfigurasi: /Applications/ServBay/etc/mysql (atau /Applications/ServBay/etc/mariadb) Contoh laluan fail bagi MySQL versi 8.0:

  /Applications/ServBay/etc/mysql/8.0/my.cnf

  Fail ini memuatkan tetapan utama untuk pangkalan data.

• PostgreSQL: Fail konfigurasi utama PostgreSQL terletak di /Applications/ServBay/etc/postgresql mengikut versi. Contoh laluan untuk PostgreSQL 16:

  /Applications/ServBay/etc/postgresql/16/postgresql.conf

  Konfigurasi berkaitan pengesahan klien seperti pg_hba.conf & pg_ident.conf pula ditempatkan di /Applications/ServBay/db/postgresql mengikut versi:

  /Applications/ServBay/db/postgresql/16/pg_hba.conf
  /Applications/ServBay/db/postgresql/16/pg_ident.conf

• MongoDB, Redis: Fail konfigurasi untuk pangkalan data ini biasanya didapati di bawah /Applications/ServBay/etc dengan klasifikasi mengikut nama & versi. Contoh laluan fail untuk Redis:

  /Applications/ServBay/etc/redis/redis.conf

Servis Lain & Pakej Umum

• OpenSSL: Fail konfigurasi OpenSSL terletak di /Applications/ServBay/package/common/openssl mengikut versi. Contoh untuk versi 3.2:

  /Applications/ServBay/package/common/openssl/3.2/openssl.cnf

• ACME (Untuk Pendaftaran Sijil SSL Secara Automatik): Fail konfigurasi & storan sijil ACME biasanya ditempatkan di /Applications/ServBay/etc/acme atau /Applications/ServBay/db/acme.

Cara Mencari & Melihat Kandungan Fail Konfigurasi

Walaupun ubah suai manual tidak digalakkan, anda mungkin perlu melihat kandungan fail konfigurasi sama ada untuk memahami tetapan semasa atau bagi penyelesaian masalah. Anda boleh ikuti langkah berikut:

1. Navigasi ke Direktori Fail Konfigurasi: Guna alat baris perintah terminal (seperti Terminal, iTerm2 dsb.) untuk masuk ke direktori berkenaan. Sebagai contoh, untuk melihat direktori konfigurasi Nginx:

   cd /Applications/ServBay/etc/nginx/

   Untuk melihat direktori bagi pg_hba.conf PostgreSQL 16:

   cd /Applications/ServBay/db/postgresql/16

2. Senaraikan Fail: Guna arahan ls untuk memaparkan senarai fail dalam direktori:

   ls

3. Lihat Kandungan Fail: Guna alat pemerhati atau penyunting teks (seperti cat, less, more, atau editor seperti vim, nano - hanya untuk melihat, jangan simpan sebarang perubahan) untuk membuka dan menyemak kandungan fail konfigurasi. Contohnya, untuk lihat nginx.conf bagi Nginx:

   cat nginx.conf
   # Atau gunakan less untuk melihat dengan skrin berperingkat
   less nginx.conf

   Untuk melihat fail php.ini bagi PHP 8.2:

   less /Applications/ServBay/etc/php/8.2/php.ini

4. Mula Semula Servis (Jika Tukar Konfigurasi Melalui UI ServBay): Sebarang perubahan konfigurasi melalui UI ServBay memerlukan anda memulakan semula servis berkaitan supaya perubahan berkuat kuasa. Anda boleh lakukan ini melalui panel pengurusan ServBay atau dengan arahan baris perintah servbayctl. Contoh:

   servbayctl restart nginx -all

   Mulakan semula servis PHP 8.2:

   servbayctl restart php 8.2

   Mulakan semula semua servis:

   servbayctl restart all

Soalan Lazim (FAQ)

• S: Bolehkah saya ubah fail konfigurasi secara manual untuk ujian tetapan lanjutan?

  J: Sangat tidak digalakkan. Pilihan konfigurasi lazim boleh dibuat terus melalui UI ServBay. Untuk penyesuaian mendalam yang tidak disokong, sila rujuk dokumen konfigurasi lanjutan ServBay atau dapatkan bantuan komuniti. Segala ubah suai manual berisiko tinggi akan dipadamkan.

• S: Bagaimana ServBay menguruskan fail konfigurasi bagi pelbagai versi pakej?

  J: Seperti yang diterangkan, ServBay membina subdirektori berasingan dalam /Applications/ServBay/etc atau /Applications/ServBay/db untuk setiap versi bagi setiap pakej, menjamin konfigurasi antara versi tidak bercampur.

• S: Apa yang perlu dilakukan jika saya terpadam atau rosakkan fail konfigurasi secara tidak sengaja?

  J: ServBay biasanya boleh menjana semula fail konfigurasi dari templat dalaman berdasarkan tetapan anda. Anda cuma perlu buat sedikit perubahan pada tetapan pakej melalui UI, dan fail baharu akan dijana. Jika masalah serius berlaku, cuba set semula konfigurasi pakej atau hubungi sokongan ServBay.

Rumusan

ServBay mengurus fail konfigurasi secara terpusat dan bersistem, terutamanya melalui direktori /Applications/ServBay/etc, serta disokong /Applications/ServBay/db dan /Applications/ServBay/package/common. Struktur ini memudahkan automasi oleh ServBay dan pencarian oleh pembangun.

Fahami lokasi fail-fail ini amat membantu untuk mengetahui cara kerja dalaman ServBay dan ketika menyelesaikan masalah. Sekali lagi ditekankan: buat sebarang perubahan konfigurasi hanya melalui antaramuka rasmi atau alat ServBay. Elakkan ubah fail secara manual demi kestabilan dan kebolehpercayaan persekitaran ServBay anda.