Memasang dan Mengkonfigurasi Contao CMS dalam Persekitaran ServBay

Contao ialah sistem pengurusan kandungan (CMS) sumber terbuka yang berkuasa, sesuai untuk membina laman web perniagaan kecil hingga sederhana, portal atau aplikasi web yang kompleks. Panduan ini menerangkan secara terperinci cara untuk memasang dan mengkonfigurasi Contao dalam persekitaran pembangunan web tempatan ServBay yang mudah digunakan di macOS, supaya anda dapat memulakan projek Contao anda dengan lancar.

ServBay menyediakan persekitaran pembangunan serba lengkap yang mengintegrasikan PHP, Composer, perkhidmatan pangkalan data (seperti MySQL/MariaDB, PostgreSQL) dan pelayan web (seperti Caddy, Nginx, Apache), menjadikan penyediaan persekitaran tempatan jauh lebih mudah. Dengan ServBay, anda dengan mudah dapat memenuhi keperluan operasi Contao.

Apa itu Contao?

Contao ialah CMS sumber terbuka berasaskan PHP yang terkenal dengan antara muka pentadbiran mesra pengguna, fleksibiliti tinggi, dan ciri pengurusan yang mantap. Ia dilengkapi dengan pelbagai fungsi termasuk kawalan keizinan terperinci, kawalan versi, sokongan pelbagai bahasa, pengurusan imej responsif, serta seni bina modular yang membolehkan ciri tambahan dipasang dengan mudah. Falsafah teras Contao adalah menyediakan asas yang kukuh untuk pembangun dan pereka bentuk bagi mencipta laman web tersuai tanpa perlu bermula dari awal.

Prasyarat

Sebelum memulakan pemasangan Contao, pastikan perkara berikut telah dipenuhi:

1. ServBay Dipasang dan Berfungsi: Anda perlu memasang ServBay di macOS. Pastikan ServBay sedang dijalankan, dan versi PHP yang diperlukan (keperluan versi PHP Contao boleh didapati dalam Dokumentasi Rasmi Contao) bersama perkhidmatan pangkalan data (seperti MySQL atau MariaDB) telah diaktifkan dalam ServBay.
2. Composer: Composer sudah diintegrasikan secara lalai dalam ServBay, jadi anda tidak perlu memasangnya secara berasingan.
3. Akses Terminal: Anda perlu menggunakan terminal untuk menjalankan arahan Composer.

Langkah-langkah Memasang Contao

Bahagian ini akan membimbing anda secara langkah demi langkah untuk memasang dan mengkonfigurasi Contao dalam persekitaran ServBay.

Langkah 1: Cipta Direktori Projek

Mula-mula, navigasi ke direktori root laman web lalai ServBay /Applications/ServBay/www dan cipta subdirektori baharu untuk projek Contao anda.

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

Kita akan memasang Contao di dalam direktori servbay-contao-app.

Langkah 2: Cipta Projek Contao Menggunakan Composer

Pemasangan dan pengurusan Contao dicadangkan melalui Composer. Dengan Composer yang telah tersedia dalam ServBay, anda boleh menjalankan arahan berikut dalam direktori projek:

composer create-project contao/managed-edition .

Arahan ini akan memuat turun versi terkini Contao Managed Edition bersama semua kebergantungannya ke direktori semasa (.). Proses ini mungkin mengambil sedikit masa bergantung pada kelajuan internet anda.

Penjelasan Contao Managed Edition: contao/managed-edition ialah edisi rasmi Contao yang merangkumi teras Contao serta kebergantungan yang disyorkan, dan telah menstrukturkan projek secara standard. Perlu diingat, apabila memasang melalui managed-edition, direktori root laman web Contao ialah subdirektori web dalam direktori projek anda.

Langkah 3: Cipta Pangkalan Data dan Pengguna

Contao memerlukan pangkalan data untuk menyimpan kandungan dan konfigurasinya. ServBay menyediakan alat pengurusan pangkalan data yang mesra, seperti phpMyAdmin atau Adminer. Berikut contoh menggunakan phpMyAdmin:

1. Akses Alat Pengurusan Pangkalan Data phpMyAdmin dalam ServBay

   Buka alamat akses tempatan ServBay https://servbay.host/. Cari dan klik pautan ke phpMyAdmin pada halaman tersebut.

2. Cipta Pengguna Pangkalan Data

   Demi keselamatan, adalah dicadangkan untuk mencipta pengguna pangkalan data khusus bagi aplikasi Contao anda.

   a. Pergi ke Halaman Akaun Pengguna

   Pada halaman utama phpMyAdmin, klik tab "Akaun Pengguna" di menu atas.
   

   b. Tambah Akaun Pengguna Baru

   Klik "Tambah akaun pengguna". Isikan maklumat berikut:
   
   *   **Nama Pengguna:** Masukkan nama pengguna untuk sambungan pangkalan data Contao, contohnya `contao_user`.
   *   **Hos:** Pilih `localhost`. Ini bermakna pengguna hanya boleh sambung dari mesin tempatan, meningkatkan keselamatan.
   *   **Kata Laluan:** Masukkan **kata laluan yang kuat**. Jangan gunakan kata laluan mudah seperti `password123`. Untuk persekitaran sebenar, gunakan penjana kata laluan untuk menjana kata laluan yang kompleks.
   *   **Ulangi Kata Laluan:** Masukkan semula kata laluan yang ditetapkan.
   
   Dalam bahagian "Cipta pangkalan data untuk pengguna", biasanya pilih "Cipta pangkalan data dengan nama yang sama dan berikan semua keizinan". Ini akan membina sebuah pangkalan data bernama `contao_user` dan memberikan semua keizinan kepada pengguna `contao_user` yang baru anda cipta.
   
   *   Pastikan kotak "Berikan semua keizinan" ditanda.
   *   Klik "Laksana" di bahagian bawah halaman untuk mengesahkan penciptaan pengguna dan pangkalan data.
   

Langkah 4: Konfigurasi Laman Web dalam ServBay

Sekarang anda perlu mengkonfigurasi satu laman web dalam ServBay yang menunjuk ke direktori projek Contao anda.

1. Buka ServBay dan Tambahkan Laman Web Baru

   Lancarkan antaramuka utama aplikasi ServBay. Klik tab "Laman Web" di bar navigasi kiri, dan klik butang "Tambah" untuk mencipta konfigurasi laman web baharu.

2. Isi Maklumat Konfigurasi Laman Web

   • Nama: Berikan nama yang mudah dikenali, contohnya My Contao Site.
   • Domain: Tetapkan domain pembangunan tempatan; disyorkan menggunakan akhiran .local atau .servbay.demo contohnya servbay-contao.local. ServBay akan mengarahkan domain ini secara automatik ke alamat tempatan.
   • Jenis Laman Web: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang memenuhi keperluan sistem Contao. Sila rujuk dokumentasi rasmi Contao untuk versi yang sesuai.
   • Root Direktori Laman Web: Langkah ini sangat penting. Untuk projek yang dipasang menggunakan Composer contao/managed-edition, fail awam Contao (termasuk index.php) berada dalam subdirektori web. Maka, anda perlu masukkan laluan penuh ke direktori web: /Applications/ServBay/www/servbay-contao-app/web.

3. Simpan Konfigurasi

   Selepas mengisi semua maklumat, klik butang "Simpan" di bahagian bawah antaramuka ServBay. Konfigurasi laman web baharu akan digunakan.

Langkah 5: Jalankan Pemasang Web Contao

Selepas konfigurasi laman web siap, anda boleh mengakses domain yang telah anda tetapkan menggunakan pelayar untuk menjalankan pemasang web Contao.

1. Akses Halaman Pemasangan

   Buka pelayar web dan lawati domain yang anda konfigurasikan dalam ServBay, diikuti dengan laluan /contao/install. Contohnya: https://servbay-contao.local/contao/install.

   Jika semuanya telah dikonfigurasi dengan betul, anda akan melihat halaman pemasangan Contao.

2. Masukkan Maklumat Pangkalan Data

   Pemasang memerlukan maklumat sambungan pangkalan data. Isikan maklumat pengguna dan pangkalan data yang anda cipta pada Langkah 3:

   • Hos Pangkalan Data: localhost
   • Nama Pangkalan Data: contao_user (jika anda memilih “Cipta pangkalan data dengan nama pengguna” dalam phpMyAdmin)
   • Nama Pengguna: contao_user
   • Kata Laluan: Kata laluan yang anda tetapkan untuk contao_user pada Langkah 3.

3. Isi Maklumat Pentadbir

   Tetapkan nama pengguna pentadbir, kata laluan serta e-mel untuk admin backend Contao mengikut arahan pada skrin. Pastikan anda menggunakan kata laluan yang kukuh.

4. Selesaikan Pemasangan

   Ikuti langkah-langkah seterusnya dalam pemasang; ini biasanya termasuk pemasangan struktur jadual pangkalan data. Klik butang yang berkaitan (seperti "Pasang" atau "Selesai") untuk menyelesaikan pemasangan.

Langkah 6: Sahkan Pemasangan & Log Masuk ke Backend

Selepas pemasangan siap, anda boleh mengesahkan sama ada Contao berjalan dengan lancar dan cuba log masuk ke backend pentadbiran.

1. Akses Halaman Utama Laman Web

   Dalam pelayar, lawati domain yang telah anda set. Contohnya, https://servbay-contao.local/. Anda sepatutnya melihat laman selamat datang Contao (default) atau laman kosong (bergantung kepada konfigurasi). Ini menandakan pelayan web telah dikonfigurasikan dengan betul dan frontend Contao boleh diakses.

2. Akses Backend Pentadbir Contao

   Akses halaman log masuk backend Contao di https://servbay-contao.local/contao.

   Gunakan nama pengguna dan kata laluan pentadbir yang anda tetapkan pada Langkah 5. Jika log masuk berjaya, anda telah memasuki antara muka pentadbiran Contao, dan kini boleh mula mencipta kandungan, memasang sambungan dan mengkonfigurasi laman web anda.

Soalan Lazim (FAQ)

S: Bagaimana jika terdapat ralat ketika mengakses https://servbay-contao.local/ atau https://servbay-contao.local/contao/install?

J:

• Periksa ServBay Sama Ada Berjalan: Pastikan aplikasi ServBay sedang berjalan, dan servis PHP serta pelayan Web (Caddy atau Nginx) telah dihidupkan.
• Periksa Konfigurasi Laman Web ServBay: Sahkan semula konfigurasi laman yang anda cipta dalam ServBay—terutamanya domain, jenis laman web, versi PHP dan root direktori laman web. Ingat bahawa root laman web untuk pemasangan contao/managed-edition adalah dalam direktori web.
• Periksa Resolusi Domain: ServBay akan menguruskan resolusi domain .local secara automatik. Jika menggunakan akhiran lain atau menghadapi isu, anda boleh cuba restart ServBay atau semak fail hosts sistem (walaupun biasanya ServBay mengurusnya secara automatik).
• Semak Log Pelayan Web: Lihat log pelayan web (Caddy atau Nginx) yang disediakan oleh ServBay untuk maklumat ralat yang lebih terperinci.

S: Apa harus dibuat jika sambungan pangkalan data gagal?

J:

• Periksa Status Perkhidmatan Pangkalan Data: Pastikan perkhidmatan MySQL/MariaDB atau PostgreSQL dalam ServBay sudah berjalan.
• Semak Kelayakan Pangkalan Data: Sahkan maklumat tuan rumah (localhost), nama pangkalan data, nama pengguna, dan kata laluan yang anda masukkan dalam pemasang Contao sepadan dengan yang dicipta dalam phpMyAdmin.
• Periksa Hak Akses Pengguna: Pastikan pengguna pangkalan data yang anda cipta mempunyai semua keizinan ke atas pangkalan data Contao.

S: Bagaimana jika berlaku ralat keizinan semasa pemasangan?

J: Pemasang Contao memerlukan keizinan menulis pada beberapa direktori. Walaupun konfigurasi lalai ServBay biasanya memadai, sekiranya ada masalah, anda boleh tetapkan keizinan direktori projek Contao menggunakan terminal:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # Gantikan your_username dengan nama pengguna macOS anda
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao mungkin memerlukan keizinan tulis pada direktori ini

Gunakan chmod 777 dengan berhati-hati; ia tidak selamat untuk persekitaran produksi, tetapi biasa digunakan dalam pembangunan tempatan bagi mengatasi isu keizinan.

Rumusan

Dengan mengikuti panduan ini, anda sepatutnya telah berjaya memasang dan mengkonfigurasi Contao CMS dalam persekitaran pembangunan tempatan ServBay. Persekitaran bersepadu ServBay memudahkan pengurusan kebergantungan Composer, penetapan pangkalan data dan konfigurasi pelayan web, membolehkan anda lebih fokus dalam pembangunan Contao. Kini, anda boleh mula mencipta kandungan, mereka bentuk halaman, memasang sambungan dan tema serta membina laman web anda melalui backend Contao.

Untuk maklumat dan panduan lanjut tentang penggunaan serta ciri-ciri Contao, sila rujuk Dokumentasi Rasmi Contao.