Memasang dan Mengkonfigurasi ExpressionEngine CMS dalam Persekitaran Tempatan ServBay

Pengenalan

ExpressionEngine ialah Sistem Pengurusan Kandungan (CMS) yang berkuasa dan fleksibel, digunakan secara meluas untuk membina pelbagai laman web dan aplikasi web yang kompleks. Ia menawarkan ciri teras yang meluas dan seni bina modular yang membolehkan pembangun serta pereka bentuk mereka cipta serta menyesuaikan laman dengan bebas.

ServBay pula merupakan persekitaran pembangunan web tempatan yang dikhaskan untuk macOS, menyediakan penyelesaian sehenti dengan integrasi pelbagai pelayan web popular (seperti Nginx, Caddy, Apache), runtime bahasa pengaturcaraan (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), pangkalan data (MySQL, PostgreSQL, MongoDB, Redis) serta alat pembangun (Composer, npm/yarn, phpMyAdmin/Adminer). Dengan ServBay, pembangun dapat mengurus dan membina persekitaran pembangunan tempatan dengan mudah.

Artikel ini akan menerangkan langkah demi langkah cara memasang dan mengkonfigurasi ExpressionEngine dalam persekitaran ServBay bagi membantu anda memulakan projek ExpressionEngine dengan pantas.

Kenapa Pilih ServBay untuk Memasang ExpressionEngine?

Kelebihan menggunakan ServBay untuk pemasangan ExpressionEngine secara tempatan:

• Persekitaran Bersepadu: ServBay menggabungkan semua komponen penting seperti runtime PHP, pangkalan data MySQL, dan pelayan web yang diperlukan ExpressionEngine, tanpa perlu pemasangan berasingan.
• Sokongan Pelbagai Versi: Anda boleh memilih atau bertukar antara pelbagai versi PHP dengan mudah sesuai keperluan ExpressionEngine.
• Pengurusan Pangkalan Data Mudah: ServBay dilengkapkan dengan phpMyAdmin atau Adminer untuk membolehkan penciptaan serta pengurusan pangkalan data bagi ExpressionEngine dengan mudah.
• Konfigurasi Laman Web Ringkas: Melalui antara muka grafik ServBay, anda boleh mencipta dan mengkonfigurasi laman web yang merujuk ke direktori projek ExpressionEngine anda hanya dalam beberapa langkah.
• Pengasingan & Pengurusan: ServBay membenarkan konfigurasi laman web tersendiri untuk setiap projek, mengelakkan konflik antara projek berlainan.

Keperluan Asas

Sebelum memulakan pemasangan, pastikan perkara berikut dipenuhi:

1. Komputer macOS anda telah memasang serta menjalankan ServBay. Jika belum, sila lawati Laman Web Rasmi ServBay untuk panduan pemasangan.
2. Mempunyai pengetahuan asas menggunakan terminal/command line.
3. Mempunyai kefahaman asas tentang konsep pangkalan data (seperti pangkalan data, pengguna).
4. Direktori root laman web ServBay, /Applications/ServBay/www, mempunyai kebenaran tulis.

Langkah Pemasangan

Kita akan ikut urutan langkah berikut untuk memasang dan mengkonfigurasi ExpressionEngine dalam persekitaran ServBay.

Langkah 1: Sediakan Direktori Projek & Muat Turun ExpressionEngine

Pertama, buka aplikasi terminal anda. Navigasi ke root laman web ServBay iaitu /Applications/ServBay/www, cipta direktori projek baru (contohnya servbay-ee-app), dan masuk ke dalam direktori tersebut.

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

Seterusnya, gunakan perintah curl untuk memuat turun versi terkini ExpressionEngine ke direktori semasa. Pilihan -L untuk ikut redirect, -o untuk nama fail output.

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

Langkah 2: Ekstrak Fail ExpressionEngine

Selepas muat turun siap, gunakan perintah unzip untuk mengekstrak fail expressionengine.zip ke dalam direktori servbay-ee-app. Selesai ekstrak, padamkan fail zip bagi menjimatkan ruang.

unzip expressionengine.zip
rm expressionengine.zip

Selepas diekstrak, struktur fail ExpressionEngine kini tersedia dalam direktori servbay-ee-app.

Langkah 3: Cipta Pangkalan Data & Pengguna ExpressionEngine

ExpressionEngine memerlukan satu pangkalan data untuk menyimpan kandungan dan konfigurasi. ServBay tersedia dengan MySQL dan phpMyAdmin memudahkan pengurusan ini.

1. Akses phpMyAdmin ServBay

   Buka pelayar web anda, lawati alamat alat tempatan ServBay: https://servbay.host/. Cari dan klik pautan "phpMyAdmin" untuk buka laman log masuk phpMyAdmin. Masukkan nama pengguna dan kata laluan pangkalan data ServBay (biasanya ServBay tidak memerlukan kata laluan untuk localhost dengan pemasangan lalai).

2. Cipta Pengguna & Pangkalan Data

   Selepas log masuk phpMyAdmin, kita akan cipta seorang pengguna dan pangkalan data khas untuk ExpressionEngine.

   • Ke laman urus akaun pengguna: Pada halaman utama phpMyAdmin, klik "Pengguna Akaun" di menu navigasi atas.
   • Tambah pengguna baru: Klik "Tambah Akaun Pengguna".
   • Isi maklumat pengguna & pangkalan data:
     • Nama pengguna: Contoh, ee_user untuk sambungan ExpressionEngine.
     • Hos: Pilih localhost (akses hanya dari tempatan; tambah keselamatan).
     • Kata laluan: Masukkan kata laluan selamat untuk pengguna ExpressionEngine. Ingat kata laluan ini. Contoh password123 untuk demo, tetapi pastikan kata laluan kukuh dalam pengeluaran.
     • Ulang semula: Masukkan semula kata laluan untuk pengesahan.
     • Cipta pangkalan data dengan nama pengguna: Tandakan pilihan ini ('Cipta pangkalan data dengan nama pengguna dan berikan semua keizinan'). Ia akan cipta pangkalan data bernama ee_user serta berikan kuasa penuh pada pengguna tersebut.
   • Sahkan keizinan: Pastikan bahagian "Keizinan Global" tidak memilih hak istimewa tidak perlu (kerana hak pangkalan data telah diberikan).
   • Jalankan: Klik "Jalankan" di bawah untuk selesaikan penciptaan pengguna dan pangkalan data.

   Kini anda mempunyai pangkalan data bernama ee_user serta pengguna: ee_user dengan kuasa penuh ke atasnya.

Langkah 4: Konfigurasi Laman Web dalam ServBay

Sekarang, kita perlu memberitahu ServBay bagaimana mengurus permintaan ke domain tertentu (cth. servbay-ee.local) serta menghalakannya ke direktori projek ExpressionEngine.

1. Buka ServBay & Tambah Laman Web Baru

   Buka antara muka grafik aplikasi ServBay. Di bar navigasi kiri, klik "Laman Web". Tekan butang "+" atau "Tambah" untuk cipta laman web baru.

   • Nama: Berikan nama mudah dikenali, seperti My ExpressionEngine Site.
   • Domain: Masukkan domain untuk akses tempatan laman, contohnya servbay-ee.local. ServBay akan menambah domain ini ke fail hosts dan mengarahkannya ke 127.0.0.1.
   • Jenis Laman Web: Pilih PHP, kerana ExpressionEngine dibina berasaskan PHP.
   • Versi PHP: Pilih versi PHP yang sesuai mengikut keperluan ExpressionEngine. ServBay membolehkan anda memilih antara pelbagai versi.
   • Root Dokumen: Klik butang carian untuk pilih direktori projek ExpressionEngine yang dicipta pada Langkah 1: /Applications/ServBay/www/servbay-ee-app.
   • Pelayan Web: Anda boleh pilih mana-mana pelayan web disokong ServBay — Nginx, Caddy, atau Apache. ServBay akan hasilkan fail konfigurasi pelayan secara automatik. Saranan: kekalkan tetapan lalai untuk pembangunan tempatan.

2. Simpan & Aktifkan Konfigurasi

   Selepas melengkapkan maklumat di atas, klik "Simpan" atau "Aktifkan". ServBay mungkin akan memerlukan anda memulakan semula pelayan untuk muat konfigurasi baru. Ikut arahan sehingga siap.

   Kini, akses https://servbay-ee.local/ dalam pelayar web anda akan membawa anda ke projek ExpressionEngine.

Langkah 5: Jalankan Pemasang Web ExpressionEngine

ExpressionEngine menyediakan pemasang berasaskan web bagi memudahkan konfigurasi akhir.

1. Akses Laman Pemasangan

   Buka pelayar web, lawati domain yang anda tetapkan pada ServBay berserta fail pemasang admin.php — secara default, pemasang ada di /admin.php.

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

   Anda seharusnya melihat laman selamat datang atau wizard pemasangan ExpressionEngine.

2. Ikut Wizard untuk Konfigurasi

   Wizard pemasangan ExpressionEngine memerlukan anda mengisi maklumat berikut:

   • Maklumat Sambungan Pangkalan Data:
     • Host Pangkalan Data: localhost
     • Nama Pangkalan Data: ee_user (sama seperti yang dicipta di Langkah 3)
     • Nama Pengguna: ee_user
     • Kata Laluan: Masukkan kata laluan untuk ee_user seperti di Langkah 3
   • Akaun Pentadbir: Cipta akaun pentadbir untuk panel belakang ExpressionEngine, termasuk nama pengguna, kata laluan dan alamat emel. Pastikan kata laluan yang dipilih selamat.
   • Konfigurasi Laman: Isi nama laman, URL, serta info asas lain.

3. Selesaikan Pemasangan

   Semak semua info yang diisi, kemudian klik "Pasang" atau butang selesai lain. ExpressionEngine akan membina jadual dalam pangkalan data dan menyiapkan sistem.

   Selesai pemasangan, anda biasanya akan dibawa ke halaman log masuk atau papan pemuka admin.

Langkah 6: Konfigurasi Asas Selepas Pemasangan

Selesai pemasangan teras, anda boleh memasang pemalam, templat, atau teruskan dengan tetapan awal lain.

1. Log Masuk ke Panel Belakang ExpressionEngine

   Gunakan akaun pentadbir yang baru dicipta untuk log masuk ke panel belakang ExpressionEngine, biasanya dengan melawat https://servbay-ee.local/admin.php dan mengisi maklumat log masuk.

2. Pasang Plugin

   Di dalam panel belakang, navigasi ke "Pembangun" -> "Add-Ons" -> "Plugins". Layari plugin yang tersedia dan pasang mengikut keperluan projek anda.

3. Pasang & Konfigurasi Templat

   Pergi ke "Reka Bentuk" -> "Templates". Di sini anda boleh cipta kumpulan templat, templat serta menulis HTML/CSS/kod EE untuk paparan kandungan laman web.

Mulakan Membangun Laman Anda dengan ExpressionEngine

Kini ExpressionEngine sudah berjaya dipasang serta dikonfigurasi dalam persekitaran ServBay. Anda boleh mula membina serta mengurus kandungan laman web menggunakan sistem ini. Berikut ialah beberapa langkah asas permulaan:

Cipta Saluran (Channel) dan Entri (Entry)

Konsep teras ExpressionEngine ialah “saluran” dan “entri”. Saluran mentakrif jenis serta struktur kandungan, entri pula ialah data sebenar.

1. Cipta Saluran: Dalam panel belakang, pergi ke "Struktur Kandungan" -> "Channel". Klik "Cipta Saluran Baru", isikan nama, kumpulan medan, dsb., dan klik "Simpan Saluran".
2. Cipta Entri: Pergi ke "Kandungan" -> "Publish". Pilih saluran yang dicipta, isi tajuk entri, kandungan berdasarkan medan saluran, dan maklumat lain, kemudian "Simpan".

Tetapkan Menu Navigasi

Menu navigasi biasanya dihasilkan melalui templat.

1. Cipta atau Edit Templat: Dalam "Reka Bentuk" -> "Templates", cipta templat untuk navigasi laman (contohnya dalam kumpulan templat site, cipta templat nav).
2. Tulis Kod Navigasi: Gunakan tag templat ExpressionEngine untuk membaca entri saluran atau halaman, kemudian bina struktur HTML navigasi.
3. Sisip Navigasi dalam Layout: Dalam templat layout utama, gunakan {% include 'site:nav' %} (jika menggunakan enjin Blade) atau tag padanan untuk memasukkan templat navigasi.

Sesuaikan Widget/Sidebar

Serupa dengan navigasi, sidebar atau widget lain juga biasanya dihasilkan melalui templat.

1. Cipta Templat Widget: Dalam "Reka Bentuk" -> "Templates", cipta templat khas misalnya site:sidebar.
2. Tulis Kod Widget: Di templat tersebut, paparkan entri terkini, senarai kategori, iklan, dan sebagainya sesuai keperluan.
3. Sisip Widget ke Layout: Import templat widget ke dalam layout page utama di lokasi diingini.

Soalan Lazim (FAQ)

• S: Mengapa dapat ralat kebenaran bila akses https://servbay-ee.local/?
  • J: Sila semak kebenaran direktori projek ExpressionEngine (/Applications/ServBay/www/servbay-ee-app) serta sub-direktori dan fail di dalamnya. Pastikan pengguna yang menjalankan ServBay (biasanya anda) mempunyai hak baca/tulis ke fail tersebut. Gunakan arahan chmod atau chown jika perlu, contohnya: sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app.
• S: Wizard pemasangan ExpressionEngine gagal sambung ke pangkalan data?
  • J: Semak semula maklumat sambungan (host localhost, nama pangkalan data, nama pengguna, kata laluan) sama seperti yang diwujudkan pada phpMyAdmin. Pastikan juga servis MySQL/MariaDB di ServBay sedang berjalan.
• S: Bolehkah saya gunakan pangkalan data lain seperti PostgreSQL dalam ServBay?
  • J: ExpressionEngine menyokong MySQL/MariaDB sebagai utama. Jika ExpressionEngine rasmi menyokong PostgreSQL dan anda ada pemacu serta cara konfigurasi, secara teori servis PostgreSQL oleh ServBay juga boleh digunakan — tetapi pastikan keserasian. Semak dokumentasi rasmi ExpressionEngine untuk maklumat lanjut jenis pangkalan data yang disokong.

Kesimpulan

Dengan mengikuti langkah panduan ini, anda kini sudah berjaya memasang serta mengkonfigurasi ExpressionEngine CMS dalam persekitaran pembangunan tempatan ServBay. ServBay menawarkan persekitaran tempatan yang cekap dan mudah untuk pembangunan ExpressionEngine dengan menggabungkan semua komponen penting. Kini anda boleh mula membina serta mengurus laman web atau aplikasi web anda dengan ExpressionEngine. Selamat maju jaya dalam pembangunan anda!