Lokasi & Pengurusan Fail Konfigurasi ServBay

ServBay ialah persekitaran pembangunan web tempatan yang cukup berkuasa, menawarkan fleksibiliti dalam mengkonfigurasi pelbagai pakej seperti pelayan web, pangkalan data dan persekitaran bahasa pengaturcaraan. Demi kemudahan pengurusan dan kestabilan sistem, ServBay mengumpulkan semua fail konfigurasi mengikut struktur direktori yang jelas. Artikel ini menerangkan dengan terperinci lokasi fail konfigurasi ServBay dan cara pembangun mencari serta melihat fail penting ini.

DANGER

Peringatan Penting: Jangan ubah fail konfigurasi secara manual

Fail konfigurasi ServBay dihasilkan secara automatik oleh aplikasi berdasarkan tetapan anda (melalui antaramuka UI). Jangan sesekali mengedit fail konfigurasi secara manual di direktori konfigurasi ServBay.

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Jika fail diubah manual, perubahan tersebut mungkin akan hilang atau menyebabkan error tidak dijangka apabila ServBay dikemas kini, servis diulang mula, atau konfigurasi diubah melalui UI.

Lakukan semua perubahan konfigurasi hanya melalui antaramuka grafik ServBay (UI) atau alat baris perintah rasmi untuk memastikan perubahan kekal dan kestabilan sistem terjamin. Maklumat laluan fail di sini bertujuan sebagai rujukan untuk pemahaman struktur dalaman atau penjejakkan masalah sahaja.

Ringkasan Struktur Direktori

Fail konfigurasi ServBay tertumpu pada beberapa direktori teras utama, dikategorikan mengikut nama dan versi pakej.

Direktori konfigurasi utama:

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Ini ialah lokasi utama untuk fail konfigurasi kebanyakan pelayan web (Nginx, Caddy, Apache), persekitaran bahasa (seperti php.ini untuk PHP), pangkalan data (MySQL, MariaDB) serta servis lain (Redis, Memcached).

Direktori pangkalan data:

• macOS: /Applications/ServBay/db
• Windows: C:\ServBay\db

Direktori ini menempatkan fail data pangkalan data serta beberapa fail konfigurasi spesifik contohnya fail kawalan akses PostgreSQL.

Direktori pakej umum:

• macOS: /Applications/ServBay/package/common
• Windows: C:\ServBay\package\common

Di sini tersimpan pakej umum seperti OpenSSL beserta fail konfigurasi berkaitan.

Lokasi Fail Konfigurasi Pakej

Berikut adalah contoh lokasi fail konfigurasi beberapa pakej utama ServBay:

Pelayan Web (Web Servers)

Fail konfigurasi pelayan web biasanya berada di direktori utama konfigurasi ServBay, dengan subdirektori mengikut nama pakej dan versi masing-masing.

• Nginx: Direktori konfigurasi utama:

  • macOS: /Applications/ServBay/etc/nginx
  • Windows: C:\ServBay\etc\nginx

  Contoh laluan fail konfigurasi untuk Nginx versi 1.25:

  • macOS: /Applications/ServBay/etc/nginx/1.25/nginx.conf
  • Windows: C:\ServBay\etc\nginx\1.25\nginx.conf

  Fail berkaitan (config laman web, SSL) juga disusun di dalam atau bawah direktori ini.

• Caddy: Direktori konfigurasi utama:

  • macOS: /Applications/ServBay/etc/caddy
  • Windows: C:\ServBay\etc\caddy

  Fail konfigurasi utama Caddy:

  • macOS: /Applications/ServBay/etc/caddy/Caddyfile
  • Windows: C:\ServBay\etc\caddy\Caddyfile

• Apache: Direktori konfigurasi utama:

  • macOS: /Applications/ServBay/etc/apache
  • Windows: C:\ServBay\etc\apache

  Contoh laluan konfigurasi untuk Apache versi 2.4:

  • macOS: /Applications/ServBay/etc/apache/2.4/httpd.conf
  • Windows: C:\ServBay\etc\apache\2.4\httpd.conf

  Konfigurasi virtual host, dsb. biasanya dalam subdirektori extra.

Persekitaran Bahasa (Language Runtimes)

Konfigurasi untuk pelbagai bahasa seperti PHP, Python, Node.js, Go dan Java juga berada di direktori utama, dikategorikan nama bahasa dan versi.

• PHP: Direktori konfigurasi utama:

  • macOS: /Applications/ServBay/etc/php
  • Windows: C:\ServBay\etc\php

  Contoh laluan untuk PHP versi 8.2:

  • macOS: /Applications/ServBay/etc/php/8.2/php.ini
  • Windows: C:\ServBay\etc\php\8.2\php.ini

  Fail konfigurasi PHP-FPM juga diletakkan dalam direktori versi tersebut.

• Python: Konfigurasi Python biasanya dikendalikan melalui pembolehubah persekitaran atau fail dalam projek. Python yang disediakan oleh ServBay boleh dijumpai di:

  • macOS: /Applications/ServBay/package/python/{version}/bin
  • Windows: C:\ServBay\package\python\{version}\bin

  Konfigurasi global jarang melalui direktori utama ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET: Seperti Python, bahasa ini lebih bergantung kepada fail projek atau pembolehubah persekitaran. ServBay menyediakan runtime/SDK; fail konfigurasi global tidak dikumpulkan di direktori utama.

Pangkalan Data (Databases)

Fail konfigurasi pangkalan data bertaburan di direktori utama dan direktori data ServBay.

• MySQL / MariaDB: Direktori konfigurasi utama:

  • macOS: /Applications/ServBay/etc/mysql (atau /Applications/ServBay/etc/mariadb)
  • Windows: C:\ServBay\etc\mysql (atau C:\ServBay\etc\mariadb)

  Contoh laluan untuk fail konfigurasi MySQL versi 8.0:

  • macOS: /Applications/ServBay/etc/mysql/8.0/my.cnf
  • Windows: C:\ServBay\etc\mysql\8.0\my.cnf

  Fail ini merangkumi parameter utama konfigurasi pangkalan data.

• PostgreSQL: Fail konfigurasi utama mengikut versi berada di:

  • macOS: /Applications/ServBay/etc/postgresql
  • Windows: C:\ServBay\etc\postgresql

  Contoh untuk PostgreSQL versi 16:

  • macOS: /Applications/ServBay/etc/postgresql/16/postgresql.conf
  • Windows: C:\ServBay\etc\postgresql\16\postgresql.conf

  Fail konfigurasi autentikasi pelanggan seperti pg_hba.conf dan pg_ident.conf berada di direktori pangkalan data, juga mengikut versi:

  • macOS: /Applications/ServBay/db/postgresql/16/pg_hba.conf
  • macOS: /Applications/ServBay/db/postgresql/16/pg_ident.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_hba.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_ident.conf

• MongoDB, Redis: Konfigurasi pangkalan data ini biasanya dalam direktori utama mengikut nama dan versi:

  • macOS: /Applications/ServBay/etc
  • Windows: C:\ServBay\etc

  Contoh laluan konfigurasi untuk Redis:

  • macOS: /Applications/ServBay/etc/redis/redis.conf
  • Windows: C:\ServBay\etc\redis\redis.conf

Servis Lain & Pakej Umum

• OpenSSL: Fail konfigurasi berada di direktori pakej umum, mengikut versi:

  • macOS: /Applications/ServBay/package/common/openssl
  • Windows: C:\ServBay\package\common\openssl

  Contoh untuk OpenSSL versi 3.2:

  • macOS: /Applications/ServBay/package/common/openssl/3.2/openssl.cnf
  • Windows: C:\ServBay\package\common\openssl\3.2\openssl.cnf

• ACME (untuk permohonan automatik SSL): Konfigurasi dan simpanan sijil ACME biasanya terdapat di:

  • macOS: /Applications/ServBay/etc/acme atau /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme atau C:\ServBay\db\acme

Cara Mencari & Melihat Kandungan Fail Konfigurasi

Walaupun pengeditan manual tidak digalakkan, pembangun kadang-kadang perlu melihat konfigurasi untuk diagnosis atau pemahaman tetapan semasa. Berikut ialah langkah untuk mencari dan melihat fail tersebut:

1. Navigasi ke direktori fail konfigurasi: Gunakan baris perintah untuk mengakses direktori yang diingini.

   macOS (gunakan Terminal, iTerm2 dsb):

   # Lihat direktori konfigurasi Nginx
   cd /Applications/ServBay/etc/nginx/
   
   # Lihat direktori pg_hba.conf PostgreSQL 16
   cd /Applications/ServBay/db/postgresql/16

   Windows (gunakan PowerShell atau Command Prompt):

   # Lihat direktori konfigurasi Nginx
   cd C:\ServBay\etc\nginx\
   
   # Lihat direktori pg_hba.conf PostgreSQL 16
   cd C:\ServBay\db\postgresql\16

2. Senaraikan fail: Lihat senarai kandungan direktori.

   macOS:

   ls

   Windows:

   # PowerShell
   Get-ChildItem
   # atau ringkas
   ls
   
   # Command Prompt
   dir

3. Lihat kandungan fail: Guna penampil teks atau editor (sekadar untuk melihat, jangan simpan-ubah).

   macOS:

   # Lihat fail nginx.conf Nginx
   cat nginx.conf
   # atau lihat secara berhalaman
   less nginx.conf
   
   # Lihat fail php.ini PHP 8.2
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows:

   # PowerShell - lihat fail nginx.conf Nginx
   Get-Content nginx.conf
   # atau paparan berhalaman
   more nginx.conf
   
   # Lihat fail php.ini PHP 8.2
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # Command Prompt
   type nginx.conf
   more nginx.conf

4. Ulang mula servis (Jika telah lakukan perubahan melalui UI ServBay): Selepas mengubah konfigurasi menggunakan UI ServBay, anda biasanya perlu ulang mula servis untuk kemaskini tetapan. Guna antaramuka ServBay atau servbayctl untuk tujuan ini.

   macOS:

   # Ulang mula servis Nginx
   servbayctl restart nginx -all
   
   # Ulang mula servis PHP 8.2
   servbayctl restart php 8.2
   
   # Ulang mula semua servis
   servbayctl restart all

   Windows:

   # Ulang mula servis Nginx
   servbayctl.exe restart nginx -all
   
   # Ulang mula servis PHP 8.2
   servbayctl.exe restart php 8.2
   
   # Ulang mula semua servis
   servbayctl.exe restart all

Soalan Lazim (FAQ)

• Soalan: Bolehkah saya ubah fail konfigurasi secara manual untuk ujian advanced?

  Jawapan: Sangat tidak digalakkan! ServBay UI menawarkan hampir semua tetapan lazim. Untuk keperluan lanjutan yang tiada di UI, rujuk dokumentasi konfigurasi lanjutan atau komuniti ServBay. Fail yang diubah manual mudah ditulis semula oleh sistem.

• Soalan: Bagaimana ServBay urus fail konfigurasi banyak versi?

  Jawapan: Seperti diterangkan, ServBay mewujudkan subdirektori berasingan untuk setiap versi pakej dalam direktori konfigurasi (/Applications/ServBay/etc atau /Applications/ServBay/db bagi macOS; C:\ServBay\etc atau C:\ServBay\db bagi Windows), memastikan setiap versi terasing dari segi konfigurasi.

• Soalan: Apa yang harus saya lakukan jika fail konfigurasi terpadam atau rosak?

  Jawapan: ServBay menjana semula fail dari template mengikut tetapan anda. Biasanya, anda cuma perlu buat perubahan kecil konfigurasi melalui UI, dan fail akan digenerate semula. Untuk kes kritikal, cuba reset konfigurasi atau hubungi sokongan ServBay.

Rumusan

ServBay menggunakan pengurusan fail konfigurasi yang berpusat dan berstruktur, di mana:

• macOS: Utama di /Applications/ServBay/etc; tambahan di /Applications/ServBay/db & /Applications/ServBay/package/common
• Windows: Utama di C:\ServBay\etc; tambahan di C:\ServBay\db & C:\ServBay\package\common

Reka bentuk struktur ini membolehkan ServBay mengurus konfigurasi secara automatik pada platform berbeza dan memudahkan pembangun menjejak serta menyelesaikan masalah.

Memahami lokasi fail ini sangat penting untuk mendalami cara kerja ServBay dan membuat penyelesaian masalah. Sekali lagi ditekankan, lakukan semua perubahan konfigurasi hanya melalui antaramuka rasmi atau alat ServBay – jangan ubah fail secara manual – demi kestabilan dan kebolehpercayaan persekitaran ServBay anda.