Instalasi dan Konfigurasi Craft CMS di Lingkungan ServBay

Gambaran Umum

Craft CMS adalah sistem manajemen konten (CMS) yang kuat, digemari oleh para developer karena fleksibilitas dalam pemodelan konten, antarmuka pengguna yang intuitif, serta fitur-fitur yang ramah pengembang. CMS ini sangat cocok untuk membangun website yang kompleks dan tercustomisasi.

Menggunakan ServBay sebagai lingkungan pengembangan lokal Craft CMS menawarkan banyak keuntungan, seperti PHP, database (misalnya MySQL atau PostgreSQL), dan server web (Caddy atau Nginx) yang sudah terkonfigurasi sebelumnya, serta Composer dan alat baris perintah bawaan yang memudahkan proses instalasi dan konfigurasi.

Panduan ini akan mengupas langkah demi langkah cara menginstal dan mengonfigurasi proyek Craft CMS di lingkungan ServBay.

Prasyarat

Sebelum memulai, pastikan Anda sudah memenuhi persyaratan berikut:

1. ServBay sudah terinstal dan berjalan: Pastikan Anda telah berhasil menginstal ServBay pada macOS, serta paket PHP (versi PHP tertentu sesuai kebutuhan Craft CMS dapat dicek di dokumentasi resmi Craft CMS) dan database yang diperlukan (umumnya MySQL atau PostgreSQL) sudah aktif. ServBay mendukung beragam versi PHP dan database, sehingga Anda dapat dengan mudah mengganti serta mengonfigurasikannya sesuai kebutuhan Craft CMS.
2. Memahami dasar penggunaan terminal/command line: Anda perlu menggunakan terminal untuk menjalankan perintah seperti membuat direktori atau menjalankan Composer.
3. Mengenal Composer: Craft CMS memakai Composer untuk manajemen dependensi. Composer sudah tersedia di ServBay, tetapi pastikan Anda mengetahui cara menjalankan perintah composer create-project.

Langkah Instalasi Craft CMS

Berikut ini adalah langkah-langkah detail menginstal dan mengonfigurasi Craft CMS menggunakan ServBay.

Langkah 1: Membuat Direktori Proyek

Langkah awal, buat direktori proyek baru di direktori root situs default ServBay yaitu /Applications/ServBay/www. ServBay akan otomatis mengonfigurasi direktori ini sebagai folder layanan web server sehingga Anda dapat dengan mudah mengakses proyek.

Buka terminal, lalu jalankan perintah berikut:

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

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

Langkah 2: Membuat Proyek Craft CMS dengan Composer

ServBay sudah dilengkapi Composer, jadi Anda dapat langsung menggunakan Composer di direktori proyek untuk membuat proyek Craft CMS. Instalasi menggunakan Composer adalah cara yang direkomendasikan oleh Craft CMS.

Jalankan perintah berikut di dalam direktori servbay-craft-app:

composer create-project craftcms/craft .

Perintah ini akan mengunduh versi terbaru Craft CMS beserta semua dependensinya ke direktori saat ini (.). Silakan tunggu hingga proses unduh dan instalasi oleh Composer selesai.

Langkah 3: Membuat Database dan User

Craft CMS membutuhkan database untuk menyimpan konten dan konfigurasi. Pada bagian ini, kita akan menggunakan phpMyAdmin atau Adminer bawaan ServBay untuk membuat database beserta user-nya. Sebagai contoh, kita gunakan phpMyAdmin.

1. Akses alat manajemen database ServBay (phpMyAdmin)

   Buka browser, akses panel pengembangan lokal ServBay di https://servbay.host/. Temukan dan klik tautan "phpMyAdmin" untuk masuk ke tool manajemen database.

   Tips: Username default untuk mengakses phpMyAdmin pada ServBay biasanya adalah root dengan password default ServBay.dev. Demi keamanan, disarankan untuk segera mengubah password root atau membuat user admin baru setelah login.

2. Membuat User Database Baru

   Meski Anda dapat menggunakan user root untuk koneksi Craft CMS, praktik terbaik dan lebih aman adalah membuat user database terpisah untuk setiap aplikasi.

   1. Masuk ke halaman "Akun Pengguna"

      Di halaman utama phpMyAdmin, klik menu "Akun Pengguna" di bagian atas.

   2. Tambahkan pengguna baru

      Klik "Tambah pengguna". Isi data berikut:

      • Nama pengguna: Masukkan username yang akan digunakan oleh Craft CMS, misal craft_user.
      • Nama host: Pilih localhost yang berarti user hanya dapat mengakses database secara lokal.
      • Kata sandi: Masukkan password yang kuat. Jangan gunakan contoh password123 terutama untuk produksi. Saat pengembangan lokal, password sederhana masih diperbolehkan, namun tetap utamakan keamanan.
      • Ketik ulang: Ulangi password.
      • Pada bagian "Database untuk pengguna", pilih "Buat database dengan nama yang sama dan berikan semua hak akses". Dengan cara ini, sistem otomatis membuat database bernama craft_user dan memberikan akses penuh ke user tersebut.
      • Pastikan opsi "Berikan semua hak akses" tercentang.
      • Klik tombol "Eksekusi" di bagian bawah halaman.

   Sekarang Anda telah memiliki user database baru bernama craft_user dan database dengan nama sama (craft_user), dengan semua hak akses terlampir.

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

Agar web server (Caddy atau Nginx) pada ServBay dapat melayani proyek Craft CMS Anda, buatlah konfigurasi “situs” baru di ServBay.

1. Buka aplikasi ServBay

   Jalankan aplikasi ServBay.

2. Tambah situs baru

   Klik tab "Situs" di panel navigasi kiri (versi lawas mungkin tertulis "Host"). Klik tombol "+" di bawah atau tombol "Tambah Situs" di sisi kanan untuk memulai pembuatan situs baru.

   Isi informasi berikut:

   • Nama: Beri nama yang mudah dikenali, misal My Craft Site.
   • Domain: Masukkan domain lokal yang ingin digunakan, misal servbay-craft.local. ServBay akan otomatis mengatur DNS lokal agar domain ini langsung dapat diakses.
   • Tipe Situs: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang sesuai dengan kebutuhan Craft CMS seperti yang telah dipastikan di bagian prasyarat. ServBay memungkinkan multi versi PHP dipasang dan dijalankan bersamaan.
   • Root/Titik Akar Website: Ini sangat penting. File publik Craft CMS (seperti index.php) berada di subdirektori web di dalam folder proyek. Demi keamanan, arahkan root web server ke folder web, bukan ke folder proyek utama. Isi: /Applications/ServBay/www/servbay-craft-app/web Pastikan path sudah benar dan menunjuk ke folder web yang Anda buat di langkah 1.

3. Simpan Konfigurasi

   Setelah selesai, klik "Simpan". ServBay akan membuat ulang konfigurasi server web sehingga situs baru aktif. Situs servbay-craft.local akan muncul di daftar situs pada aplikasi ServBay.

Langkah 5: Menjalankan Installer Craft CMS

Kini Anda dapat mengakses installer web Craft CMS dari browser melalui domain lokal yang sudah Anda daftarkan.

1. Buka halaman instalasi

   Buka browser, kunjungi domain yang telah dikonfigurasi, misal https://servbay-craft.local/. Craft CMS akan mendeteksi bahwa instalasi belum dilakukan dan otomatis mengalihkan ke halaman instalasi, biasanya di https://servbay-craft.local/index.php?p=admin/install.

2. Isi Detail Koneksi Database

   Di halaman instalasi Craft CMS, pada bagian konfigurasi database, isi data yang Anda buat pada langkah 3:

   • Database Server: localhost
   • Nama Database: craft_user (atau nama yang Anda buat di langkah 3)
   • Username: craft_user (atau username yang Anda buat)
   • Password: password yang Anda set untuk user craft_user.

   Klik lanjutkan. Craft CMS akan mencoba koneksi ke database. Jika berhasil, proses akan berlanjut ke tahap berikutnya.

3. Buat Akun Admin

   Ikuti arahan untuk membuat akun admin Craft CMS: masukkan username, password, dan email Anda. Jika untuk produksi, gunakan password yang benar-benar kuat.

   Klik lanjutkan.

4. Pengaturan Situs

   Masukkan nama situs dan data dasar lainnya.

   Klik tombol "Selesai Instalasi (Finish Up)". Craft CMS akan menuntaskan instalasi terakhir: membuat tabel database dan file konfigurasi.

   Jika selesai, Anda akan diarahkan ke halaman login admin Craft CMS.

Langkah 6: Konfigurasi Awal & Eksplorasi Craft CMS

Setelah masuk ke dashboard admin Craft CMS, Anda bisa melanjutkan dengan konfigurasi dan eksplorasi berikut:

1. Cek file .env: Craft CMS mengelola variabel lingkungan seperti detail database via file .env. File ini dibuat otomatis saat instalasi dan bisa ditemukan di root proyek (servbay-craft-app/). Anda bisa mengedit file ini untuk mengubah pengaturan, misal menetapkan CRAFT_ENVIRONMENT ke dev.
2. Instal plugin: Dari admin panel, klik "Plugin" untuk menjelajahi, menginstal, dan mengelola plugin Craft CMS untuk memperluas fitur.
3. Membuat Struktur Konten: Eksplorasi menu "Settings" untuk mendefinisikan field, section, kategori, tag, dan struktur konten lain untuk situs Anda.
4. Konfigurasi Email: Untuk pengujian email lokal, Anda dapat mengatur Craft CMS agar menggunakan Mailpit atau Mailhog bawaan ServBay. Pada konfigurasi .env atau dari panel admin bagian pengaturan email, gunakan opsi SMTP dengan localhost dan port SMTP Mailpit/Mailhog (bisa ditemukan di panel ServBay).

Pertanyaan Umum (FAQ)

• Tanya: Bagaimana jika muncul error koneksi database saat instalasi?
  • Jawab: Cek data server database (localhost), nama database, username, dan password yang diinput di installer Craft CMS, pastikan persis sama dengan yang Anda buat di phpMyAdmin. Selain itu, pastikan layanan database (MySQL/PostgreSQL) di ServBay sedang berjalan.
• Tanya: Mengapa saat mengakses servbay-craft.local muncul 404 atau halaman kosong?
  • Jawab:
    • Pastikan root situs di ServBay tepat mengarah ke /Applications/ServBay/www/servbay-craft-app/web. Ini kesalahan yang sangat sering terjadi.
    • Pastikan server web (Caddy/Nginx) dan PHP di ServBay sudah berjalan.
    • Pastikan konfigurasi situs servbay-craft.local di daftar situs ServBay telah diaktifkan.
• Tanya: Proses Composer sangat lambat atau gagal saat install Craft CMS?
  • Jawab: Ini bisa akibat jaringan atau mirror Composer. Anda bisa mengganti mirror Composer ke mirror lokal seperti Alibaba Cloud atau Packagist China.
• Tanya: Setelah instalasi selesai, tampilan admin atau depan web rusak atau gambar tidak muncul?
  • Jawab: Umumnya ini disebabkan masalah izin file/folder. Pastikan user yang menjalankan ServBay memiliki akses tulis ke direktori seperti storage dan web/cpresources. ServBay biasanya mengatur ini otomatis, tapi kalau bermasalah silakan cek atau reset izin folder secara manual.

Penutup

Dengan mengikuti langkah-langkah di atas, Anda seharusnya sudah berhasil menginstal dan mengonfigurasi Craft CMS di lingkungan pengembangan lokal ServBay. ServBay membantu memudahkan pengelolaan versi PHP, pengaturan database, dan konfigurasi server web, sehingga Anda bisa lebih fokus pada pengembangan aplikasi dengan Craft CMS. Kini saatnya memanfaatkan kekuatan pemodelan konten Craft CMS untuk membangun situs atau aplikasi Anda!