Memasang dan Mengkonfigurasi Bedrock di Persekitaran ServBay

Pengenalan

Dokumen ini akan membimbing anda bagaimana untuk memasang dan mengkonfigurasi Bedrock di persekitaran pembangunan tempatan ServBay. Bedrock menyediakan struktur projek WordPress yang moden, menggunakan Composer untuk pengurusan kebergantungan, mengoptimumkan pengurusan konfigurasi, dan mematuhi amalan terbaik untuk meningkatkan kecekapan serta keselamatan dalam pembangunan, penyebaran, dan penyelenggaraan projek WordPress. Digabungkan dengan kebolehan pengurusan persekitaran tempatan ServBay yang hebat dan mudah digunakan, anda boleh membina persekitaran pembangunan Bedrock dengan pantas.

Apakah itu Bedrock?

Bedrock ialah struktur projek WordPress yang dibina oleh pasukan Roots, bertujuan mempertingkat pengalaman pembangunan WordPress. Ia sangat berbeza daripada struktur WordPress tradisional, dengan ciri-ciri utama seperti:

• Pengurusan kebergantungan melalui Composer: Teras WordPress, tema, dan pemalam dikendalikan menggunakan Composer, yang memudahkan proses kemas kini dan mengatasi konflik kebergantungan.
• Pengurusan konfigurasi yang lebih baik: Menggunakan prinsip Twelve-Factor App, pengurusan pembolehubah persekitaran melalui fail .env memisahkan konfigurasi dari kod, menjadikannya lebih selamat dan fleksibel.
• Organisasi projek yang lebih jelas: Teras WordPress berada dalam subdirektori berasingan (web/wp), dan tema serta pemalam dalam web/app, menjadikan struktur projek lebih tersusun.
• Keselamatan dipertingkatkan: Turut merangkumi langkah keselamatan, seperti menyembunyikan laluan fail teras.

Bedrock adalah pilihan ideal untuk membina aplikasi WordPress yang lebih kukuh, mudah diselenggara, dan moden.

Kenapa Pilih ServBay untuk Pembangunan Bedrock?

ServBay ialah perisian pembangunan web tempatan yang direka khas untuk macOS, menggabungkan pelayan web terkemuka (Caddy/Nginx/Apache), pelbagai versi PHP, pangkalan data (MySQL/PostgreSQL/MongoDB), serta persekitaran bahasa pembangunan seperti Node.js, Python, Go, dan Java. Dengan ServBay dan Bedrock, anda boleh:

• Membina persekitaran dengan cepat: ServBay sudah dilengkapi PHP, Composer, dan pangkalan data yang diperlukan untuk Bedrock tanpa perlu pemasangan tambahan.
• Penukaran versi yang fleksibel: Mudah tukar versi PHP untuk menguji keserasian Bedrock pada pelbagai versi PHP.
• Pengurusan pangkalan data terintegrasi: Dengan phpMyAdmin atau Adminer terbina ServBay, lebih mudah mencipta dan mengurus pangkalan data Bedrock.
• Konfigurasi laman web yang mudah: Tetapkan laman projek Bedrock (virtual host) dengan pantas melalui antaramuka grafik ServBay, menunjukkan ke direktori akar laman yang betul.
• Pengurusan bersatu: Urus semua perisian dan laman web pembangunan tempatan dalam satu aplikasi.

Prasyarat

Sebelum memulakan pemasangan, pastikan anda memenuhi syarat berikut:

• Telah memasang dan menjalankan ServBay di macOS.
• Mempunyai asas pengetahuan menggunakan terminal/command line.
• Memahami asas penggunaan Composer (panduan ini juga akan menyediakan perintah yang diperlukan).

Langkah Pemasangan Bedrock

Bahagian ini menjelaskan secara terperinci cara memasang dan mengkonfigurasi projek Bedrock dalam persekitaran ServBay.

Langkah 1: Cipta Direktori Projek

Mula-mula, navigasi ke direktori akar laman web lalai ServBay di /Applications/ServBay/www, dan cipta direktori projek baru. Saranan: gunakan nama yang mudah dikenali, contohnya servbay-bedrock-app.

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

Ini ialah direktori akar projek Bedrock anda.

Langkah 2: Cipta Projek Bedrock dengan Composer

ServBay telah disertakan Composer, jadi anda boleh terus gunakan composer di terminal. Dalam direktori projek yang baru dicipta (/Applications/ServBay/www/servbay-bedrock-app), jalankan perintah Composer berikut untuk mencipta projek Bedrock:

composer create-project roots/bedrock .

Perintah ini akan memuat turun versi Bedrock terkini beserta semua kebergantungan ke dalam direktori semasa (.). Proses ini mungkin mengambil sedikit masa bergantung pada kelajuan internet anda.

Langkah 3: Cipta Pangkalan Data & Pengguna

Bedrock dan WordPress memerlukan pangkalan data untuk menyimpan kandungan dan tetapan laman. Kita akan guna phpMyAdmin bawaan ServBay untuk mencipta pangkalan data dan pengguna.

1. Akses alat pengurusan pangkalan data phpMyAdmin ServBay

   Buka pelayar anda dan pergi ke alamat lalai tempatan ServBay https://servbay.host/. Pada halaman utama, klik pautan "phpMyAdmin" untuk ke antaramuka pengurusan pangkalan data.

2. Cipta pengguna pangkalan data baharu

   Demi keselamatan dan pengurusan yang tersusun, disarankan untuk setiap projek menggunakan pengguna dan pangkalan data sendiri.

   1. Pergi ke halaman akaun pengguna

      Dalam laman utama phpMyAdmin, klik pada menu "Akaun Pengguna" di bahagian navigasi atas.

   2. Tambah pengguna baru

      Klik "Tambah Akaun Pengguna". Isikan maklumat berikut:

      • Nama pengguna: Masukkan nama pengguna database untuk projek ini, contoh bedrock_user.
      • Nama hos: Pilih localhost. Ini bermaksud pengguna hanya boleh akses database secara tempatan.
      • Kata laluan: Masukkan kata laluan selamat untuk pengguna ini. Catat kata laluan tersebut. Contohnya, password123 boleh digunakan untuk ujian pembangunan tempatan, tetapi gunakan kata laluan lebih kompleks di persekitaran produksi.
      • Ulang Semula: Masukkan sekali lagi kata laluan yang sama.

      Pada bahagian "Pangkalan Data untuk Pengguna ini", pilih "Cipta database yang mempunyai nama sama dengan pengguna dan berikan semua hak akses". Ini akan mencipta pangkalan data bedrock_user dan memberikan semua hak akses kepada pengguna tersebut.

      Pastikan kotak "Berikan semua hak akses" ditandakan untuk memastikan pengguna ini mempunyai keizinan penuh pada pangkalan data baru.

      Klik butang "Laksana" di bawah untuk mengesahkan penciptaan pengguna dan pangkalan data.

Langkah 4: Konfigurasi Bedrock

Bedrock menggunakan pembolehubah persekitaran untuk menguruskan konfigurasi, biasanya disimpan dalam fail .env pada akar projek.

1. Salin fail konfigurasi contoh

   Dalam akar projek Bedrock (/Applications/ServBay/www/servbay-bedrock-app), anda akan nampak fail contoh bernama .env.example. Salin fail ini dan namakan sebagai .env:

   cp .env.example .env

   Fail .env digunakan untuk konfigurasi sebenar projek, manakala .env.example hanya sebagai rujukan dan tidak mengandungi maklumat sensitif.

2. Edit fail .env

   Guna editor teks kegemaran anda (VS Code, Sublime Text, Nano dsb.) untuk membuka fail .env yang baru disalin tadi. Cari tetapan berkaitan sambungan pangkalan data, dan ubah mengikut maklumat yang anda wujudkan dalam Langkah 3:

   # Database
   DB_NAME='bedrock_user' # Nama database, sama seperti nama pengguna
   DB_USER='bedrock_user' # Nama pengguna database
   DB_PASSWORD='password123' # Kata laluan database
   DB_HOST='localhost' # Alamat hos database, biasanya localhost untuk ServBay tempatan
   DB_PREFIX='wp_' # Prefiks jadual database, boleh kekalkan lalai atau ubah
   
   # WordPress Environment
   WP_ENV='development' # Persekitaran semasa, boleh jadi development, staging, production dsb.
   
   # Site URLs
   WP_HOME='http://servbay-bedrock.local' # URL penuh laman web
   WP_SITEURL='${WP_HOME}/wp' # URL lokasi teras WordPress

   Sila ubah nilai mengikut maklumat sebenar anda (contoh kata laluan database). Variabel WP_HOME dan WP_SITEURL mendefinisikan alamat laman yang akan digunakan dalam pelayar. servbay-bedrock.local ialah domain tempatan biasa untuk pembangunan; anda boleh ubah jika diperlukan. WP_SITEURL sepatutnya merujuk ke subdirektori teras WordPress (web/wp).

   Anda juga boleh menyesuaikan tetapan Bedrock dan WordPress lain dalam fail .env, seperti mentakrifkan pemalar atau tetapan penghantaran e-mel.

Langkah 5: Konfigurasi Pelayan Web (Laman ServBay)

Supaya pelayan web ServBay dapat menjalankan projek Bedrock anda, anda perlu menambah laman baru (virtual host) dalam ServBay.

1. Tambah laman web baru

   Buka aplikasi ServBay, klik pada tab "Laman Web" di bar navigasi kiri. Klik butang "+" atau "Tambah Laman Web" untuk cipta laman baru. Masukkan maklumat berikut:

   • Nama: Nama mudah dikenali untuk laman anda, contoh My Bedrock Site (tujuan pengurusan dalaman ServBay).
   • Domain: Masukkan domain yang digunakan pada tetapan WP_HOME dalam fail .env, contohnya servbay-bedrock.local. ServBay akan memetakan domain ini ke 127.0.0.1 secara automatik.
   • Jenis Laman: Pilih PHP.
   • Versi PHP: Pilih versi PHP yang serasi dengan Bedrock. Disarankan guna versi PHP stabil terkini dalam ServBay.
   • Direktori akar laman: Langkah ini amat penting. Direktori akar laman Bedrock bukan direktori projek, tetapi subdirektori web dalam projek. Tetapkan ke /Applications/ServBay/www/servbay-bedrock-app/web.

2. Simpan konfigurasi

   Setelah semua maklumat diisi, klik butang simpan. ServBay akan mengemas kini konfigurasi pelayannya secara automatik. Jika dipinta untuk memulakan semula servis, lakukan seperti disarankan.

Langkah 6: Selesaikan Pemasangan WordPress

Projek Bedrock kini telah disediakan, dan anda telah mengkonfigurasi laman web dalam ServBay. Seterusnya, selesaikan pemasangan WordPress melalui antaramuka web seperti biasa.

1. Akses laman pemasangan

   Buka pelayar anda, lawati alamat WP_SITEURL yang anda tetapkan dalam fail .env dan konfigurasi ServBay, contohnya http://servbay-bedrock.local/wp. Jika konfigurasi betul, anda akan disambut dengan halaman pemasangan WordPress.

2. Isi maklumat pangkalan data

   Panduan pemasangan WordPress akan meminta maklumat sambungan pangkalan data. Gunakan maklumat dari langkah 3:

   • Nama pangkalan data: bedrock_user (sama seperti nama pengguna)
   • Nama pengguna: bedrock_user
   • Kata laluan: Kata laluan dari langkah 3 (cth. password123)
   • Hos pangkalan data: localhost
   • Prefiks jadual: wp_ (biarkan lalai kecuali anda ada keperluan khas)

   Klik butang "Serahkan". WordPress akan cuba menyambung ke pangkalan data.

3. Isi maklumat laman web

   Jika sambungan ke pangkalan data berjaya, anda akan ke halaman pengisian maklumat laman. Masukkan:

   • Tajuk laman: Nama laman web anda.
   • Nama pengguna: Nama pengguna pentadbir.
   • Kata laluan: Kata laluan kuat untuk pentadbir.
   • Emel anda: Alamat emel pentadbir.
   • Keterlihatan enjin carian: Untuk pembangunan tempatan, disarankan tandakan "Halang enjin carian daripada mengindeks laman ini".

4. Lengkapkan pemasangan

   Klik butang "Pasang WordPress". WordPress akan menjalankan sisa proses pemasangan dan mencipta semua jadual yang diperlukan. Selepas berjaya, anda akan melihat halaman kejayaan dan boleh terus log masuk ke papan pemuka pentadbir WordPress.

Langkah 7: Pasang Tema dan Pemalam (Kaedah Composer)

Bedrock menggalakkan pengurusan tema dan pemalam menggunakan Composer, bukannya melalui antaramuka WordPress.

1. Cari nama pakej Composer tema/pemalam

   Kebanyakan tema dan pemalam popular mempunyai pakej Composer, boleh didapati di Packagist (packagist.org) atau WordPress Packagist (wpackagist.org). Biasanya format pakej: vendor/package-name, contoh wpackagist-theme/twentytwentyone atau wpackagist-plugin/wordpress-seo.

2. Pasang dengan Composer

   Dalam direktori akar projek Bedrock (/Applications/ServBay/www/servbay-bedrock-app), jalankan arahan Composer berikut:

   Untuk tema:

   composer require wpackagist-theme/your-theme-name

   Untuk pemalam:

   composer require wpackagist-plugin/your-plugin-name

   Gantikan your-theme-name dan your-plugin-name dengan nama sebenar pakej. Composer akan memasang tema ke web/app/themes dan pemalam ke web/app/plugins.

3. Aktifkan dalam WordPress

   Log masuk ke papan pemuka WordPress (http://servbay-bedrock.local/wp/wp-admin/), kemudian:

   • Untuk tema: Klik "Paparan" -> "Tema", cari tema yang dipasang dan aktifkan.
   • Untuk pemalam: Klik "Pemalam" -> "Pemalam Dipasang", cari pemalam yang selesai dipasang dan aktifkan.

   Walaupun kaedah Composer disyorkan oleh Bedrock, anda masih boleh memasang tema/pemalam melalui muat naik fail .zip di WordPress, tetapi Composer menawarkan pengurusan yang lebih moden dan sistematik.

Membina Laman Web dengan Bedrock

Sekarang anda telah berjaya memasang dan mengkonfigurasi Bedrock dalam persekitaran ServBay. Anda boleh mula membina laman web seperti biasa dengan WordPress, sambil menikmati manfaat pembangunan moden Bedrock.

• Cipta halaman dan kiriman: Log masuk papan pemuka WordPress, guna menu "Halaman" dan "Kiriman" untuk menambah kandungan (sama seperti WordPress standard).
• Tetap menu navigasi: Urus menu laman web di "Paparan" -> "Menu".
• Urus widget: Ubah suai kandungan kawasan bar sisi dsb. di "Paparan" -> "Widget".
• Pembangunan tema & pemalam: Sebagai pembangun, anda boleh terus membangunkan tema/plugin di web/app/themes dan web/app/plugins.
• Pengurusan konfigurasi: Guna fail .env untuk mengurus konfigurasi mengikut persekitaran (pembangunan, staging, produksi).

Soalan Lazim (FAQ)

• S: Apakah perlu dibuat jika http://servbay-bedrock.local menunjukkan ralat 404?

  • J: Semak sama ada domain yang dikonfigurasi dalam ServBay selari dengan domain yang diakses.
  • J: Pastikan direktori akar laman yang ditetapkan dalam ServBay menunjuk ke /Applications/ServBay/www/servbay-bedrock-app/web.
  • J: Pastikan pelayan web ServBay sedang berjalan.
  • J: Periksa tetapan WP_HOME dalam fail .env anda.

• S: Apa perlu dibuat jika http://servbay-bedrock.local/wp menunjukkan ralat sambungan pangkalan data?

  • J: Semak tetapan DB_NAME, DB_USER, DB_PASSWORD, DB_HOST dalam fail .env sama seperti maklumat pengguna/database di phpMyAdmin.
  • J: Pastikan perkhidmatan MySQL atau pangkalan data lain sedang berjalan dalam ServBay.
  • J: Sahkan bahawa pengguna yang dicipta di phpMyAdmin telah diberi semua keizinan pada pangkalan data.

• S: Kenapa tema/pemalam tidak muncul di pentadbir WordPress selepas pemasangan?

  • J: Jika dipasang melalui Composer, pastikan anda telah menjalankan composer install atau composer require dengan jayanya dalam direktori akar projek.
  • J: Tema yang dipasang dengan Composer akan muncul dalam web/app/themes, pemalam di web/app/plugins. Sila pastikan fail berkenaan ada.
  • J: Cari dan aktifkan di papan pemuka WordPress, pada menu "Paparan" -> "Tema" atau "Pemalam" -> "Pemalam Dipasang".

• S: Bagaimana untuk kemas kini Bedrock, teras WordPress, tema atau pemalam?

  • J: Sebagai Bedrock menggunakan Composer, anda hanya perlu jalankan composer update dalam direktori projek untuk mengemaskini semua kebergantungan, atau guna composer update vendor/package-name untuk kemas kini tertentu. Selepas itu, kemaskini pangkalan data melalui WordPress jika perlu.

Rumusan

Dengan mengikuti langkah di atas, anda telah berjaya menyediakan projek Bedrock dalam persekitaran pembangunan tempatan ServBay. Gabungan pengurusan persekitaran ServBay yang mudah dan aliran kerja moden Bedrock membolehkan anda membangunkan serta menyelenggara projek WordPress dengan lebih berkesan dan selamat. Kini, anda boleh mula memanfaatkan kelebihan Bedrock untuk membina laman WordPress anda yang seterusnya!