Dokumentasi ServBay: Mengurus Pangkalan Data dengan Adminer

Pengenalan

ServBay ialah persekitaran pembangunan web tempatan yang berkuasa untuk macOS, lengkap dengan pelbagai pelayan web, runtime bahasa pengaturcaraan, dan sistem pangkalan data. Bagi memudahkan pembangun mengurus pangkalan data terbina dalam ini, ServBay telah siap dipasang dan dikonfigurasi dengan Adminer, alat pengurusan pangkalan data yang ringan namun berkuasa. Dokumen ini menerangkan cara menggunakan Adminer untuk menyambung dan mengurus pangkalan data yang disertakan dalam ServBay.

Apa itu Adminer

Adminer adalah alat pengurusan pangkalan data satu fail yang dibangunkan menggunakan PHP. Ia menyokong pelbagai sistem pangkalan data, termasuk MySQL, MariaDB, PostgreSQL, SQLite, MongoDB, dan lain-lain. Berbanding dengan perisian pengurusan pangkalan data yang lebih kompleks, Adminer mempunyai kelebihan berikut:

1. Ringan & Penyebaran Satu Fail: Adminer hanya memerlukan satu fail PHP, tidak memerlukan pemasangan rumit dan mudah digunakan. Ia telah disediakan dalam ServBay dan sedia digunakan.
2. Sokongan Pelbagai Pangkalan Data: Dengan satu antaramuka seragam, anda boleh menghubung dan mengurus pelbagai jenis pangkalan data tanpa perlu memasang atau belajar alat berasingan.
3. Antaramuka Pengguna Mesra & Mudah Navigasi: Menyediakan antaramuka yang bersih dan mudah difahami, meskipun untuk pembangun kali pertama.
4. Fungsi Lengkap: Menyokong kebanyakan operasi asas pangkalan data seperti mencipta, mengubah suai, menghapus pangkalan data, jadual, indeks, pengguna, menjalankan pertanyaan SQL, dan import/eksport data.

Untuk pembangun yang menggunakan ServBay secara tempatan, Adminer adalah penyelesaian pengurusan pangkalan data yang mudah dan efisien.

Cara Akses Adminer

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

https://servbay.host/adminer.php

Pastikan aplikasi ServBay sedang berjalan, serta pelayan web berkaitan (seperti Caddy atau Nginx) dan perkhidmatan pangkalan data yang ingin dihubungkan sudah dihidupkan.

Menyambung ke Pangkalan Data dalam ServBay

Antaramuka log masuk Adminer sangat intuitif. Anda perlu memilih jenis pangkalan data dan masukkan alamat pelayan, nama pengguna, kata laluan dan (untuk sesetengah jenis pangkalan data) nama pangkalan data. ServBay akan menjana nama pengguna dan kata laluan lalai untuk pangkalan data terbina dalam, yang boleh didapati di tab "Pangkalan Data" dalam aplikasi ServBay.

Menyambung ke MariaDB / MySQL

ServBay selalunya telah siap dengan MariaDB atau MySQL. Dalam Adminer, pilih jenis "MySQL" untuk menyambung.

1. Buka pelayar web, lawati URL Adminer (https://servbay.host/adminer.php).
2. Pada paparan log masuk, dalam menu tarik turun Sistem, pilih MySQL.
3. Masukkan maklumat sambungan:
   • Pelayan: Masukkan localhost atau gunakan laluan Unix Socket yang disediakan oleh ServBay /Applications/ServBay/tmp/mysql.sock. Sambungan melalui Socket biasanya lebih cekap.
   • Nama Pengguna: Lihat nama pengguna MariaDB/MySQL dalam tab "Pangkalan Data" pada aplikasi ServBay.
   • Kata Laluan: Semak kata laluan MariaDB/MySQL dalam aplikasi ServBay.
   • Pangkalan Data: (Opsyenal) Untuk terus ke suatu pangkalan data, masukkan namanya di sini. Jika dibiarkan kosong, anda boleh akses semua pangkalan data selepas log masuk.
4. Klik butang Log masuk.

Menyambung ke PostgreSQL

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

1. Buka pelayar web dan lawati URL Adminer (https://servbay.host/adminer.php).
2. Pada paparan log masuk, dalam menu Sistem, pilih PostgreSQL.
3. Masukkan maklumat sambungan:
   • Pelayan: Masukkan /Applications/ServBay/tmp.
   • Nama Pengguna: Cari nama pengguna PostgreSQL dalam tab "Pangkalan Data" aplikasi ServBay.
   • Kata Laluan: Cari kata laluan PostgreSQL dalam aplikasi ServBay.
   • Pangkalan Data: Masukkan nama pangkalan data yang ingin dihubungkan, contohnya pangkalan data lalai postgres atau yang anda cipta sendiri.
4. Klik butang Log masuk.

Menyambung ke SQLite 3

ServBay menyokong pangkalan data SQLite 3. SQLite berasaskan fail, jadi anda perlu tentukan laluan fail pangkalan data untuk sambungan.

1. Buka pelayar web dan lawati URL Adminer (https://servbay.host/adminer.php).
2. Pada paparan log masuk, dalam menu Sistem, pilih SQLite 3.
3. Masukkan laluan fail pangkalan data:
   • Fail Pangkalan Data: Masukkan laluan penuh fail pangkalan data SQLite. Disyorkan letakkan fail SQLite anda di direktori data ServBay, misalnya /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Jika laluan fail tidak wujud, Adminer akan bertanya jika anda mahu cipta fail pangkalan data tersebut.
4. Klik butang Log masuk.

Melaksanakan Operasi Pangkalan Data Biasa

Apabila anda berjaya log masuk ke pelayan atau pangkalan data, anda boleh menggunakan antaramuka Adminer untuk pelbagai tugas pengurusan. Fungsi serta layout mungkin sedikit berbeza antara jenis pangkalan data, namun langkah umum adalah sama.

Mencipta Pangkalan Data

(Sesuai untuk MariaDB/MySQL, PostgreSQL)

1. Log masuk ke pelayan pangkalan data (tanpa spesifik pangkalan data).
2. Carian pilihan Cipta pangkalan data atau seumpamanya di navigasi kiri atau halaman utama.
3. Masukkan nama pangkalan data baharu.
4. Pilih set aksara dan peraturan susunan (jika diperlukan).
5. Klik Simpan atau Cipta.

(Untuk SQLite 3, penciptaan berlaku pada masa log masuk dengan menentukan laluan fail baharu.)

Pengurusan Jadual dan Data

1. Pilih pangkalan data (jika tidak ditetapkan pada log masuk).
2. Pada halaman pandangan pangkalan data, cari pilihan Cipta jadual.
3. Masukkan nama jadual dan tentukan medan (lajur) seperti nama medan, jenis data, panjang, kebenaran NULL, lalai, indeks (utama, unik, biasa) dan lain-lain.
4. Klik Simpan untuk cipta jadual.
5. Selepas jadual dicipta, pilih jadual tersebut dari navigasi kiri atau halaman utama.
6. Lakukan operasi ke atas data:
   • Sisip: Tambah baris data baharu.
   • Pilih: Lihat, cari, isih dan tapis data sedia ada.
   • Kemas Kini: Ubah baris data sedia ada.
   • Padam: Hapus baris data sedia ada.
   • Guna Perintah SQL untuk pertanyaan atau operasi lebih kompleks.

Melaksanakan Perintah SQL

Adminer menyediakan kawasan input perintah SQL bagi membolehkan anda menjalankan pertanyaan atau operasi SQL terus bagi pengurusan data yang lebih fleksibel.

1. Pilih pangkalan data yang ingin anda jalankan perintah.
2. Klik pilihan Perintah SQL.
3. Masukkan pernyataan SQL anda dalam ruang teks.
4. Klik butang Laksana.

Import dan Eksport Data

Adminer membolehkan anda eksport struktur dan data pangkalan data dalam format SQL atau lain (seperti CSV), serta import dari fail untuk tujuan migrasi, sandaran atau berkongsi data.

1. Pilih pangkalan data atau jadual yang ingin diimport atau dieksport.
2. Cari pilihan Eksport atau Import.
3. Pilih format dan pilihan berkaitan, kemudian laksanakan operasi mengikut arahan paparan.

Memadam Pangkalan Data

(Boleh digunakan pada MariaDB/MySQL, PostgreSQL)

1. Log masuk ke pelayan pangkalan data (tanpa spesifik pangkalan data).
2. Pilih pangkalan data yang mahu dipadam dari senarai.
3. Klik pilihan Padam dan sahkan tindakan. Amaran: Tindakan ini tidak boleh diundur dan akan menghapuskan semua data secara kekal.

(Untuk SQLite 3, anda perlu memadam fail .sqlite tersebut secara manual melalui sistem fail.)

Perkara Penting

• Keselamatan Maklumat: Pastikan nama pengguna dan kata laluan pangkalan data dari tetapan ServBay disimpan dengan baik dan tidak didedahkan kepada pihak tidak bertanggungjawab.
• Status ServBay: Adminer diakses melalui pelayan web ServBay, dan memerlukan servis pangkalan data berjalan untuk sambungan. Jika tidak boleh akses Adminer atau sambung ke pangkalan data, semak sama ada aplikasi ServBay dan perkhidmatan (Caddy/Nginx, MariaDB/MySQL, PostgreSQL, dsb) berfungsi.
• Laluan Fail SQLite: Pastikan laluan fail pangkalan data SQLite boleh dibaca dan ditulis oleh pengguna ServBay, disyorkan simpan di direktori /Applications/ServBay/db/sqlite/.
• Prestasi: Adminer adalah alat yang ringan. Untuk pangkalan data amat besar atau tugasan pengurusan rumit, klien desktop khas (seperti TablePlus, DBeaver, pgAdmin dan lain-lain) mungkin menawarkan fungsi atau prestasi lebih baik.

Soalan Lazim (FAQ)

S: Saya tidak dapat akses https://servbay.host/adminer.php. Apa perlu saya lakukan?

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

S: Saya lupa nama pengguna atau kata laluan pangkalan data. Di mana boleh saya dapati?

J: Anda boleh menemui nama pengguna dan kata laluan pangkalan data lalai ServBay dalam tab "Pangkalan Data" pada antara muka aplikasi ServBay.

S: Semasa sambung ke PostgreSQL, apakah alamat pelayan dan port?

J: Secara lalai, alamat pelayan ialah localhost dan port ialah 5432. Anda boleh sahkan alamat dan port PostgreSQL dalam tetapan ServBay. Jika sambung guna Unix Domain Socket, masukkan /Applications/ServBay/tmp (Perhatian: PostgreSQL tidak memerlukan akhiran .sock).

S: Apakah perbezaan menggunakan alamat pelayan dan laluan socket semasa sambung ke MariaDB/MySQL?

J: localhost menggunakan sambungan TCP/IP (port lalai: 3306), sedangkan /Applications/ServBay/tmp/mysql.sock menggunakan sambungan Unix Domain Socket. Dalam persekitaran tempatan, sambungan Socket biasanya lebih pantas dan selamat. Anda boleh pilih yang mana sesuai untuk keperluan anda.

S: Bolehkah saya urus pangkalan data lain yang tidak disertakan dalam ServBay melalui Adminer?

J: Adminer menyokong pelbagai jenis pangkalan data. Selagi anda mempunyai akses rangkaian dan maklumat sambungan yang tepat kepada pangkalan data luar (seperti MongoDB berdiri sendiri atau sekunder), anda secara teorinya boleh sambung menggunakan fail Adminer dalam ServBay. Namun, nilai utama integrasi Adminer adalah bagi pengurusan mudah pangkalan data terbina dalam ServBay.

Kesimpulan

Adminer ialah alat pengurusan pangkalan data yang amat mudah digunakan dalam ServBay, dengan kelebihan satu fail, ringan, serta menyokong pelbagai jenis pangkalan data. Ia memudahkan lagi tugasan pengurusan MariaDB/MySQL, PostgreSQL, dan SQLite dalam persekitaran pembangunan tempatan anda. Dengan panduan ini, anda sepatutnya dapat menyambung ke pangkalan data dalam ServBay dan menggunakan Adminer untuk pengurusan serta operasi harian pangkalan data dengan mudah.