Dokumentasi ServBay: Pengurusan Pangkalan Data dengan Adminer

Pengenalan

ServBay adalah persekitaran pembangunan web lokal yang hebat untuk macOS dan Windows, menyatukan pelbagai pelayan web, runtime bahasa pengaturcaraan dan sistem pangkalan data. Untuk memudahkan pengurusan pangkalan data terbina dalam, ServBay telah pratetap dan mengkonfigurasi Adminer, satu alat pengurusan pangkalan data yang mantap dan ringan. Dokumentasi ini memberi panduan tentang cara menggunakan Adminer untuk sambung dan urus pangkalan data yang tersedia dalam ServBay.

Apa Itu Adminer

Adminer ialah alat pengurusan pangkalan data yang ditulis menggunakan PHP dalam satu fail tunggal dan menyokong pelbagai sistem pangkalan data termasuk MySQL, MariaDB, PostgreSQL, SQLite, MongoDB dan lain-lain. Dibandingkan dengan pelanggan pengurusan pangkalan data yang lebih besar, Adminer menawarkan kelebihan utama berikut:

1. Ringan & Mudah Dipasang: Adminer hanya terdiri daripada satu fail PHP, tidak memerlukan proses pemasangan yang rumit dan mudah digunakan. ServBay telah pun mengintegrasikan Adminer, sedia untuk digunakan secara serta-merta.
2. Sokongan Pelbagai Pangkalan Data: Dengan satu antaramuka, anda boleh sambung dan urus pelbagai jenis pangkalan data, tanpa perlu memasang atau mempelajari banyak alat berlainan.
3. Antaramuka yang Kemas & Mesra Pengguna: Paparan yang jelas dan mudah digunakan membolehkan walaupun pengguna baru boleh mula mengurus pangkalan data dengan cepat.
4. Fungsi Lengkap: Menyokong hampir semua operasi asas pangkalan data seperti cipta, ubah, buang pangkalan data, jadual, indeks, pengguna, jalankan arahan SQL, import/eksport data dan sebagainya.

Bagi pembangun yang menggunakan ServBay untuk pembangunan lokal, Adminer menawarkan kaedah pengurusan pangkalan data yang cekap dan mudah.

Akses ke Adminer

Selepas ServBay dimulakan, Adminer akan berjalan secara automatik dan boleh diakses melalui pelayan web terbina dalam. Anda boleh mencapai Adminer dengan melayari nama domain lokal ServBay diikuti dengan nama fail Adminer:

https://servbay.host/adminer.php

Pastikan aplikasi ServBay sedang berjalan serta pelayan web berkaitan (seperti Caddy atau Nginx) dan servis pangkalan data yang anda mahu sambungkan telah dimulakan.

Menyambung ke Pangkalan Data dalam ServBay

Antaramuka log masuk Adminer sangat intuitif. Anda perlu memilih jenis pangkalan data dan masukkan alamat server, nama pengguna, kata laluan dan (untuk sesetengah jenis) nama pangkalan data. ServBay menjana nama pengguna dan kata laluan lalai untuk pangkalan data terbina dalam; maklumat ini boleh didapati di tab 'Database' dalam aplikasi ServBay.

Menyambung ke MariaDB / MySQL

ServBay biasanya menyediakan MariaDB atau MySQL secara lalai. Dalam Adminer, pilih jenis "MySQL" untuk sambung.

1. Buka pelayar anda dan layari URL Adminer (https://servbay.host/adminer.php).
2. Di halaman log masuk, pada menu System, pilih MySQL.
3. Isikan maklumat sambungan server:
   • Server: Masukkan localhost atau gunakan laluan Unix Socket dari ServBay /Applications/ServBay/tmp/mysql.sock. Sambungan melalui socket lazimnya lebih pantas.
   • Nama Pengguna: Semak tab 'Database' dalam aplikasi ServBay untuk nama pengguna MariaDB/MySQL.
   • Kata Laluan: Semak tab 'Database' dalam aplikasi ServBay untuk kata laluan MariaDB/MySQL.
   • Database: (Opsyenal) Jika anda mahu sambung ke pangkalan data tertentu, masukkan namanya di sini. Jika dibiarkan kosong, anda akan sambung ke server dan boleh urus semua pangkalan data selepas log masuk.
4. Klik butang Log Masuk.

Menyambung ke PostgreSQL

ServBay juga menyokong PostgreSQL. Dalam Adminer, anda perlu pilih jenis "PostgreSQL".

1. Buka pelayar anda dan layari URL Adminer (https://servbay.host/adminer.php).
2. Di halaman log masuk, pada menu System, pilih PostgreSQL.
3. Isikan maklumat sambungan server:
   • Server: Masukkan /Applications/ServBay/tmp.
   • Nama Pengguna: Semak tab 'Database' dalam aplikasi ServBay untuk nama pengguna PostgreSQL.
   • Kata Laluan: Semak tab 'Database' dalam aplikasi ServBay untuk kata laluan PostgreSQL.
   • Database: Masukkan nama pangkalan data yang ingin disambungkan, contohnya postgres sebagai pangkalan data lalai, atau mana-mana pangkalan data yang anda cipta.
4. Klik butang Log Masuk.

Menyambung ke SQLite 3

ServBay menyokong pangkalan data SQLite 3. SQLite ialah pangkalan data berasaskan fail, jadi anda perlu tentukan laluan fail pangkalan data semasa menyambung.

1. Buka pelayar anda dan layari URL Adminer (https://servbay.host/adminer.php).
2. Di halaman log masuk, pada menu System, pilih SQLite 3.
3. Masukkan laluan fail pangkalan data:
   • Fail Database: Masukkan laluan penuh kepada fail pangkalan data SQLite anda. Disaran simpan fail SQLite anda di direktori data ServBay, contohnya /Applications/ServBay/db/sqlite/nama_database.sqlite.
   • Jika laluan fail yang dimasukkan belum wujud, Adminer akan meminta kebenaran untuk cipta fail pangkalan data baru.
4. Klik butang Log Masuk.

Melakukan Operasi Pangkalan Data Lazim

Sebaik sahaja berjaya log masuk ke server pangkalan data atau pangkalan data tertentu, anda boleh gunakan antara muka Adminer untuk pelbagai tugas pengurusan. Jenis antara muka dan fungsi mungkin sedikit berbeza antara pangkalan data, tetapi operasi asas adalah serupa.

Cipta Pangkalan Data

(untuk MariaDB/MySQL, PostgreSQL)

1. Log masuk ke server pangkalan data (tanpa spesifik database).
2. Cari pilihan Cipta Database pada bar navigasi kiri atau di muka utama.
3. Masukkan nama pangkalan data baru.
4. Pilih set aksara dan aturan sortasi (jika perlu).
5. Klik butang Simpan atau Cipta.

(Untuk SQLite 3, penciptaan pangkalan data berlaku semasa log masuk dengan memberikan laluan fail yang belum wujud.)

Urus Jadual dan Data

1. Pilih pangkalan data (jika tidak dipilih semasa log masuk).
2. Di paparan gambaran database, cari pilihan Cipta Table.
3. Masukkan nama jadual dan tentukan medan-medan (kolum), termasuk nama medan, jenis data, panjang, membenarkan NULL atau tidak, nilai lalai, indeks (primary key, unik, biasa) dan lain-lain.
4. Klik Simpan untuk cipta jadual.
5. Selepas jadual tercipta, pilih jadual tersebut dari bar navigasi atau paparan utama.
6. Lakukan operasi data:
   • Insert: Tambah baris data baru.
   • Select: Lihat, cari, susun dan tapis data sedia ada.
   • Update: Edit baris data sedia ada.
   • Delete: Buang baris data sedia ada.
   • Gunakan SQL Command untuk kueri dan operasi yang lebih kompleks.

Jalankan Arahan SQL

Adminer menyedia ruang input SQL khas di mana anda boleh masukkan dan jalankan perintah SQL secara langsung untuk pengurusan atau kueri yang lebih fleksibel.

1. Pilih pangkalan data yang anda ingin gunakan.
2. Klik pilihan SQL Command.
3. Masukkan arahan SQL anda di kawasan teks yang disediakan.
4. Klik Run untuk jalankan.

Import dan Eksport Data

Adminer menyokong eksport struktur dan data pangkalan data ke fail SQL atau format lain (seperti CSV), serta import data dari fail berkenaan. Fungsi ini sangat berguna untuk migrasi data, backup atau perkongsian.

1. Pilih pangkalan data atau jadual untuk import/eksport.
2. Cari pilihan Export atau Import.
3. Ikut arahan di antara muka untuk pilih format dan opsyen, kemudian laksanakan operasi.

Padam Pangkalan Data

(untuk MariaDB/MySQL, PostgreSQL)

1. Log masuk ke server pangkalan data (tanpa spesifik database).
2. Pilih pangkalan data yang ingin dipadam dari senarai.
3. Klik pilihan Padam dan sahkan tindakan. Perhatian: Operasi ini tidak boleh dihentikan semula dan akan memadam semua data dalam pangkalan data tersebut secara kekal.

(Untuk SQLite 3, memadam pangkalan data bermaksud memadam fail .sqlite berkaitan secara manual dalam sistem fail.)

Perkara Yang Perlu Diperhatikan

• Keselamatan Kredential: Jaga username dan kata laluan yang diperoleh dari tetapan ServBay; jangan dedahkan kepada pihak tidak bertanggungjawab.
• Status ServBay: Adminer diakses melalui pelayan web ServBay dan perlukan servis pangkalan data untuk berjalan agar boleh disambung. Jika gagal akses Adminer atau pangkalan data, pastikan aplikasi ServBay dan semua pakej berkaitan (Caddy/Nginx, MariaDB/MySQL, PostgreSQL dll.) sudah dimulakan.
• Laluan Fail SQLite: Pastikan fail pangkalan data SQLite disimpan di tempat yang ServBay mempunyai hak akses (baca/tulis), sebaiknya direktori /Applications/ServBay/db/sqlite/.
• Prestasi: Adminer ialah alat yang ringan; untuk pengurusan pangkalan data yang sangat besar atau operasi kompleks, gunakan alat desktop khusus seperti TablePlus, DBeaver, pgAdmin dan lain-lain yang mungkin menawarkan keupayaan atau prestasi lebih tinggi.

Soalan Lazim (FAQ)

S: Saya tidak dapat akses https://servbay.host/adminer.php, apa perlu buat?

J: Pastikan aplikasi ServBay sedang berjalan dan pelayan web ServBay (biasanya Caddy atau Nginx) telah dimulakan. Semak juga sama ada pelayar anda membenarkan capaian ke https://servbay.host.

S: Saya lupa username atau kata laluan pangkalan data, di mana boleh dapatkan?

J: Anda boleh mendapatkannya di tab 'Database' dalam antaramuka aplikasi ServBay, yang memaparkan nama pengguna dan kata laluan lalai bagi setiap pangkalan data yang disediakan.

S: Apakah alamat server dan port untuk sambungan PostgreSQL?

J: Biasanya alamat server ialah localhost dan port lalai ialah 5432. Anda boleh semak konfigurasi di tetapan ServBay. Jika gunakan sambungan Unix Domain Socket, masukkan /Applications/ServBay/tmp (Nota: PostgreSQL tidak perlukan .sock di hujung).

S: Apakah perbezaan antara alamat server dan laluan socket untuk MariaDB/MySQL?

J: localhost akan menggunakan sambungan TCP/IP (port lalai 3306), manakala /Applications/ServBay/tmp/mysql.sock gunakan Unix Domain Socket. Dalam persekitaran lokal, sambungan socket biasanya lebih pantas dan selamat. Pilih kaedah yang sesuai dengan keperluan anda.

S: Bolehkah saya urus pangkalan data lain yang tidak tersedia dalam ServBay menggunakan Adminer?

J: Adminer menyokong pelbagai jenis pangkalan data. Jika anda pasang pangkalan data lain di luar ServBay (seperti MongoDB sendiri atau pangkalan data luar), secara teori anda boleh gunakan fail Adminer dalam ServBay untuk sambung, selagi rangkaian boleh dicapai dan maklumat sambungan betul. Namun kelebihan utama Adminer di ServBay ialah untuk pengurusan pangkalan data terbina dalam.

Rumusan

Adminer, sebagai alat pengurusan pangkalan data yang disediakan oleh ServBay, amat memudahkan tugas pentadbiran MariaDB/MySQL, PostgreSQL dan SQLite di persekitaran pembangunan lokal melalui keupayaan satu fail, ringan dan sokongan pelbagai jenis pangkalan data. Dengan panduan dokumentasi ini, anda boleh dengan mudah menyambung ke pangkalan data ServBay dan gunakan Adminer untuk tugasan pengurusan serta operasi data harian anda.