Pemasangan dan Konfigurasi Craft CMS dalam Persekitaran ServBay

Pengenalan

Craft CMS ialah sistem pengurusan kandungan (CMS) yang sangat berkuasa dengan pemodelan kandungan yang fleksibel, antara muka pengguna yang intuitif, serta ciri-ciri yang mesra pembangun. Ia sangat sesuai untuk membina laman web yang kompleks dan tersuai.

Menggunakan ServBay sebagai persekitaran pembangunan tempatan untuk Craft CMS memberikan banyak kelebihan—antaranya PHP dan pangkalan data (seperti MySQL atau PostgreSQL) telah dipra-konfigurasi; pelayan web (Caddy atau Nginx) tersedia; Composer dan alat baris perintah terbina dalam; jadi proses pemasangan serta konfigurasi menjadi amat mudah dan pantas.

Panduan ini akan menerangkan secara terperinci cara untuk memasang dan mengkonfigurasi projek Craft CMS dalam persekitaran ServBay.

Prasyarat

Sebelum anda bermula, pastikan anda sudah mempunyai perkara berikut:

1. ServBay telah dipasang dan sedang dijalankan: Pastikan ServBay telah berjaya dipasang pada macOS anda, dan versi PHP yang diperlukan (Craft CMS mempunyai keperluan khusus — sila rujuk dokumentasi rasmi Craft CMS) serta perisian pangkalan data (biasanya MySQL atau PostgreSQL) juga telah dimulakan. ServBay menyokong pelbagai versi PHP dan pangkalan data, memudahkan anda menukar dan mengkonfigurasi mengikut keperluan Craft CMS.
2. Fahami asas operasi baris perintah: Anda akan menggunakan terminal untuk menjalankan beberapa arahan, misalnya untuk membuat direktori dan menjalankan Composer.
3. Faham penggunaan Composer: Craft CMS menguruskan kebergantungan melalui Composer. ServBay telah sedia dengan Composer, tetapi anda perlu tahu cara menggunakan arahan composer create-project.

Langkah-langkah Pemasangan Craft CMS

Berikut ialah langkah-langkah terperinci untuk memasang dan mengkonfigurasi Craft CMS di persekitaran ServBay.

Langkah 1: Buat Direktori Projek

Mula-mula, cipta satu direktori projek baharu dalam direktori root laman biasa ServBay /Applications/ServBay/www. Direktori ini telah ditetapkan sebagai root pelayan web oleh ServBay untuk memudahkan anda akses ke projek secara langsung.

Buka terminal dan jalankan arahan berikut:

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

Langkah ini akan mencipta satu folder baru bernama servbay-craft-app dalam /Applications/ServBay/www dan anda akan masuk ke folder tersebut.

Langkah 2: Cipta Projek Craft CMS Menggunakan Composer

Composer telah disediakan bersama ServBay, jadi anda boleh terus gunakan Composer di direktori projek untuk mencipta projek Craft CMS. Memasang melalui Composer adalah kaedah disyorkan oleh laman rasmi Craft CMS.

Di dalam direktori servbay-craft-app, jalankan:

composer create-project craftcms/craft .

Arahan ini akan memuat turun versi terbaru Craft CMS bersama semua kebergantungan ke direktori semasa (.). Sila tunggu sehingga Composer selesai proses muat turun dan pemasangan.

Langkah 3: Cipta Pangkalan Data dan Pengguna

Craft CMS memerlukan satu pangkalan data untuk menyimpan kandungan dan maklumat konfigurasi. Kita akan gunakan alat pengurusan pangkalan data yang tersedia dalam ServBay iaitu phpMyAdmin atau Adminer. Contoh di bawah menggunakan phpMyAdmin.

1. Akses alat pengurusan pangkalan data ServBay (phpMyAdmin)

   Buka pelayar dan lawati panel pembangunan tempatan ServBay di https://servbay.host/. Cari dan klik pautan "phpMyAdmin" di panel tersebut untuk masuk ke alat pengurusan pangkalan data.

   Nota: Nama pengguna lalai untuk phpMyAdmin dalam ServBay biasanya root, dan kata laluan lalai ialah ServBay.dev. Untuk tujuan keselamatan, anda disyorkan untuk mengubah kata laluan pengguna root selepas log masuk, atau mencipta pengguna pentadbir baru.

2. Cipta pengguna pangkalan data baru

   Walaupun anda boleh menggunakan root untuk sambungan Craft CMS, demi keselamatan dan pengurusan kebenaran, amalan terbaik ialah mencipta pengguna pangkalan data tersendiri untuk setiap aplikasi.

   1. Pergi ke halaman 'Akaun Pengguna'

      Dari halaman utama phpMyAdmin, klik tab "Akaun Pengguna" pada menu atas.

   2. Tambah akaun pengguna baharu

      Klik "Tambah akaun pengguna" dan isikan:

      • Nama Pengguna: Isikan nama pengguna untuk sambungan Craft CMS, contohnya craft_user.
      • Hos: Pilih localhost atau tempatan supaya pengguna ini hanya boleh sambung dari mesin sendiri.
      • Kata Laluan: Tetapkan kata laluan yang kukuh. Elakkan contohnya seperti password123, lebih-lebih lagi untuk persekitaran produksi. Untuk pembangunan tempatan, kata laluan mudah boleh digunakan untuk kemudahan, tetapi sentiasa utamakan keselamatan.
      • Sahkan Kata Laluan: Masukkan sekali lagi untuk pengesahan.
      • Di bahagian "Cipta pangkalan data dengan nama sama pengguna dan berikan semua kebenaran", pilih pilihan ini. Ini akan terus mencipta satu pangkalan data bernama craft_user dan memberi kebenaran penuh kepada pengguna tersebut.
      • Pastikan pilihan "Berikan semua kebenaran" turut dipilih.
      • Klik butang "Laksana" di bahagian bawah.

   Kini, anda telah mencipta seorang pengguna bernama craft_user serta satu pangkalan data dengan nama yang sama, beserta kebenaran lengkap.

Langkah 4: Konfigurasi Pelayan Web (Cipta Laman Web dalam ServBay)

Agar pelayan web ServBay (Caddy/Nginx) dapat berkhidmat untuk projek Craft CMS anda, anda perlu menambah konfigurasi "laman web" baharu dalam aplikasi ServBay.

1. Buka aplikasi ServBay

   Lancarkan aplikasi ServBay pada Mac anda.

2. Tambah laman web baharu

   Klik tab "Laman Web" pada menu sebelah kiri aplikasi (di sesetengah versi lama mungkin dipanggil "Host"). Tekan butang "+" di bawah, atau "Tambah Laman Web" di bahagian kanan untuk menambah konfigurasi baru.

   Isikan maklumat seperti berikut:

   • Nama: Berikan nama mudah dikenalpasti, misalnya My Craft Site.
   • Domain: Masukkan domain yang anda ingin gunakan untuk akses tempatan, misalnya servbay-craft.local. ServBay akan auto-konfigurasi DNS tempatan supaya domain ini boleh digunakan.
   • Jenis Laman Web: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang anda telah sahkan serasi dengan Craft CMS (mengikut prasyarat di atas). ServBay membenarkan pelbagai versi PHP dijalankan serentak.
   • Root Laman Web (Website Root): Ini sangat penting! Fail boleh akses awam untuk Craft CMS terletak dalam subdirektori web di projek anda (fail seperti index.php). Demi keselamatan, root pelayan web mesti ditetapkan kepada folder web, bukannya root projek penuh. Isikan: /Applications/ServBay/www/servbay-craft-app/web Pastikan laluan ini tepat, menuju ke folder web yang dicipta pada langkah 1 tadi.

3. Simpan Konfigurasi

   Selepas lengkap, klik "Simpan". ServBay akan memuat semula konfigurasi pelayan web supaya laman baru sedia untuk digunakan. Anda kini boleh melihat laman servbay-craft.local dalam senarai laman web ServBay.

Langkah 5: Jalankan Pemasang Craft CMS

Sekarang, anda boleh jalankan pemasang web Craft CMS dengan melayari domain lokal yang telah anda konfigurasikan.

1. Akses laman pemasangan

   Dalam pelayar, lawati https://servbay-craft.local/. Craft CMS akan mengesan pemasangan belum selesai dan akan automatik redirect ke laman pemasangan, biasanya di https://servbay-craft.local/index.php?p=admin/install.

2. Isikan maklumat sambungan pangkalan data

   Pada langkah konfigurasi pangkalan data, masukkan maklumat seperti berikut (berdasarkan apa yang telah anda cipta dalam langkah 3):

   • Pelayan Pangkalan Data: localhost
   • Nama Pangkalan Data: craft_user (atau nama yang digunakan semasa cipta)
   • Nama Pengguna: craft_user (atau apa sahaja nama pengguna yang anda sediakan)
   • Kata Laluan: Kata laluan untuk craft_user seperti yang ditetapkan tadi.

   Klik seterusnya. Craft CMS akan menguji sambungan. Jika berjaya, anda akan ke langkah berikutnya.

3. Cipta akaun pentadbir

   Ikut arahan di halaman pemasangan untuk mencipta akaun admin Craft CMS; isi nama pengguna, kata laluan serta alamat emel anda. Pilih kata laluan yang kuat untuk keselamatan.

   Klik untuk teruskan.

4. Tetapan laman

   Masukkan nama laman dan maklumat asas lain yang diperlukan.

   Klik "Tamatkan Pemasangan (Finish Up)". Craft CMS akan melengkapkan proses akhir seperti mencipta jadual pangkalan data dan menghasilkan fail konfigurasi.

   Setelah pemasangan selesai, anda akan dihalakan ke halaman log masuk panel admin Craft CMS.

Langkah 6: Konfigurasi Awal dan Penerokaan

Selesai pemasangan, anda boleh log masuk ke panel admin Craft CMS dan melakukan konfigurasi tambahan:

1. Periksa fail .env: Craft CMS menggunakan fail .env untuk mengurus pembolehubah persekitaran, termasuk maklumat sambungan pangkalan data. Fail ini akan dijana automatik; boleh ditemui dalam root projek (servbay-craft-app/). Anda boleh sunting fail ini jika perlu—for example, untuk menetapkan CRAFT_ENVIRONMENT ke dev.
2. Pasang plugin: Dalam panel admin, klik "Plugin"—anda boleh cari, pasang serta urus plugin untuk memperluaskan fungsi Craft CMS.
3. Cipta struktur kandungan: Teroka bahagian "Tetapan", tentukan struktur seperti medan (fields), seksyen (sections), kategori (categories), tag (tags) dan lain-lain.
4. Konfigurasi penghantaran emel: Untuk ujian emel secara tempatan, anda boleh konfigurasi Craft CMS agar gunakan Mailpit atau Mailhog yang sedia dalam ServBay. Dalam fail .env atau melalui Tetapan Emel dalam panel admin, tetapkan kaedah kepada SMTP dan gunakan alamat pelayan biasanya localhost serta port SMTP untuk Mailpit/Mailhog (seperti dipaparkan dalam panel ServBay).

Soalan Lazim (FAQ)

• S: Bagaimana jika muncul ralat sambungan pangkalan data semasa memasang?
  • J: Sila semak kesemua maklumat yang dimasukkan pada pemasang Craft CMS—alamat pelayan pangkalan data (localhost), nama pangkalan data, nama pengguna dan kata laluan—supaya benar-benar sama dengan apa yang telah dibuat dalam phpMyAdmin. Pastikan servis pangkalan data (MySQL atau PostgreSQL) dalam ServBay berjalan.
• S: Jika akses servbay-craft.local menunjukkan 404 atau halaman kosong?
  • J:
    • Periksa root laman web yang disetkan dalam ServBay—pastikan ia tepat ke /Applications/ServBay/www/servbay-craft-app/web. Ini adalah kesilapan paling biasa.
    • Pastikan pelayan web (Caddy atau Nginx) dan perkhidmatan PHP dalam ServBay sedang dijalankan.
    • Semak sama ada konfigurasi laman web servbay-craft.local dalam senarai ServBay telah diaktifkan.
• S: Kenapa pemasangan Craft CMS menggunakan Composer sangat perlahan atau gagal?
  • J: Masalah ini biasanya berpunca dari sambungan internet atau sumber Composer. Cuba tukar mirror Composer kepada cermin tempatan seperti Alibaba Cloud atau Packagist China.
• S: Selepas pemasangan, kenapa panel admin atau halaman utama tiada gaya (CSS) atau imej tidak dipaparkan?
  • J: Masalah ini sering berkait dengan hak akses fail. Pastikan pengguna sistem yang menjalankan ServBay mempunyai keizinan menulis ke direktori seperti storage dan web/cpresources. ServBay lazimnya akan uruskan kebenaran ini secara automatik, tetapi jika ada masalah, periksa atau tetapkan semula hak akses ke folder berkaitan secara manual.

Rumusan

Dengan mengikuti langkah-langkah di atas, anda kini sepatutnya berjaya memasang dan mengkonfigurasi Craft CMS dalam persekitaran pembangunan tempatan menggunakan ServBay. ServBay menawarkan pengalaman pembangunan PHP yang mudah dengan pengurusan versi PHP, tetapan pangkalan data dan penyelenggaraan pelayan web yang telah dipermudahkan. Kini, anda boleh fokus membangunkan laman atau aplikasi anda menggunakan kelebihan pemodelan kandungan canggih yang ditawarkan oleh Craft CMS.