Instalasi dan Konfigurasi Drupal di Lingkungan Pengembangan Lokal ServBay

Ringkasan

Drupal adalah sistem manajemen konten (CMS) sumber terbuka yang kuat, fleksibel, dan dapat diperluas. CMS ini banyak digunakan untuk membuat berbagai jenis situs web, mulai dari blog pribadi, situs bisnis kecil, hingga portal perusahaan besar dan aplikasi web kompleks. Drupal menawarkan beragam alat pengelolaan konten, kontrol hak akses yang detail, serta arsitektur modular yang tangguh, sangat cocok bagi pengembang yang membutuhkan tingkat kustomisasi dan performa tinggi.

ServBay adalah sebuah alat lingkungan pengembangan web lokal yang dirancang khusus untuk macOS. ServBay sudah mengintegrasikan berbagai server web (seperti Caddy, Nginx), banyak runtime bahasa pemrograman (seperti PHP, Node.js, Python, Go, Java, dan lain-lain), berbagai database (seperti MySQL, PostgreSQL, MongoDB, Redis), serta alat pengembangan seperti Composer dan npm. Menginstal dan mengonfigurasi Drupal di lingkungan ServBay memberi Anda platform pengembangan lokal yang stabil, praktis, dan lengkap fitur.

Panduan ini akan membahas secara mendalam bagaimana menginstal dan mengonfigurasi Drupal di ServBay dan membantu Anda membangun lingkungan pengembangan Drupal lokal dengan cepat.

Prasyarat

Sebelum memulai instalasi Drupal, pastikan Anda telah memenuhi syarat berikut:

1. ServBay Sudah Terpasang dan Berjalan: Pastikan Anda telah menginstal dan menjalankan ServBay di macOS.
2. Memahami Dasar Penggunaan ServBay: Ketahui cara mengelola paket, menambah situs web, serta mengakses alat built-in (seperti phpMyAdmin) melalui UI ServBay.
3. PHP dan MySQL/MariaDB Sudah Terinstal: ServBay secara default menyertakan beberapa versi PHP serta database MySQL atau MariaDB. Pastikan versi PHP yang akan digunakan sudah diaktifkan dan layanan database berjalan.
4. Composer Sudah Terpasang: ServBay sudah mengintegrasikan Composer secara default, alat penting untuk manajemen dependensi proyek PHP modern. Panduan ini akan menggunakan Composer untuk membuat proyek Drupal.

Langkah-langkah Instalasi Drupal

Berikut penjelasan rinci langkah-langkah instalasi dan konfigurasi Drupal di ServBay:

Langkah 1: Membuat Direktori Proyek

Pertama, Anda perlu membuat sub-direktori khusus untuk proyek Drupal Anda di direktori root situs ServBay, yaitu /Applications/ServBay/www.

Buka Terminal, lalu jalankan perintah:

cd /Applications/ServBay/www
mkdir servbay-drupal-app
cd servbay-drupal-app

Perintah ini akan membuat folder baru bernama servbay-drupal-app di dalam /Applications/ServBay/www, lalu masuk ke folder tersebut.

Langkah 2: Membuat Proyek Drupal Menggunakan Composer

ServBay sudah menyertakan Composer, jadi Anda tidak perlu menginstal ulang. Drupal sendiri sangat menyarankan menggunakan Composer untuk pembuatan dan manajemen dependensi proyek.

Di direktori servbay-drupal-app yang baru saja Anda buat, jalankan perintah Composer berikut:

composer create-project drupal/recommended-project .

Perintah ini akan membuat proyek Drupal baru di direktori saat ini (.), menggunakan template drupal/recommended-project. Composer akan mengunduh file-file inti Drupal beserta dependensinya. Proses ini membutuhkan waktu, tergantung pada kecepatan internet Anda.

Template drupal/recommended-project otomatis meletakkan semua file yang dapat diakses publik (seperti index.php, CSS, JavaScript, dll) di dalam sub-direktori bernama web. Ini adalah struktur standar untuk proyek Drupal masa kini dan meningkatkan keamanan aplikasi Anda.

Langkah 3: Membuat Database dan Pengguna

Drupal membutuhkan database tersendiri yang menyimpan semua konten, konfigurasi, dan data pengguna. Pada bagian ini, kita akan memakai phpMyAdmin bawaan ServBay untuk membuat database serta pengguna baru.

1. Akses phpMyAdmin ServBay

   Buka browser, lalu akses dashboard ServBay di https://servbay.host/. Pada halaman dashboard, cari dan klik tautan "phpMyAdmin" (biasanya ada di bagian "Tools" atau "Database") untuk masuk ke antarmuka phpMyAdmin.

   servbay.host adalah domain khusus yang disediakan ServBay untuk akses pengelolaan lokal.

2. Buat Pengguna Database

   Demi keamanan dan manajemen hak akses, disarankan membuat pengguna database khusus untuk proyek Drupal Anda.

   • Buka Halaman Akun Pengguna: Di halaman utama phpMyAdmin, klik menu atas "Pengguna Akun".
   • Tambah Pengguna Baru: Klik "Tambah Akun Pengguna".
   • Isi Data Pengguna:
     • Nama Pengguna: Masukkan nama pengguna, misal drupal_user.
     • Host: Pilih atau masukkan localhost. Ini memastikan akses hanya dapat dilakukan secara lokal.
     • Sandi: Masukkan password yang aman. Jangan gunakan password lemah seperti password123 (hanya contoh). Gunakan generator password kuat untuk keamanan optimal.
     • Konfirmasi Sandi: Masukkan ulang sandi Anda.
   • Pengaturan Hak Database: Pada bagian "Database untuk akun ini", centang "Buat database dengan nama yang sama dan berikan semua hak kepadanya". Ini otomatis membuat database baru dengan nama sesuai username (drupal_user) dan memberikan hak penuh atasnya.
   • Hak Global: Pastikan TIDAK mencentang "Berikan semua hak global" kecuali Anda benar-benar membutuhkannya. Hak penuh hanya dibutuhkan di database miliknya sendiri.
   • Eksekusi: Jika seluruh data sudah benar, klik tombol "Jalankan" di kanan bawah halaman.

   Sekarang, Anda memiliki database dan pengguna bernama drupal_user dengan kontrol penuh atas database tersebut.

Langkah 4: Konfigurasi Web Server (Menambahkan Situs di ServBay)

Selanjutnya, Anda harus mengonfigurasi situs baru di ServBay dan mengarahkan domain lokal ke folder web proyek Drupal.

1. Buka UI ServBay: Jalankan aplikasi ServBay.
2. Tambahkan Situs Baru: Klik tab "Situs" di navigasi kiri.
3. Klik Tombol Tambah: Di daftar situs, klik "+" atau tombol serupa untuk membuat konfigurasi situs baru.
4. Isi Data Situs:
   • Nama: Masukkan nama situs, misalnya My Drupal Site.
   • Domain: Masukkan domain lokal untuk akses proyek, misal servbay-drupal.local. ServBay mendukung domain .local tanpa harus mengedit file hosts sistem.
   • Jenis Situs: Pilih PHP.
   • Versi PHP: Dari dropdown, pilih versi PHP yang ingin digunakan untuk Drupal. Silakan cek dokumentasi resmi Drupal versi yang akan diinstal untuk menentukan kompatibilitas PHP.
   • Root Direktori Situs: Penting! Root harus mengarah ke sub-direktori berisi file utama Drupal (index.php). Jika mengikuti struktur pada langkah 2, maka arahkan ke: /Applications/ServBay/www/servbay-drupal-app/web.
5. Simpan Konfigurasi: Setelah seluruh informasi diisi, klik "Simpan" atau tombol setara, lalu konfigurasi situs baru akan segera berlaku.

Langkah 5: Menjalankan Installer Drupal

Sekarang, Anda bisa mulai proses instalasi Drupal melalui browser dengan mengunjungi domain lokal yang baru dikonfigurasi.

1. Akses Halaman Instalasi

   Buka browser, lalu akses domain lokal yang telah Anda buat di langkah 4, tambahkan /core/install.php di belakangnya: https://servbay-drupal.local/core/install.php.

   Anda akan melihat tampilan wizard instalasi Drupal.

2. Pilih Bahasa

   Pilih bahasa utama untuk situs, lalu klik "Simpan dan Lanjutkan".

3. Pilih Konfigurasi Instalasi

   Pilih tipe instalasi yang diinginkan. Biasanya, pilih "Standar" untuk mendapatkan fitur default. Klik "Simpan dan Lanjutkan".

4. Atur Data Database

   Pada tahap ini, masukkan informasi database seperti yang sudah dibuat di langkah 3:

   • Tipe Database: Pilih MySQL, MariaDB, Percona Server, or equivalent.
   • Nama Database: Masukkan drupal_user (sesuai database yang telah dibuat).
   • Nama Pengguna Database: Masukkan drupal_user.
   • Password Database: Masukkan password yang dibuat di langkah 3.
   • Host Database: Masukkan localhost.
   • Opsi Lanjutan: Tidak perlu diubah kecuali database memakai port/konfigurasi khusus.

   Jika sudah, klik "Simpan dan Lanjutkan". Drupal akan mencoba konek ke database dan mengimpor data awal.

5. Isi Informasi Situs

   Jika koneksi database sukses, wizard akan lanjut ke pengaturan situs. Masukkan data berikut:

   • Nama Situs: Judul website Anda.
   • Email Situs: Email yang digunakan untuk notifikasi sistem.
   • Username Admin: Akun admin untuk mengelola Drupal.
   • Password Admin: Password yang aman untuk admin.
   • Negara: Pilih negara Anda.
   • Zona Waktu: Pilih zona waktu.

   Klik "Simpan dan Lanjutkan" setelah selesai. Drupal akan menyelesaikan instalasi—membuat file konfigurasi dan mengatur data situs.

6. Selesai Instalasi

   Setelah selesai, Anda akan diarahkan ke halaman depan situs Drupal baru. Selamat, Drupal kini telah terinstal di lingkungan ServBay Anda!

Langkah 6: Instalasi Modul & Tema (Pengenalan Dasar)

Salah satu keunggulan utama Drupal adalah ekosistem modul dan temanya yang luas. Setelah instalasi, Anda dapat memperluas dan menyesuaikan situs sesuai kebutuhan.

1. Login ke Admin Drupal: Akses https://servbay-drupal.local/user atau https://servbay-drupal.local/admin lalu login menggunakan username dan password admin yang sudah dibuat di langkah 5.
2. Install Modul: Setelah login, navigasi ke menu "Ekstensi" (Extend) untuk menelusuri, mencari, dan menginstal modul baru sesuai kebutuhan pengembangan fitur.
3. Install Tema: Buka menu "Tampilan" (Appearance) untuk menginstal dan mengatur tema, sehingga tampilannya sesuai keinginan.

Konfigurasi Lanjutan dan Penggunaan Setelah Instalasi

Setelah Drupal berhasil dipasang, mulai gunakan dan kembangkan situs Anda sesuai kebutuhan. Berikut beberapa langkah konfigurasi dan pengelolaan dasar:

Membuat Tipe Konten dan Konten

Konten di Drupal didasarkan pada "Content Type", yang mendefinisikan struktur data—seperti artikel, halaman statis, dsb.

1. Buat Tipe Konten: Di backend Drupal, buka menu "Struktur" -> "Tipe Konten". Edit tipe konten yang ada atau klik "Tambah Tipe Konten" untuk membuat yang baru beserta field (judul, isi, gambar, dll).
2. Buat Konten: Pergi ke "Konten" -> "Tambah Konten", lalu pilih tipe konten, isi setiap field, kemudian klik "Simpan dan Publikasikan".

Mengatur Menu Navigasi

Menu digunakan untuk pengorganisasian link navigasi situs Anda.

1. Buat Menu: Di backend, navigasi ke "Struktur" -> "Menu". Anda bisa menambah atau mengedit menu yang ada.
2. Tambah Item Menu: Edit menu, klik "Tambah Tautan", isi label dan path tujuan (internal seperti /node/1 atau URL eksternal), lalu simpan.

Mengatur Layout Blok

Blok merupakan elemen konten yang dapat ditempatkan di area mana saja seperti sidebar atau footer.

1. Tambah Blok: Di backend, buka "Struktur" -> "Layout Blok". Halaman ini menampilkan area tema yang tersedia. Anda bisa drag-drop blok (misal menu navigasi, blok kustom) ke area tertentu.
2. Konfigurasi Blok: Klik "Konfigurasi" di samping blok pada area, untuk mengatur judul, tampilan pada halaman tertentu, visibilitas berdasarkan peran user, dsb.

Catatan Penting & FAQ

• Bagaimana cara mengubah konfigurasi PHP? Jika Drupal memerlukan ekstensi PHP tertentu atau limit memori lebih tinggi (memory_limit), buka tab "Paket" di UI ServBay, temukan versi PHP yang digunakan, lalu klik tombol konfigurasi untuk mengedit file php.ini. Setelah mengubah, restart layanan PHP jika diminta.
• Mengapa situs saya tidak bisa diakses?
  • Pastikan ServBay dalam keadaan berjalan.
  • Cek pengaturan situs di ServBay, terutama domain dan root direktori. Root harus diarahkan ke .../servbay-drupal-app/web.
  • Pastikan server web (Caddy/Nginx) ServBay berjalan.
  • Cek apakah Anda mengakses https://servbay-drupal.local dengan path yang benar (https://servbay-drupal.local/core/install.php untuk instalasi).
• Bagaimana jika koneksi database gagal?
  • Pastikan nama database, username, dan password yang diinput saat instalasi Drupal benar.
  • Host database harus localhost.
  • Cek apakah layanan MySQL/MariaDB di ServBay sudah berjalan.
• Bagaimana jika mengalami error saat install dependensi Composer? Cek koneksi internet dan pastikan Composer bisa mengakses packagist.org. Kadang perlu clear cache Composer atau update versi Composer (ServBay secara berkala memperbarui Composer bawaan).
• Masalah izin file? Drupal butuh izin menulis untuk folder tertentu (misal web/sites/default/files dan web/sites/default/settings.php). ServBay biasanya berjalan dengan user aktif jadi masalah izin jarang terjadi, namun pastikan setting izin di folder-folder ini benar jika menemui kendala.

Kesimpulan

Dengan mengikuti panduan ini, Anda telah berhasil menginstal dan mengonfigurasi Drupal di lingkungan pengembangan lokal ServBay. ServBay menyediakan platform yang praktis dan terintegrasi dengan seluruh komponen yang dibutuhkan untuk pengembangan Drupal. Kini Anda bisa memanfaatkan kekuatan penuh Drupal untuk membangun situs Anda—mulai dari pengembangan, pengujian, hingga debugging lokal. Seiring dengan eksplorasi lebih lanjut, fleksibilitas ServBay akan sangat membantu dalam mengelola berbagai versi PHP, database, dan layanan lain sesuai kebutuhan proyek Anda.