Memasang dan Mengkonfigurasi OctoberCMS di Persekitaran ServBay

Pengenalan

OctoberCMS ialah sistem pengurusan kandungan (CMS) sumber terbuka yang dibina di atas kerangka kerja Laravel yang berkuasa. Ia digemari kerana cirinya yang ringkas, fleksibel, dan mesra pembangun. Dokumen ini bertujuan untuk membimbing anda bagaimana memasang dan mengkonfigurasi OctoberCMS dengan jayanya di ServBay—persekitaran pembangunan web tempatan serba lengkap yang direka untuk macOS—supaya anda boleh mula membangunkan projek berasaskan OctoberCMS dengan mudah dan pantas.

Apakah OctoberCMS?

OctoberCMS menawarkan antara muka pentadbir yang intuitif dan keupayaan pembangunan frontend yang kuat, membolehkan pembangun menggunakan konsep Laravel yang biasa (seperti Eloquent ORM, enjin templat Blade dan lain-lain) untuk membina pelbagai jenis laman web, daripada blog ringkas hingga ke aplikasi perusahaan yang kompleks.

Prasyarat

Sebelum memulakan pemasangan OctoberCMS, pastikan anda memenuhi keperluan berikut:

1. ServBay telah dipasang dan sedang berjalan pada sistem macOS anda.
2. Pakej perisian PHP (disarankan versi 7.4 ke atas) dan MySQL/MariaDB telah diaktifkan dan berjalan dalam ServBay.
3. Pakej Composer telah diaktifkan dalam ServBay.
4. Anda mempunyai pengetahuan asas untuk bekerja dengan terminal/konsol.

Langkah-langkah Memasang OctoberCMS

Berikut adalah langkah-langkah terperinci untuk memasang dan mengkonfigurasi OctoberCMS dalam persekitaran ServBay:

Langkah 1: Mencipta Direktori Projek

Mula-mula, navigasi ke direktori root web yang disyorkan oleh ServBay iaitu /Applications/ServBay/www, kemudian cipta folder baharu untuk projek OctoberCMS anda.

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

Langkah 2: Memasang OctoberCMS dengan Composer

ServBay telah siap dengan Composer yang telah dikonfigurasi dengan betul. Pastikan anda telah mengaktifkan pakej Composer pada panel kawalan ServBay. Sekarang, dalam direktori projek yang baru anda buat, jalankan arahan Composer untuk memuat turun dan memasang fail teras OctoberCMS:

composer create-project october/october .

Arahan ini akan memuat turun versi terkini OctoberCMS dari repositori rasmi ke direktori semasa (.).

Langkah 3: Mencipta Pangkalan Data dan Pengguna

OctoberCMS memerlukan pangkalan data untuk menyimpan kandungan, pengguna, konfigurasi dan sebagainya. Kita akan menggunakan alat phpMyAdmin yang disediakan oleh ServBay untuk mencipta pangkalan data serta pengguna yang berkaitan.

1. Akses Alat Pengurusan Pangkalan Data phpMyAdmin dalam ServBay

   Buka pelayar web anda dan kunjungi panel pembangunan tempatan ServBay di https://servbay.host/. Klik atau navigasi ke pautan phpMyAdmin yang disediakan oleh ServBay, biasanya pada https://servbay.host/phpmyadmin/, untuk memasuki alat pengurusan pangkalan data phpMyAdmin.

2. Cipta Pengguna Pangkalan Data

   Demi keselamatan dan keterasingan, disarankan mencipta pengguna dan pangkalan data yang berasingan untuk setiap aplikasi.

   1. Masuk ke Halaman Akaun Pengguna

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

   2. Tambah Akaun Pengguna Baru

      Klik pada "Tambah Akaun Pengguna". Isikan maklumat berikut:

      • Nama Pengguna: Masukkan nama pengguna yang akan digunakan OctoberCMS untuk menyambung ke pangkalan data, contohnya october_user.
      • Nama Host: Pilih localhost atau 127.0.0.1 untuk memastikan hanya sambungan tempatan dibenarkan, demi keselamatan.
      • Kata Laluan: Syaratkan kata laluan unik dan selamat. Jangan guna contoh kata laluan password123 dalam persekitaran produksi!
      • Pengesahan Semula Kata Laluan: Masukkan sekali lagi kata laluan anda.
      • Pada bahagian "Buat pangkalan data untuk pengguna", pilih "Cipta pangkalan data dengan nama sama dan berikan semua keizinan". Ini akan mencipta pangkalan data bernama october_user dan menganugerahkan segala keizinan kepada pengguna tersebut.
      • Pastikan pilihan "Berikan semua keizinan" di bawah "Keizinan Global" telah ditandakan (jika anda sudah memilih untuk cipta dan beri keizinan pada langkah sebelum ini, ini biasanya berlaku secara automatik atau tidak memerlukan tindakan lanjut).
      • Klik butang "Laksana" di bawah untuk mengesahkan penciptaan pengguna dan pangkalan data.

Langkah 4: Konfigurasi Pelayan Web (Tambah Laman Web pada ServBay)

Untuk mengakses aplikasi OctoberCMS anda melalui pelayar, anda perlu menambah satu laman web tempatan pada ServBay.

1. Tambah Laman Web Baharu

   Buka panel kawalan ServBay dan klik tab "Laman Web" pada bar navigasi kiri (versi lama mungkin tertulis "Hos"). Klik butang "Tambah Laman Web".

   Isikan maklumat berikut:

   • Nama: Berikan nama mudah diingati, contohnya My OctoberCMS Site.
   • Domain: Masukkan domain tempatan yang anda ingin gunakan, contohnya servbay-octobercms.local. Gunakan akhiran .local untuk elak konflik dengan nama domain sebenar.
   • Jenis Laman Web: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang serasi dengan OctoberCMS dan telah diaktifkan dalam ServBay.
   • Root Laman Web: Klik butang layari dan pilih direktori projek yang anda cipta pada langkah 1 iaitu /Applications/ServBay/www/servbay-octobercms-app.

2. Simpan Konfigurasi & Mulakan Semula ServBay

   Setelah selesai, klik butang simpan. ServBay akan meminta anda untuk mengaplikasikan perubahan, biasanya dengan memulakan semula perisian yang berkaitan (seperti Caddy atau Nginx) serta ServBay itu sendiri. Ikut arahan yang dipaparkan untuk memastikan perubahan berkuat kuasa. ServBay akan secara automatik mengarahkan domain servbay-octobercms.local ke sistem tempatan (127.0.0.1).

Langkah 5: Konfigurasi Pembolehubah Persekitaran OctoberCMS

OctoberCMS (berasaskan Laravel) menggunakan fail .env untuk mengurus pembolehubah persekitaran aplikasi, termasuk maklumat sambungan pangkalan data, kunci aplikasi dan lain-lain.

1. Salin Fail Contoh Konfigurasi Persekitaran

   Dalam direktori root projek OctoberCMS anda (/Applications/ServBay/www/servbay-octobercms-app), salin fail .env.example lalu ubah namanya kepada .env:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. Edit Fail .env

   Guna editor teks kegemaran anda, buka fail .env yang baru anda cipta tadi. Cari bahagian konfigurasi berkaitan pangkalan data dan sesuaikan dengan maklumat pangkalan data yang anda buat pada Langkah 3:

   # ... konfigurasi lain ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Gantikan dengan nama pangkalan data yang anda cipta
   DB_USERNAME=october_user  # Gantikan dengan nama pengguna pangkalan data yang anda cipta
   DB_PASSWORD=password123   # Gantikan dengan kata laluan yang anda tetapkan
   
   # ... konfigurasi lain ...

   Penting: Sila pastikan nilai untuk DB_DATABASE, DB_USERNAME, dan DB_PASSWORD digantikan dengan maklumat sebenar yang anda gunakan pada langkah 3.

Langkah 6: Jalankan Pemasang OctoberCMS

OctoberCMS menyediakan wizard pemasangan berasaskan web untuk melengkapkan konfigurasi akhir, termasuk migrasi pangkalan data dan penciptaan akaun pentadbir.

1. Akses Laman Pemasangan

   Buka pelayar web, lawati domain tempatan yang anda konfigurasikan pada langkah 4 dan tambahkan /install.php pada hujung URL. Contohnya:

   https://servbay-octobercms.local/install.php

   Anda sepatutnya akan melihat halaman wizard pemasangan OctoberCMS.

2. Isi Maklumat Pangkalan Data

   Wizard pemasangan akan meminta anda mengisi maklumat sambungan pangkalan data. Sila masukkan butiran yang sama seperti di fail .env anda:

   • Jenis Pangkalan Data: MySQL
   • Hos Pangkalan Data: localhost atau 127.0.0.1
   • Nama Pangkalan Data: october_user
   • Nama Pengguna Pangkalan Data: october_user
   • Kata Laluan Pangkalan Data: password123

   (Sekali lagi, pastikan anda menggunakan kata laluan sebenar yang anda tetapkan)

3. Isi Maklumat Pentadbir

   Teruskan isian maklumat akaun pentadbir yang anda ingin gunakan untuk log masuk ke panel belakang OctoberCMS seperti nama pengguna, kata laluan, emel dan lain-lain.

4. Lengkapkan Pemasangan

   Klik "Pasang" atau butang yang setara pada halaman wizard. Pemasang akan menjalankan migrasi pangkalan data, penjanaan kunci aplikasi dan sebagainya. Tunggu sehingga proses pemasangan selesai.

Langkah 7: Pasang Plugin & Tema (Pilihan)

Selepas pemasangan berjaya, anda boleh log masuk ke panel pentadbir OctoberCMS di https://servbay-octobercms.local/backend.

1. Pasang Plugin

   Dalam panel pentadbir, navigasi ke "Sistem" -> "Kemas Kini" -> "Plugin". Anda boleh cari dan pasang pelbagai plugin dari OctoberCMS Marketplace untuk menambah fungsi baru.

2. Pasang Tema

   Navigasi ke "Sistem" -> "Kemas Kini" -> "Tema". Anda boleh lihat dan pasang tema yang sesuai dengan keperluan projek anda.

Konfigurasi & Penggunaan Asas Selepas Pemasangan

Dengan OctoberCMS yang berjaya dipasang, anda boleh mula membina laman web anda. Berikut beberapa langkah asas yang biasa dilakukan:

• Akses Laman Utama: Layari domain tempatan anda https://servbay-octobercms.local/ untuk melihat laman utama (biasanya memaparkan tema lalai).
• Akses Pentadbir: Layari https://servbay-octobercms.local/backend dan log masuk menggunakan akaun pentadbir yang anda cipta sewaktu pemasangan.
• Cipta Halaman: Pada panel belakang, navigasi ke "CMS" -> "Halaman" untuk mencipta dan sunting halaman web anda.
• Cipta Blok Kandungan: Melalui "CMS" -> "Kandungan", cipta fragmen kandungan yang boleh digunakan semula.
• Konfigurasi Tema: Di bawah "CMS" -> "Tema", anda boleh tetapkan konfigurasi tema, susun atur atau bahagian yang digunakan.
• Pengurusan Pengguna & Kebenaran: Di bawah "Sistem" -> "Pengurusan", anda boleh urus pengguna dan kebenaran mereka di panel belakang.

Soalan Lazim (FAQ)

• S: Mengapa servbay-octobercms.local memaparkan halaman lalai ServBay atau ralat?
  • J: Sila semak sama ada anda telah menambah laman web servbay-octobercms.local dengan betul pada panel kawalan ServBay dan root laman web telah ditetapkan ke /Applications/ServBay/www/servbay-octobercms-app. Pastikan anda telah mulakan semula ServBay selepas menambah atau mengedit laman web. Semak juga status pakej Caddy/Nginx dan PHP dalam ServBay.
• S: Halaman https://servbay-octobercms.local/install.php kosong atau ada ralat?
  • J: Ini biasanya berpunca dari ralat PHP. Semak log ralat PHP pada panel kawalan ServBay untuk maklumat lanjut. Punca biasa termasuk masalah kebenaran fail (pastikan folder storage, themes, plugins boleh ditulis oleh pengguna pelayan web), ketidakserasian versi PHP, atau kekurangan sambungan PHP.
• S: Ralat sambungan pangkalan data sewaktu pemasangan?
  • J: Sila semak maklumat sambungan pangkalan data dalam fail .env (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) dan pastikan ia tepat seperti yang anda cipta pada phpMyAdmin. Juga, pastikan pakej MySQL/MariaDB sedang berjalan dalam ServBay.
• S: Kenapa arahan composer create-project gagal?
  • J: Pastikan pakej Composer telah diaktifkan dalam panel kawalan ServBay. Pakej PHP yang bersesuaian juga perlu diaktifkan dan mengikut versi yang betul. Semak sambungan internet anda kerana Composer perlu memuat turun fail.

Kesimpulan

Dengan kemudahan yang disediakan oleh ServBay, anda boleh memasang dan mengkonfigurasikan OctoberCMS di macOS dengan mudah dan pantas. Ikut setiap langkah dalam panduan ini untuk membina platform pembangunan tempatan yang berkuasa dan mesra pembangun untuk projek web anda yang seterusnya. Kini, anda boleh mula meneroka ciri-ciri hebat OctoberCMS dan membina laman web impian anda!