Memasang dan Mengkonfigurasi Drupal di Persekitaran Pembangunan Tempatan ServBay

Pengenalan

Drupal ialah sistem pengurusan kandungan (CMS) sumber terbuka yang berkuasa, fleksibel dan boleh diskalakan, digunakan secara meluas untuk membangunkan pelbagai jenis laman web—daripada blog peribadi, laman syarikat kecil, hingga ke portal korporat berskala besar serta aplikasi web yang kompleks. Ia menawarkan alat pengurusan kandungan yang kaya, kawalan kebenaran pengguna yang terperinci dan seni bina modular yang mantap, sesuai untuk pembangun yang memerlukan penyesuaian tinggi dan prestasi maksimum.

ServBay merupakan alat persekitaran pembangunan web tempatan yang direka khusus untuk macOS, menggabungkan pelayan web utama (seperti Caddy, Nginx), pelbagai bahasa pengaturcaraan (PHP, Node.js, Python, Go, Java dan lain-lain), pangkalan data (seperti MySQL, PostgreSQL, MongoDB, Redis), serta alat pengurusan projek termasuk Composer, npm dan sebagainya. Memasang serta mengkonfigurasi Drupal dalam ServBay menyediakan platform pembangunan tempatan yang stabil, mudah digunakan, dan serba lengkap.

Dokumen ini akan membimbing anda langkah demi langkah untuk memasang dan mengkonfigurasi Drupal pada persekitaran ServBay, supaya anda boleh membina persekitaran pembangunan Drupal tempatan dengan pantas.

Prasyarat

Sebelum memulakan pemasangan Drupal, pastikan perkara berikut dipenuhi:

1. ServBay telah dipasang dan berjalan: Pastikan anda telah berjaya memasang ServBay pada macOS dan sedang menjalankan aplikasi tersebut.
2. Pengetahuan asas penggunaan ServBay: Anda memahami cara mengurus pakej perisian, menambah laman web dan mengakses alat terbina dalam (seperti phpMyAdmin) melalui antaramuka ServBay.
3. PHP dan MySQL/MariaDB telah dipasang: ServBay secara lalai menyediakan pelbagai versi PHP dan perkhidmatan pangkalan data seperti MySQL atau MariaDB. Pastikan versi PHP yang anda ingin gunakan telah diaktifkan dan perkhidmatan pangkalan data telah dimulakan.
4. Composer telah tersedia: Composer telah diintegrasi dalam ServBay secara lalai, dan ini adalah alat penting bagi pengurusan projek PHP moden. Panduan ini akan menggunakan Composer untuk membina projek Drupal.

Langkah-Langkah Pemasangan Drupal

Berikut ialah langkah-langkah terperinci untuk memasang dan mengkonfigurasi Drupal dalam persekitaran ServBay:

Langkah 1: Cipta Direktori Projek

Mula-mula, anda perlu mencipta satu subdirektori khusus bagi projek Drupal di dalam direktori root laman web ServBay iaitu /Applications/ServBay/www.

Buka aplikasi Terminal dan jalankan perintah berikut:

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

Ini akan menghasilkan satu folder baharu bernama servbay-drupal-app di bawah /Applications/ServBay/www, dan anda akan memasuki folder tersebut.

Langkah 2: Cipta Projek Drupal Menggunakan Composer

Composer telah tersedia dalam ServBay, jadi tiada pemasangan tambahan diperlukan. Laman web rasmi Drupal mengesyorkan penggunaan Composer untuk pembinaan serta pengurusan kebergantungan projek.

Di dalam direktori servbay-drupal-app yang anda cipta tadi, jalankan arahan Composer berikut:

composer create-project drupal/recommended-project .

Arahan ini akan mencipta projek Drupal baru di direktori semasa (.) menggunakan templat drupal/recommended-project. Composer akan memuat turun fail teras serta semua kebergantungan utama Drupal. Proses ini mungkin mengambil sedikit masa bergantung pada kelajuan Internet anda.

Templat drupal/recommended-project akan meletakkan semua fail yang boleh dicapai secara umum (seperti index.php, fail CSS, JavaScript, dsb.) dalam subdirektori bernama web. Struktur ini kini menjadi standard bagi projek-projek Drupal kerana ia dapat meningkatkan keselamatan.

Langkah 3: Cipta Pangkalan Data dan Pengguna

Drupal memerlukan pangkalan data untuk menyimpan kandungan, konfigurasi dan data pengguna. 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 dan lawati papan pemuka utama ServBay melalui: https://servbay.host/. Dalam papan pemuka tersebut, cari dan klik pautan "phpMyAdmin" (biasanya terletak di bahagian "Alat" atau "Pangkalan Data") untuk memasuki antaramuka phpMyAdmin.

   servbay.host ialah domain khas yang disediakan oleh ServBay untuk kemudahan pembangunan tempatan—domain ini menunjuk ke antaramuka pengurusan dalaman ServBay.

2. Cipta Pengguna Pangkalan Data

   Disarankan agar anda mencipta akaun pengguna pangkalan data khusus untuk projek Drupal demi keselamatan dan pengurusan kebenaran yang lebih baik.

   • Pergi ke halaman akaun pengguna: Dalam halaman utama phpMyAdmin, klik tab "Akaun Pengguna" pada menu navigasi atas.
   • Tambah pengguna baru: Klik pada "Tambah Akaun Pengguna".
   • Isi maklumat pengguna:
     • Nama pengguna: Masukkan nama akaun pilihan anda, contohnya drupal_user.
     • Nama hos: Pilih atau masukkan localhost, supaya pengguna ini hanya boleh mengakses pangkalan data dari mesin tempatan—ini meningkatkan keselamatan.
     • Kata laluan: Masukkan satu kata laluan yang selamat. Jangan gunakan kata laluan lemah, contoh dalam demo (password123) hanya untuk tujuan pembelajaran. Dalam projek sebenar, gunakan penjana kata laluan untuk mencipta kata laluan yang kompleks dan kuat.
     • Ulang kata laluan: Masukkan semula kata laluan anda.
   • Tetapan hak akses pangkalan data: Di bahagian "Cipta pangkalan data bagi pengguna" tandakan pilihan "Cipta pangkalan data dengan nama yang sama dan berikan semua hak akses." Opsyen ini akan secara automatik mencipta satu pangkalan data dengan nama yang sama seperti akaun pengguna (drupal_user) dan memberikan semua hak kepada pengguna itu atas pangkalan data tersebut.
   • Hak akses global: Pastikan anda tidak menandakan hak "Beri semua hak akses global" kecuali anda benar-benar memerlukannya. Pengguna hanya perlukan hak akses penuh ke atas pangkalan data yang baru dicipta.
   • Sahkan dan cipta: Semak semula semua maklumat, kemudian klik pada butang "Laksanakan" di sudut kanan bawah halaman.

   Kini, anda telah berjaya mencipta pangkalan data bernama drupal_user dan pengguna pangkalan data drupal_user yang mempunyai hak akses penuh ke atas pangkalan data tersebut.

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

Seterusnya, anda perlu menambah konfigurasi laman web baru dalam ServBay, supaya domain tempatan menunjuk ke direktori web projek Drupal anda.

1. Buka UI ServBay: Lancarkan aplikasi ServBay.
2. Tambah laman web baharu: Klik pada tab "Laman Web" pada bar navigasi kiri.
3. Klik butang tambah: Pada halaman senarai laman web, klik butang "+" atau butang tambah yang berkaitan untuk mencipta konfigurasi laman web baru.
4. Isi maklumat laman web:
   • Nama: Masukkan nama laman web yang mudah dikenali, contohnya My Drupal Site.
   • Domain: Masukkan domain tempatan yang anda ingin gunakan untuk mengakses Drupal, misalnya servbay-drupal.local. ServBay menyokong domain tempatan berakhiran .local tanpa perlu mengubah fail hosts sistem.
   • Jenis laman web: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang ingin anda gunakan untuk laman Drupal ini dari menu dropdown. Pastikan versi tersebut serasi dengan versi Drupal yang anda pasang (rujuk dokumentasi rasmi Drupal untuk syarat versi PHP).
   • Root Direktori Laman: Ini sangat penting. Direktori root mestilah menunjuk ke subdirektori projek (hasil daripada pemasangan Composer di Langkah 2) yang mengandungi fail kemasukan index.php, iaitu dalam web. Jadi, tetapkan path root laman kepada /Applications/ServBay/www/servbay-drupal-app/web.
5. Simpan konfigurasi: Selepas semua maklumat diisi, klik "Simpan" atau butang berkaitan pada antara muka ServBay untuk menyimpan konfigurasi laman web baru. ServBay akan secara automatik mengemas kini konfigurasi pelayan web serta mengaktifkan laman tersebut.

Langkah 5: Jalankan Pemasangan Drupal

Kini anda boleh melancarkan pemasang web Drupal dengan melayari domain tempatan yang telah dikonfigurasi.

1. Akses halaman pemasangan

   Buka pelayar web dan pergi ke domain tempatan yang anda tetapkan (di Langkah 4), tambahkan /core/install.php di hujungnya—contohnya: https://servbay-drupal.local/core/install.php.

   Anda sepatutnya melihat halaman wizard pemasangan Drupal.

2. Pilih bahasa

   Pilih bahasa yang ingin digunakan untuk laman Drupal anda dan klik "Simpan dan Teruskan".

3. Pilih konfigurasi pemasangan

   Pilih jenis pemasangan yang dikehendaki. Lazimnya, pilih "Standard" untuk mendapatkan konfigurasi laman lalai yang mengandungi ciri-ciri umum. Klik "Simpan dan Teruskan".

4. Masukkan maklumat pangkalan data

   Pemasang akan meminta maklumat sambungan pangkalan data yang telah anda cipta pada Langkah 3:

   • Jenis Pangkalan Data: Pilih MySQL, MariaDB, Percona Server, or equivalent.
   • Nama pangkalan data: Masukkan drupal_user (sama seperti nama pangkalan data yang anda cipta).
   • Nama pengguna pangkalan data: Masukkan drupal_user.
   • Kata laluan pangkalan data: Masukkan kata laluan yang anda tetapkan kepada drupal_user.
   • Hos pangkalan data: Masukkan localhost.
   • Pilihan lanjutan: Tidak perlu diubah kecuali anda menggunakan port bukan standard atau konfigurasi khas.

   Setelah diisi, klik "Simpan dan Teruskan". Drupal akan cuba menyambung ke pangkalan data dan mengimport data permulaan.

5. Isi maklumat laman web

   Jika sambungan ke pangkalan data berjaya, pemasang akan membawa anda ke tahap konfigurasi laman. Masukkan maklumat berikut:

   • Nama laman web: Tajuk website anda.
   • Alamat emel laman: Emel untuk notifikasi dari laman web.
   • Nama pengguna pentadbir: Nama pengguna untuk akses pentadbiran.
   • Kata laluan pentadbir: Tetapkan kata laluan yang selamat untuk akaun admin.
   • Negara: Pilih negara anda.
   • Zon masa: Pilih zon waktu anda.

   Selepas diisi, klik "Simpan dan Teruskan". Drupal akan melengkapkan pemasangan akhir, menjana fail konfigurasi, dan menetapkan maklumat asas laman web.

6. Selesai pemasangan

   Setelah pemasangan selesai, anda akan dialihkan ke laman utama Drupal anda. Tahniah—Drupal kini berjaya dipasang pada ServBay!

Langkah 6: Pengenalan Ringkas kepada Pemasangan Modul dan Tema

Kekuatan utama Drupal terletak pada ekosistem modul dan temanya. Selepas pemasangan, anda boleh mula menambah serta menyesuaikan fungsi laman anda mengikut keperluan.

1. Log masuk ke panel pentadbir Drupal: Lawati https://servbay-drupal.local/user atau https://servbay-drupal.local/admin dan masuk menggunakan nama pengguna serta kata laluan pentadbir yang anda tetapkan sebelum ini.
2. Pasang modul: Setelah log masuk, pergi ke menu pentadbiran > "Extend" untuk melayari, mencari dan memasang modul baharu bagi menambah fungsi pada laman.
3. Pasang tema: Pergi ke "Appearance" untuk memasang dan menetapkan tema-tema baru bagi menukar paparan laman.

Konfigurasi Lanjutan & Penggunaan Selepas Pemasangan

Selepas berjaya memasang Drupal, anda boleh mula membina laman web anda menggunakan pelbagai fungsinya. Berikut beberapa operasi asas yang boleh anda lakukan:

Cipta Jenis Kandungan dan Kandungan

Inti Drupal ialah "jenis kandungan" yang menentukan struktur data pelbagai kandungan (contoh: artikel, halaman, dan lain-lain).

1. Cipta jenis kandungan: Dalam panel pentadbir Drupal, navigasi ke "Structure" -> "Content types". Anda boleh mengubah suai jenis kandungan sedia ada atau klik "Add content type" untuk mencipta baru—tentukan medan seperti tajuk, kandungan, imej dsb.
2. Bina kandungan: Navigasi ke "Content" -> "Add content", pilih jenis kandungan yang ingin dibina, lengkapkan semua medan yang diperlukan dan klik "Save and publish".

Konfigurasi Menu Navigasi

Menu membantu menyusun laluan navigasi pada laman anda.

1. Cipta menu: Dalam panel pentadbir, pergi ke "Structure" -> "Menus" untuk menambah menu baru atau ubah suai menu sedia ada.
2. Tambah item menu: Edit sesebuah menu, klik "Add link", isi teks dan laluan sasaran (seperti /node/1 untuk dalaman atau URL luaran) dan simpan.

Ubah suai Tata Letak Blok

Blok ialah unit kandungan boleh suai yang boleh dipaparkan di kawasan tertentu laman (seperti sidebar, footer dll).

1. Tambah blok: Dalam panel pentadbir, pergi ke "Structure" -> "Block layout". Skrin ini memaparkan kawasan tema semasa. Anda boleh seret mana-mana blok yang tersedia (contoh, blok menu, blok kandungan tersuai) ke kawasan yang dikehendaki.
2. Konfigurasi blok: Klik butang "Configure" pada blok, anda boleh menukar tajuk, halaman paparan, kebenaran pengguna dan sebagainya.

Nota Penting dan Soalan Lazim (FAQ)

• Bagaimana untuk mengubah tetapan PHP? Jika Drupal memerlukan sambungan PHP tertentu atau limitasi memori (memory_limit) yang lebih tinggi, anda boleh pergi ke tab “Pakej” dalam UI ServBay, cari versi PHP yang berkenaan dan klik butang konfigurasi untuk mengedit fail php.ini. Selepas itu, mulakan semula perkhidmatan PHP (ServBay biasanya akan mengingatkan atau melakukannya secara automatik).
• Mengapa laman saya tidak dapat diakses?
  • Sahkan sama ada ServBay sedang berjalan.
  • Sahkan konfigurasi laman web dalam ServBay—pastikan domain dan direktori root adalah betul dan menunjuk ke .../servbay-drupal-app/web.
  • Pastikan pelayan web (Caddy atau Nginx) dalam ServBay sedang berjalan.
  • Pastikan anda mengakses https://servbay-drupal.local dengan laluan yang betul (untuk pemasangan—https://servbay-drupal.local/core/install.php).
• Apa perlu dilakukan jika sambungan ke pangkalan data gagal?
  • Sahkan nama pangkalan data, pengguna dan kata laluan yang dimasukkan semasa pemasangan Drupal tepat seperti yang dicipta di phpMyAdmin.
  • Pastikan hos pangkalan data ialah localhost.
  • Pastikan perkhidmatan MySQL/MariaDB dalam ServBay sedang berjalan.
• Mengapa berlaku ralat semasa pemasangan kebergantungan Composer? Sahkan sambungan Internet anda supaya Composer boleh mengakses packagist.org. Kadangkala anda perlu mengosongkan cache Composer atau mengemas kini versinya (ServBay akan mengemaskini versi terbina dalam dari semasa ke semasa).
• Isu kebenaran fail? Drupal memerlukan hak tulis pada direktori tertentu semasa pemasangan atau operasi (contohnya web/sites/default/files dan web/sites/default/settings.php). ServBay biasanya menjalankan semua servis atas hak pengguna semasa, maka isu ini jarang berlaku, tetapi jika terjadi, sila semak tetapan kebenaran direktori tersebut.

Kesimpulan

Dengan mengikuti panduan ini, anda telah berjaya memasang dan mengkonfigurasi Drupal di persekitaran pembangunan tempatan menggunakan ServBay. ServBay menyediakan platform serba lengkap, mudah digunakan untuk pembangunan aplikasi Drupal secara tempatan. Kini, anda boleh memanfaatkan kekuatan Drupal untuk membina laman web anda dan melaksanakan pembangunan, ujian dan debugging di ServBay dengan lebih cekap. Dengan keupayaan fleksibel ServBay, anda juga boleh mengurus pelbagai versi PHP, pangkalan data dan servis lain dengan mudah mengikut keperluan setiap projek.