Instalasi dan Konfigurasi Contao CMS di Lingkungan ServBay

Contao adalah sistem manajemen konten (CMS) sumber terbuka yang kuat, sangat cocok untuk membangun situs web perusahaan kecil hingga menengah, portal, atau aplikasi web yang kompleks. Panduan ini akan menjelaskan secara detail cara menginstal dan mengonfigurasi Contao di lingkungan pengembangan web lokal ServBay yang praktis di macOS, sehingga Anda dapat segera memulai proyek Contao Anda.

ServBay menawarkan lingkungan satu atap yang terintegrasi dengan PHP, Composer, layanan basis data (seperti MySQL/MariaDB, PostgreSQL), serta web server (seperti Caddy, Nginx, Apache), sehingga memudahkan proses penyiapan lingkungan pengembangan lokal. Dengan ServBay, Anda dapat dengan mudah memenuhi semua persyaratan Contao.

Apa Itu Contao?

Contao adalah sistem manajemen konten (CMS) sumber terbuka berbasis PHP yang dikenal karena kemudahan penggunaan, fleksibilitas tinggi, serta dashboard administrasi yang andal. Platform ini menawarkan berbagai fitur seperti manajemen hak akses yang rinci, kontrol versi, dukungan multibahasa, pengelolaan gambar responsif, dan arsitektur modular yang memudahkan penambahan fitur lewat ekstensi. Inti dari filosofi desain Contao adalah menyediakan fondasi kokoh bagi pengembang dan desainer untuk membangun website khusus tanpa harus memulai dari nol.

Persyaratan Awal

Sebelum memulai instalasi Contao, pastikan hal-hal berikut sudah dipenuhi:

1. ServBay Telah Terinstal & Berjalan: Anda harus memasang ServBay di macOS. Pastikan ServBay sudah berjalan, serta versi PHP yang dibutuhkan (cek dokumentasi resmi Contao untuk memverifikasi versi PHP terbaru) dan layanan database (seperti MySQL atau MariaDB) sudah diaktifkan di ServBay.
2. Composer: Composer sudah terintegrasi secara default di ServBay. Anda tidak perlu memasangnya secara terpisah.
3. Akses Terminal: Dibutuhkan akses terminal untuk menjalankan perintah Composer.

Langkah-Langkah Instalasi Contao

Bagian ini akan memandu Anda secara detail dalam proses instalasi dan konfigurasi Contao di lingkungan ServBay.

Langkah 1: Membuat Direktori Proyek

Pertama, navigasikan ke direktori root website default ServBay di /Applications/ServBay/www, lalu buat subdirektori baru untuk proyek Contao Anda.

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

Selanjutnya, instalasi Contao akan dilakukan di dalam direktori servbay-contao-app.

Langkah 2: Membuat Proyek Contao dengan Composer

Contao merekomendasikan instalasi dan manajemen melalui Composer. Composer sudah terinstal di ServBay, jadi Anda cukup menjalankan perintah berikut di dalam direktori proyek:

composer create-project contao/managed-edition .

Perintah ini akan mengunduh versi terbaru Contao Managed Edition beserta semua dependensinya ke direktori saat ini (.). Proses ini bisa memakan waktu beberapa saat tergantung kecepatan internet Anda.

Penjelasan Contao Managed Edition: contao/managed-edition adalah rilis resmi Contao yang sudah mencakup inti Contao dan dependensi yang direkomendasikan, serta sudah ditata dengan struktur proyek standar. Perlu diperhatikan, dengan instalasi managed-edition, root website Contao akan terletak pada subdirektori web di dalam direktori proyek.

Langkah 3: Membuat Database dan Pengguna

Contao memerlukan database untuk menyimpan konten dan pengaturannya. ServBay menyediakan alat manajemen database seperti phpMyAdmin atau Adminer untuk membuat database dan pengguna. Berikut menggunakan phpMyAdmin:

1. Buka phpMyAdmin dari ServBay

   Akses alamat lokal ServBay: https://servbay.host/. Cari dan klik tautan ke phpMyAdmin di halaman utama.

2. Membuat Pengguna Database

   Demi keamanan, disarankan membuat pengguna khusus untuk aplikasi Contao.

   a. Masuk ke Halaman Pengguna

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

   b. Tambah Pengguna Baru

   Klik "Tambah akun pengguna". Isi data berikut:
   
   *   **Nama pengguna:** Masukkan nama yang akan digunakan untuk koneksi database Contao, misal `contao_user`.
   *   **Host:** Pilih `localhost` agar hanya bisa diakses dari lokal, demi keamanan ekstra.
   *   **Kata sandi:** Masukkan **kata sandi kuat**. Jangan gunakan kata sandi lemah seperti `password123` (ini hanya contoh). Untuk produksi, gunakan generator password untuk menghasilkan kata sandi acak yang rumit.
   *   **Input ulang kata sandi:** Masukkan kembali kata sandi.
   
   Di bagian "Database untuk pengguna", sebaiknya pilih "Buat database yang namanya sama dengan nama pengguna dan beri semua hak akses". Ini akan secara otomatis menciptakan database bernama `contao_user` dan memberikan seluruh hak akses kepada pengguna tersebut.
   
   *   Pastikan centang "Beri semua hak akses".
   *   Klik tombol "Eksekusi" di bagian bawah halaman untuk menyelesaikan pembuatan user dan database.
   

Langkah 4: Konfigurasi Website di ServBay

Sekarang, saatnya mengonfigurasi website di ServBay dan mengarahkannya ke direktori proyek Contao yang baru Anda buat.

1. Buka ServBay dan Tambah Website Baru

   Buka antarmuka utama aplikasi ServBay. Pilih tab "Website" di panel navigasi sebelah kiri. Klik tombol "Tambah" untuk membuat konfigurasi website baru.

2. Isi Informasi Konfigurasi Website

   • Nama: Beri nama mudah diingat, misal My Contao Site.
   • Domain: Atur domain pengembangan lokal, sebaiknya gunakan akhiran .local atau .servbay.demo, misal servbay-contao.local. ServBay akan otomatis mengarahkan domain ini ke lokal.
   • Jenis website: Pilih PHP.
   • Versi PHP: Pilih versi sesuai yang dipersyaratkan Contao. Cek kembali di dokumentasi resmi Contao untuk versi yang cocok.
   • Root directory website: Langkah ini sangat penting! Untuk proyek yang diinstal dari Composer contao/managed-edition, berkas publik Contao (termasuk index.php) terletak di subdirektori web. Jadi, tulis path lengkap ke direktori web: /Applications/ServBay/www/servbay-contao-app/web.

3. Simpan Konfigurasi

   Setelah semua data diisi, klik tombol "Simpan" di bagian bawah antarmuka ServBay. ServBay akan menerapkan pengaturan situs baru Anda.

Langkah 5: Jalankan Installer Web Contao

Setelah konfigurasi website selesai, Anda bisa mengakses installer web Contao melalui browser dan domain yang telah Anda atur.

1. Akses Halaman Instalasi

   Buka browser dan akses domain ServBay Anda dengan menambahkan /contao/install. Contoh: https://servbay-contao.local/contao/install.

   Jika semua sudah diatur dengan benar, Anda akan melihat halaman instalasi Contao.

2. Isi Informasi Database

   Installer akan meminta data koneksi database. Masukkan data yang sudah Anda buat pada langkah 3:

   • Hostname Database: localhost
   • Nama Database: contao_user (jika memilih membuat database dengan nama sama saat di phpMyAdmin)
   • Nama pengguna: contao_user
   • Password: Kata sandi yang Anda buat untuk contao_user di langkah 3.

3. Input Data Administrator

   Ikuti instruksi halaman untuk mengatur nama pengguna, kata sandi, dan email untuk admin backend Contao. Pastikan menggunakan kata sandi yang kuat.

4. Selesaikan Instalasi

   Ikuti langkah-langkah selanjutnya sesuai instruksi installer, biasanya termasuk pembuatan struktur tabel database. Klik tombol seperti "Instal" atau "Selesai" untuk menyelesaikan proses instalasi.

Langkah 6: Verifikasi Instalasi dan Login ke Backend

Setelah proses install selesai, Anda bisa memastikan Contao berjalan baik dan mencoba mengakses dashboard backend-nya.

1. Akses Frontend Website

   Buka browser dan akses domain yang sudah Anda atur, misal https://servbay-contao.local/. Anda akan melihat halaman sambutan default Contao atau halaman kosong (tergantung konfigurasi Contao). Ini berarti server web sudah benar dan frontend Contao dapat diakses.

2. Akses Backend Administrator Contao

   Buka halaman login administrator Contao, biasanya di https://servbay-contao.local/contao.

   Masukkan username dan password admin yang Anda buat di langkah 5 instalasi. Jika berhasil login, Anda akan masuk ke panel admin Contao, tempat Anda bisa mulai membuat konten, memasang ekstensi, dan mengonfigurasi situs.

FAQ (Pertanyaan Umum)

T: Saat membuka https://servbay-contao.local/ atau https://servbay-contao.local/contao/install muncul error, apa yang harus dilakukan?

J:

• Cek Apakah ServBay Berjalan: Pastikan aplikasi ServBay sedang berjalan dan layanan PHP serta web server (Caddy atau Nginx) telah aktif.
• Cek Konfigurasi Website di ServBay: Verifikasi kembali nama domain, jenis website, versi PHP, dan terutama root directory. Ingat, root website contao/managed-edition ada di dalam direktori web pada proyek Anda.
• Cek Resolusi Domain: ServBay secara otomatis menangani domain .local. Jika menggunakan ekstensi lain atau ada kendala, coba restart ServBay atau periksa file hosts sistem Anda (meski biasanya ServBay sudah mengelola otomatis).
• Cek Log Web Server: Buka log server web (Caddy atau Nginx) yang disediakan oleh ServBay untuk informasi error yang lebih detail.

T: Gagal koneksi ke database, apa solusinya?

J:

• Cek Status Layanan Database: Pastikan layanan MySQL/MariaDB atau PostgreSQL di ServBay sedang berjalan.
• Verifikasi Kredensial Database: Cek kembali hostname (localhost), nama database, nama pengguna, dan password yang dimasukkan di installer Contao sesuai yang Anda buat di phpMyAdmin.
• Cek Hak Akses Pengguna Database: Pastikan user yang Anda buat memiliki hak akses penuh ke database Contao.

T: Bagaimana jika muncul error perizinan (permission) saat instalasi?

J: Installer Contao membutuhkan akses tulis ke beberapa direktori. Konfigurasi default ServBay biasanya sudah cukup, namun jika ada kendala, Anda bisa atur izin direktori lewat terminal:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # Ganti your_username dengan nama user macOS Anda
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao mungkin butuh izin tulis pada folder-folder ini

Gunakan chmod 777 dengan hati-hati—tidak aman untuk produksi, tapi umum digunakan untuk debugging atau pengembangan lokal.

Kesimpulan

Dengan mengikuti panduan ini, Anda seharusnya sudah berhasil menginstal dan mengonfigurasi Contao CMS di lingkungan pengembangan lokal ServBay. Lingkungan terintegrasi ServBay memudahkan langkah-langkah seperti manajemen dependency Composer, setup database, dan konfigurasi web server, sehingga Anda dapat fokus pada pengembangan website dengan Contao. Kini Anda bisa mulai membuat konten, mendesain halaman, menginstal ekstensi dan tema melalui backend Contao untuk membangun situs impian Anda.

Untuk mempelajari lebih lanjut tentang pemanfaatan dan fitur Contao, kunjungi dokumentasi resmi Contao.