Instalasi dan Konfigurasi ExpressionEngine CMS di Lingkungan Lokal ServBay

Gambaran Umum

ExpressionEngine adalah sistem manajemen konten (CMS) yang kuat dan fleksibel, banyak digunakan untuk membangun berbagai jenis situs web dan aplikasi web yang kompleks. Dengan beragam fitur inti dan arsitektur yang sangat modular, ExpressionEngine memungkinkan pengembang dan desainer untuk membuat serta menyesuaikan situs web sesuai kebutuhan.

ServBay adalah lingkungan pengembangan web lokal yang dirancang khusus untuk macOS. Ia menawarkan solusi all-in-one yang mengintegrasikan berbagai server web populer (seperti Nginx, Caddy, Apache), runtime bahasa pemrograman (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), database (MySQL, PostgreSQL, MongoDB, Redis), serta alat developer (Composer, npm/yarn, phpMyAdmin/Adminer). Dengan ServBay, pengembang dapat dengan mudah mengatur dan mengelola lingkungan pengembangan lokal.

Dokumen ini akan membahas langkah demi langkah proses instalasi dan konfigurasi ExpressionEngine di ServBay untuk membantu Anda memulai proyek ExpressionEngine dengan cepat.

Mengapa Memilih ServBay untuk Instalasi ExpressionEngine?

Berikut adalah keuntungan utama menggunakan ServBay untuk menginstal ExpressionEngine secara lokal:

• Integrasi Lengkap: ServBay sudah terintegrasi dengan runtime PHP, database MySQL, dan server web yang dibutuhkan oleh ExpressionEngine, sehingga Anda tidak perlu menginstal dan mengonfigurasi secara manual.
• Dukungan Multi-Versi: Anda dapat dengan mudah beralih atau memilih versi PHP yang sesuai kebutuhan ExpressionEngine langsung dari ServBay.
• Manajemen Database Praktis: ServBay menyediakan phpMyAdmin atau Adminer bawaan, memudahkan Anda membuat dan mengelola database untuk ExpressionEngine.
• Konfigurasi Situs Sederhana: Melalui antarmuka grafis ServBay, Anda bisa dengan cepat membuat dan mengatur situs lokal yang mengarah ke direktori proyek ExpressionEngine.
• Isolasi & Manajemen Proyek: ServBay memungkinkan setiap proyek memiliki konfigurasi situs sendiri, sehingga menghindari konflik antar proyek.

Persyaratan Dasar

Pastikan hal berikut sebelum memulai instalasi:

1. ServBay sudah terinstal dan berjalan di macOS Anda. Jika belum, kunjungi Situs Resmi ServBay untuk petunjuk instalasi.
2. Anda memahami dasar penggunaan terminal/command line.
3. Anda memahami konsep database (seperti database dan user).
4. Direktori root situs ServBay (/Applications/ServBay/www) memiliki izin menulis.

Langkah-langkah Instalasi

Proses instalasi dan konfigurasi ExpressionEngine di ServBay terdiri dari beberapa langkah berikut.

Langkah 1: Siapkan Direktori Proyek dan Unduh ExpressionEngine

Pertama, buka aplikasi terminal Anda. Arahkan ke direktori root situs ServBay /Applications/ServBay/www, lalu buat direktori proyek baru (contoh: servbay-ee-app), kemudian masuk ke dalamnya.

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

Selanjutnya, gunakan perintah curl untuk mengunduh versi terbaru ExpressionEngine ke direktori saat ini. Parameter -L digunakan untuk mengikuti redirect, dan -o untuk menentukan nama file output.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Langkah 2: Ekstrak File ExpressionEngine

Setelah proses unduh selesai, gunakan perintah unzip untuk mengekstrak file expressionengine.zip ke dalam direktori servbay-ee-app. Setelah diekstrak, Anda dapat menghapus file ZIP tersebut.

unzip expressionengine.zip
rm expressionengine.zip

Setelah proses ini, struktur file ExpressionEngine akan muncul di dalam direktori servbay-ee-app.

Langkah 3: Buat Database dan User untuk ExpressionEngine

ExpressionEngine membutuhkan database untuk menyimpan konten dan pengaturannya. ServBay sudah dilengkapi MySQL dan phpMyAdmin untuk memudahkan Anda.

1. Akses phpMyAdmin milik ServBay

   Buka browser Anda dan kunjungi alamat portal lokal ServBay: https://servbay.host/. Temukan dan klik tautan "phpMyAdmin" untuk membuka halaman login. Gunakan username dan password database default ServBay (biasanya dijelaskan di pengaturan ServBay; biasanya akses ke localhost tidak memerlukan password).

2. Buat User dan Database Baru

   Setelah login ke phpMyAdmin, kita akan membuat user database khusus untuk ExpressionEngine beserta database dengan nama yang sama.

   • Buka halaman Akun Pengguna: Di halaman utama phpMyAdmin, klik menu navigasi atas "Akun Pengguna".
   • Tambah User Baru: Klik tombol "Tambah Akun Pengguna".
   • Isi Data User dan Database:
     • Username: Masukkan nama penggunanya, misal ee_user.
     • Hostname: Pilih localhost agar user hanya dapat terhubung secara lokal—lebih aman.
     • Password: Masukkan password yang aman untuk koneksi ExpressionEngine. Mohon diingat password ini. Sebagai contoh password123, namun pastikan menggunakan password yang kuat untuk produksi.
     • Konfirmasi: Ketik ulang password.
     • Buat database dengan nama user: Centang opsi ini ("Buat database dengan nama yang sama dan berikan semua hak akses kepada user tersebut"). Ini akan otomatis membuat database bernama ee_user dan memberikan hak akses penuh ke user tersebut.
   • Cek Hak Akses: Pastikan bagian "Hak Istimewa Global" tidak memberikan izin yang tidak perlu (akses database sudah cukup).
   • Eksekusi: Klik "Eksekusi" di bagian bawah untuk menyelesaikan proses.

   Kini Anda memiliki database bernama ee_user dan user database dengan nama ee_user yang telah memiliki hak penuh ke database tersebut.

Langkah 4: Konfigurasi Situs di ServBay

Sekarang, Anda perlu mengatur ServBay agar permintaan ke domain tertentu (misal servbay-ee.local) diarahkan ke direktori proyek ExpressionEngine Anda.

1. Buka ServBay dan Tambah Situs Baru

   Jalankan aplikasi ServBay. Pada sidebar kiri, klik "Situs", lalu klik tombol "+" atau "Tambah" untuk membuat konfigurasi situs baru.

   • Nama (Name): Isikan nama yang mudah diidentifikasi, misal My ExpressionEngine Site.
   • Domain: Masukkan domain lokal yang diinginkan, misal servbay-ee.local. ServBay akan menambahkannya ke file hosts dan mengarahkannya ke 127.0.0.1.
   • Jenis Situs (Type): Pilih PHP karena ExpressionEngine berbasis PHP.
   • Versi PHP: Pilih versi PHP yang sesuai kebutuhan ExpressionEngine. ServBay mendukung multi versi PHP.
   • Root Direktori (Document Root): Klik tombol browse, lalu pilih direktori servbay-ee-app yang Anda buat sebelumnya (/Applications/ServBay/www/servbay-ee-app).
   • Server Web: Pilih server web apapun yang didukung (Nginx, Caddy, atau Apache). Konfigurasi default biasanya sudah cukup untuk kebutuhan lokal.

2. Simpan dan Terapkan Konfigurasi

   Setelah melengkapi data, klik "Simpan"/"Terapkan". ServBay mungkin perlu me-restart web server agar perubahan terjadi. Ikuti instruksinya dan tunggu hingga proses selesai.

   Sekarang, jika Anda mengunjungi https://servbay-ee.local/, ServBay akan mengarahkan request ke direktori proyek ExpressionEngine Anda.

Langkah 5: Jalankan Installer Web ExpressionEngine

ExpressionEngine menyediakan installer berbasis web untuk memandu Anda dalam konfigurasi awal.

1. Akses Halaman Installer

   Buka browser Anda, lalu kunjungi domain yang telah Anda atur di ServBay, tambahkan /admin.php. Secara default, installer akan berada di /admin.php.

   Contoh: https://servbay-ee.local/admin.php

   Anda seharusnya melihat halaman selamat datang atau wizard instalasi ExpressionEngine.

2. Isi Konfigurasi via Installer

   Wizard ExpressionEngine akan meminta informasi sebagai berikut:

   • Data Koneksi Database:
     • Host Database: localhost
     • Nama Database: ee_user (sama seperti yang Anda buat di langkah 3)
     • Username Database: ee_user (sama seperti username yang baru dibuat)
     • Password Database: password yang telah Anda tentukan di langkah 3.
   • Data Akun Administrator: Buat akun super admin ExpressionEngine, termasuk username, password, dan alamat email. Gunakan password yang kuat.
   • Konfigurasi Situs: Masukkan nama situs, URL, dan informasi dasar lainnya.

3. Selesaikan Instalasi

   Pastikan semua informasi terisi dengan benar, lalu klik tombol "Instal" atau "Selesai". ExpressionEngine akan membuat tabel database dan menyelesaikan setup.

   Setelah selesai, Anda biasanya akan diarahkan ke halaman login atau dashboard admin.

Langkah 6: Konfigurasi Dasar Setelah Instalasi

Setelah ExpressionEngine berhasil diinstal, Anda dapat menambah plugin, template, atau pengaturan dasar lain sesuai kebutuhan.

1. Login ke Admin ExpressionEngine

   Login ke dashboard admin menggunakan akun yang telah dibuat saat instalasi. Akses https://servbay-ee.local/admin.php, lalu masukkan username dan password Anda.

2. Instal Plugin

   Dari dashboard, navigasi ke "Developer" -> "Add-Ons" -> "Plugins". Jelajahi dan instal plugin sesuai kebutuhan proyek.

3. Tambah & Konfigurasi Template

   Buka "Design" -> "Templates". Di sini Anda bisa membuat grup template, template baru, dan menulis HTML/CSS/EE code untuk tampilan situs.

Membangun Situs Menggunakan ExpressionEngine

Dengan ExpressionEngine yang telah berhasil dikonfigurasi di ServBay, Anda siap membangun dan mengelola konten situs Anda. Berikut beberapa langkah awal yang biasa dilakukan:

Membuat Channel dan Entry

Inti dari ExpressionEngine adalah "channel" dan "entry". Channel mendefinisikan tipe dan struktur konten; entry adalah isi konten spesifik.

1. Membuat Channel: Pada dashboard admin, buka "Content Structure" -> "Channels". Klik "Create New Channel", lengkapi nama channel, fields group, dan pengaturan lain, lalu "Save Channel".
2. Membuat Entry: Buka "Content" -> "Publish". Pilih channel yang tadi dibuat, isi judul dan konten (sesuai fields), lalu klik "Save".

Konfigurasi Menu Navigasi

Menu navigasi biasanya dibuat menggunakan template.

1. Buat/Edit Template: Buka "Design" -> "Templates". Buat atau cari template untuk navigasi (misal dalam grup site, template nav).
2. Tulis Kode Navigasi: Gunakan template tag ExpressionEngine untuk mengambil entry channel atau halaman dan generate struktur navigasi HTML.
3. Sisipkan Navigasi ke Layout: Di template layout utama Anda, gunakan {% include 'site:nav' %} (jika menggunakan Blade) atau tag lain sesuai kebutuhan.

Kustomisasi Widget (Sidebar)

Seperti navigasi, sidebar atau widget lain dapat dibuat lewat template khusus.

1. Buat Template Widget: Masuk ke "Design" -> "Templates", buat template untuk menampilkan konten widget (contoh: site:sidebar).
2. Tulis Kode Widget: Isi template dengan kode untuk menampilkan entry terbaru, daftar kategori, iklan, dsb.
3. Sisipkan Widget ke Layout: Tambahkan template widget ke layout halaman yang diinginkan.

Pertanyaan Umum (FAQ)

• Tanya: Mengapa akses ke https://servbay-ee.local/ muncul error izin?
  • Jawab: Periksa izin direktori proyek ExpressionEngine Anda (/Applications/ServBay/www/servbay-ee-app) beserta subdirektorinya. Pastikan user yang menjalankan ServBay (biasanya user Anda sendiri) memiliki hak baca/tulis. Atur izin dengan chmod atau chown jika perlu—contoh: sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app.
• Tanya: Mengapa installer ExpressionEngine tidak bisa konek ke database?
  • Jawab: Cek informasi koneksi database yang diisi saat instalasi (host localhost, nama database, username, password) apakah sudah sesuai dengan yang Anda buat di phpMyAdmin. Pastikan juga layanan MySQL/MariaDB di ServBay sudah berjalan.
• Tanya: Apakah bisa memakai database lain (seperti PostgreSQL) di ServBay?
  • Jawab: ExpressionEngine pada umumnya hanya mendukung MySQL/MariaDB. Jika ExpressionEngine resmi telah mendukung PostgreSQL dan Anda memiliki driver serta metode konfigurasi yang relevan, secara teori PostgreSQL di ServBay dapat digunakan—namun pastikan cek kompatibilitas di dokumentasi resmi ExpressionEngine.

Kesimpulan

Dengan mengikuti langkah-langkah di panduan ini, Anda seharusnya sudah berhasil menginstal dan mengonfigurasi ExpressionEngine CMS di lingkungan pengembangan lokal ServBay. ServBay menyediakan lingkungan yang nyaman dan efisien, lengkap dengan seluruh komponen penting untuk pengembangan lokal ExpressionEngine. Kini Anda dapat mulai membangun situs web atau aplikasi Anda dengan memaksimalkan fitur-fitur canggih dari ExpressionEngine. Selamat berkarya dan semoga sukses!