ServBay Ortamında Bedrock Kurulumu ve Yapılandırması

Genel Bakış

Bu belge, ServBay yerel geliştirme ortamında Bedrock'un nasıl kurulup yapılandırılacağını adım adım gösterir. Bedrock, Composer ile bağımlılık yönetimi, gelişmiş konfigürasyon yönetimi ve en iyi uygulamaları izleyerek modern bir WordPress proje yapısı sunar; böylece WordPress projelerinin geliştirilmesi, dağıtımı ve bakımı daha güvenli ve verimli olur. ServBay'in güçlü ve kullanıcı dostu yerel ortam yönetimiyle Bedrock geliştirme ortamınızı hızla oluşturabilirsiniz.

Bedrock Nedir?

Bedrock, Roots ekibi tarafından geliştirilen ve WordPress'in geliştirme deneyimini yükseltmeyi amaçlayan bir proje yapısıdır. Geleneksel WordPress kurulumlarından önemli ölçüde farklı olup temel özellikleri şunlardır:

• Composer ile bağımlılık yönetimi: WordPress çekirdeği, temalar ve eklentiler Composer üzerinden kolayca yönetilir; güncellemeler ve bağımlılık çakışmaları daha basit şekilde çözülür.
• Gelişmiş konfigürasyon yönetimi: Twelve-Factor App prensipleriyle, .env dosyası üzerinden ortam değişkenleriyle yapılandırma ve kod ayrılır; güvenlik ve esneklik artar.
• Daha iyi proje organizasyonu: WordPress çekirdeği web/wp alt klasörüne, tema ve eklentiler ise web/app içine yerleştirilir; dosya yapısı çok daha düzenlidir.
• Güçlendirilmiş güvenlik: Çekirdek dosya yolları gibi unsurları gizleyerek güvenlik varsayılan olarak artırılır.

Bedrock, daha sağlam, sürdürülebilir ve modern WordPress uygulamaları oluşturmak için ideal bir tercihtir.

Bedrock Geliştirme için Neden ServBay Kullanılmalı?

ServBay, macOS için özel geliştirilmiş yerel bir web geliştirme aracı olup önde gelen web sunucularını (Caddy/Nginx/Apache), pek çok PHP sürümünü, çeşitli veritabanlarını (MySQL/PostgreSQL/MongoDB) ve Node.js, Python, Go, Java gibi dilleri entegre şekilde sunar. ServBay ile Bedrock birlikte kullanıldığında:

• Hızlı ortam kurulumu: ServBay, Bedrock için gereken PHP, Composer ve veritabanı yazılımlarını önceden yükler; ayrıca ayrı bir kurulum gerekmez.
• Esnek sürüm değişimi: Farklı PHP sürümleri arasında kolayca geçiş yapabilir, Bedrock'un farklı PHP sürümleriyle uyumluluğunu test edebilirsiniz.
• Entegre veritabanı yönetimi: Dahili phpMyAdmin veya Adminer ile Bedrock için gerekli veritabanlarını kolayca oluşturup yönetebilirsiniz.
• Basitleştirilmiş site ayarları: Bedrock projesini doğru web kök dizinine (virtual host) hızlıca yönlendirmek için grafik arayüzü kullanabilirsiniz.
• Merkezi yönetim: Tüm yazılım ve siteleri tek bir uygulama üzerinden kontrol edin.

Ön Koşullar

Kuruluma başlamadan önce şu gereklilikleri karşıladığınızdan emin olun:

• ServBay'i macOS üzerinde yükleyip çalıştırdınız.
• Temel komut satırı bilgisine sahipsiniz.
• Composer'a aşinasınız (yine de gerekli komutlar belgede gösterilecektir).

Bedrock Kurulum Adımları

Bu bölümde ServBay ortamında Bedrock projesini kurup yapılandırmak için gerekli adımlar ayrıntılı şekilde anlatılacaktır.

Adım 1: Proje Dizini Oluşturma

Öncelikle, ServBay'in varsayılan web kök dizini olan /Applications/ServBay/www yoluna gidin ve orada yeni bir proje klasörü oluşturun. Açıklayıcı bir isim önerilir, örneğin servbay-bedrock-app.

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

Bu klasör, Bedrock projenizin ana dizini olacak.

Adım 2: Composer ile Bedrock Projesi Oluşturma

ServBay, Composer ile birlikte gelir; dolayısıyla terminalde doğrudan composer komutunu kullanabilirsiniz. Az önce oluşturduğunuz proje dizininde (/Applications/ServBay/www/servbay-bedrock-app) aşağıdaki Composer komutunu çalıştırarak Bedrock projenizi başlatın:

composer create-project roots/bedrock .

Bu komut, Bedrock'un en güncel sürümünü ve tüm bağımlılıklarını geçerli dizine indirir (.). Bu işlem internet hızınıza bağlı olarak birkaç dakika sürebilir.

Adım 3: Veritabanı ve Kullanıcı Oluşturma

Bedrock ve WordPress, içerik ve ayarları depolamak için bir veritabanı gerektirir. ServBay'in dahili phpMyAdmin aracıyla veritabanı ve kullanıcı oluşturacağız.

1. ServBay'deki phpMyAdmin'e erişim

   Tarayıcınızı açıp ServBay'in varsayılan adresine gidin: https://servbay.host/. Ana sayfada "phpMyAdmin" bağlantısını tıklayarak phpMyAdmin arayüzüne geçin.

2. Veritabanı Kullanıcısı Oluşturma

   Her proje için ayrı bir veritabanı ve kullanıcı oluşturmak güvenlik ve yönetim için önerilir.

   1. Kullanıcı Hesapları Sayfasına Girin

      phpMyAdmin'de ana sayfada üst menüden "Kullanıcı Hesapları" sekmesine tıklayın.

   2. Yeni Kullanıcı Ekleyin

      "Kullanıcı Hesabı Ekle" butonuna tıklayın ve aşağıdaki bilgileri girin:

      • Kullanıcı adı: Proje için bir kullanıcı ismi girin, örneğin bedrock_user.
      • Sunucu: localhost seçin; yani bu kullanıcı sadece yerelden bağlanabilir.
      • Şifre: Bu kullanıcı için güçlü bir şifre girin. Şifreyi not edin. Yerel test için password123 kullanabilirsiniz fakat canlı sunucuda kesinlikle güçlü şifre kullanmalısınız.
      • Yeniden girin: Şifreyi tekrar yazın.

      "Veritabanının Kullanıcı Adıyla Aynı Olarak Oluşturulması ve Tüm Yetkilerin Verilmesi" seçeneğini işaretleyin. Bu, otomatik olarak bedrock_user adı ile bir veritabanı oluşturur ve ilgili kullanıcıya tüm yetkileri tanır.

      "Tüm ayrıcalıkları ver" kutucuğunu işaretleyerek kullanıcının tam yetkiye sahip olduğundan emin olun.

      En aşağıdaki "Git" butonuna tıklayarak kullanıcı ve veritabanı oluşturmayı tamamlayın.

Adım 4: Bedrock Yapılandırması

Bedrock, ayarlarını ortam değişkenleriyle yönetir; bunlar genellikle projenin kökündeki .env dosyasında tutulur.

1. Ortam Konfigürasyon Dosyasını Düzenleyin

   Bedrock proje kökünde (/Applications/ServBay/www/servbay-bedrock-app) bir .env.example dosyası görmelisiniz. Bu dosyayı kopyalayıp .env olarak adlandırın:

   cp .env.example .env

   .env gerçek yapılandırma dosyanızdır; örnek dosya (.env.example) hassas bilgi içermez.

2. .env Dosyasını Düzenleyin

   Tercih ettiğiniz bir metin editörüyle (VS Code, Sublime Text, Nano vb.) yeni .env dosyasını açın. Veritabanı bağlantı ayarlarını 3. adımda oluşturduğunuz bilgilerle güncelleyin:

   # Veritabanı
   DB_NAME='bedrock_user' # Veritabanı adı, kullanıcı adı ile aynı
   DB_USER='bedrock_user' # Veritabanı kullanıcı adı
   DB_PASSWORD='password123' # Veritabanı şifresi
   DB_HOST='localhost' # Veritabanı sunucu adresi, genellikle localhost
   DB_PREFIX='wp_' # Tablo ön eki, varsayılanı kullanabilir ya da değiştirebilirsiniz
   
   # WordPress Ortamı
   WP_ENV='development' # Çalışma ortamı; development, staging, production gibi
   
   # Site URL'leri
   WP_HOME='http://servbay-bedrock.local' # Sitenizin tam adresi
   WP_SITEURL='${WP_HOME}/wp' # WordPress çekirdeğinin URL'si

   Yukarıdaki değerleri kendi ortamınıza göre (özellikle DB_PASSWORD) güncelleyin.

   WP_HOME ve WP_SITEURL sitenizi tarayıcıda açmak için kullanılır. servbay-bedrock.local tipik bir yerel alan adıdır, ihtiyaca göre değiştirebilirsiniz. WP_SITEURL, WordPress çekirdeğinin bulunduğu alt klasöre (web/wp) işaret etmelidir.

   .env içinde, Bedrock ve WordPress ile ilgili başka ayarlar (sabitler, e-posta ayarları vs.) da yapabilirsiniz.

Adım 5: Web Sunucusu Ayarlama (ServBay Sitesi)

ServBay'in web sunucusunun Bedrock projenizi doğru şekilde çalıştırabilmesi için yeni bir site (sanal host) tanımlamanız gerekir.

1. Yeni Site Ekleyin

   ServBay uygulamasını açın, sol menüden "Siteler" sekmesine tıklayın. Ekrandaki "+" ya da "Site Ekle" butonuna basarak bir web sitesi ekleyin. Aşağıdaki alanları doldurun:

   • Adı: Örneğin My Bedrock Site. (Yalnızca ServBay'de dahili tanım için.)
   • Alan adı: .env dosyasındaki WP_HOME adresinde kullandığınız alan adı, örneğin servbay-bedrock.local. ServBay bu alan adını otomatik olarak 127.0.0.1'e yönlendirecektir.
   • Site türü: PHP seçin.
   • PHP sürümü: Bedrock ile uyumlu bir PHP sürümü. En son stabil sürümü seçmeniz önerilir.
   • Site kök dizini: Çok önemli: Bedrock'un web kökü, proje kök klasörü değil; proje altındaki web dizinidir. Yani /Applications/ServBay/www/servbay-bedrock-app/web olarak ayarlayın.

2. Ayarları Kaydedin

   Tüm alanları doldurduktan sonra "Kaydet" butonuna tıklayın. ServBay web sunucu yapılandırmasını otomatik olarak güncelleyecektir. Gerekirse ilgili servisleri yeniden başlatmanız istenirse onaylayın.

Adım 6: WordPress Kurulumunu Tamamlama

Artık Bedrock projesi ve ServBay web sitesi ayarları hazır. Şimdi klasik WordPress kurulum adımlarını web arayüzünden tamamlayabilirsiniz.

1. Kurulum Sayfasına Girin

   Tarayıcınızda, .env dosyasında ve ServBay ayarlarında belirttiğiniz WP_SITEURL adresine (ör. http://servbay-bedrock.local/wp) gidin. Ayarlarınız doğruysa WordPress kurulum sihirbazı açılacaktır.

2. Veritabanı Bilgilerini Girin

   Kurulum sihirbazı sizden veritabanı bilgilerini ister. 3. adımda oluşturduğunuz bilgileri girin:

   • Veritabanı adı: bedrock_user (kullanıcı adı ile aynı)
   • Kullanıcı adı: bedrock_user
   • Şifre: Önceki adımdaki şifre (örneğin password123)
   • Veritabanı sunucusu: localhost
   • Tablo öneki: wp_ (genelde varsayılan kalabilir)

   "Gönder" butonuna tıklayın; WordPress bağlantıyı sınayacaktır.

3. Site Bilgilerini Doldurun

   Bağlantı başarılı olursa, site ayarları sayfasına yönlendirilirsiniz. Burada:

   • Site başlığı: Web sitenizin adı.
   • Kullanıcı adı: Yönetici hesabı için bir kullanıcı ismi oluşturun.
   • Şifre: Güçlü bir yönetici şifresi belirleyin.
   • E-posta adresiniz: Yönetici e-posta adresinizi girin.
   • Arama motorları: Yerel geliştirme için "Arama motorlarını bu siteyi dizine ekleme" seçeneğini işaretleyebilirsiniz.

4. Kurulumu Tamamlayın

   "WordPress'i Kur" butonuna basın. WordPress gerekli tabloları veritabanında oluşturacak ve işlemi tamamlayacaktır. Kurulumdan sonra başarılı bir mesaj görecek ve yönetici paneline geçebileceksiniz.

Adım 7: Tema ve Eklenti Kurulumu (Composer ile)

Bedrock, temalar ve eklentileri WordPress arayüzü yerine Composer ile kurmayı önerir.

1. Tema/Eklenti Composer Paket Adını Bulun

   Pek çok popüler tema ve eklenti, Packagist (packagist.org) veya WordPress Packagist (wpackagist.org) üzerinde Composer paketi olarak bulunur. Genellikle vendor/package-name biçimindedir: ör. wpackagist-theme/twentytwentyone veya wpackagist-plugin/wordpress-seo.

2. Composer ile Kurulum

   Proje kökünüzde (/Applications/ServBay/www/servbay-bedrock-app) aşağıdaki komutları kullanın.

   Tema kurulumu:

   composer require wpackagist-theme/your-theme-name

   Eklenti kurulumu:

   composer require wpackagist-plugin/your-plugin-name

   your-theme-name ve your-plugin-name kısımlarını ilgili paket adlarıyla değiştirin. Temalar web/app/themes, eklentiler ise web/app/plugins klasörüne yüklenir.

3. WordPress Arayüzünden Etkinleştirme

   WordPress yönetim paneline girin (http://servbay-bedrock.local/wp/wp-admin/):

   • Temalar: "Görünüm" -> "Temalar"dan yüklediğiniz temayı etkinleştirin.
   • Eklentiler: "Eklentiler" -> "Yüklü Eklentiler"den ilgili eklentiyi aktif edin.

   Bedrock, Composer ile kurulum önerse de, klasik .zip yükleyerek de kurulum yapabilirsiniz. Ancak Composer ile yönetmek daha modern ve güvenilirdir.

Bedrock ile Web Sitesi Geliştirme

Artık ServBay ortamında Bedrock kurulumunuz hazır. Standart WordPress gibi içerik oluşturabilir; aynı zamanda Bedrock'un modern geliştirici dostu avantajlarından yararlanabilirsiniz:

• Sayfa ve Yazı Oluşturma: WordPress panelinden "Sayfalar" ve "Yazılar" menüsüyle içerik ekleyin.
• Menü Ayarları: "Görünüm" -> "Menüler"de site navigasyonunu yapılandırın.
• Bileşen Yönetimi: "Görünüm" -> "Bileşenler"le yan panel gibi alanları düzenleyin.
• Tema/Eklenti Geliştirme: Geliştiriciyseniz, web/app/themes ve web/app/plugins klasörlerinde doğrudan geliştirme yapabilirsiniz.
• Konfigürasyon Yönetimi: .env dosyasıyla farklı ortamlar (geliştirme, test, canlı) için ayarları yönetin.

Sıkça Sorulan Sorular (SSS)

• S: http://servbay-bedrock.local adresinde 404 hatası alıyorum, ne yapmalıyım?
  • C: ServBay'deki site alan adı ile tarayıcıda eriştiğiniz alan adının uyuştuğundan emin olun.
  • C: Site kök dizini gerçekten /Applications/ServBay/www/servbay-bedrock-app/web olarak ayarlı mı kontrol edin.
  • C: ServBay web sunucusu çalışıyor mu doğrulayın.
  • C: .env dosyasındaki WP_HOME değeri doğru mu bakın.
• S: http://servbay-bedrock.local/wp ziyaretinde veritabanı bağlantı hatası çıkıyor, çözüm?
  • C: .env dosyasındaki DB_NAME, DB_USER, DB_PASSWORD, DB_HOST alanlarını phpMyAdmin'de oluşturduğunuz bilgilerle kıyaslayın.
  • C: ServBay'de MySQL (veya kullandığınız veritabanı) hizmetinin çalıştığına emin olun.
  • C: phpMyAdmin'de oluşturduğunuz kullanıcının ilgili veritabanı için tam yetkiye sahip olduğunu kontrol edin.
• S: Eklediğim tema veya eklentiler neden WordPress panelinde gözükmüyor?
  • C: Composer ile kurulum yaptıysanız proje kökünde (/Applications/ServBay/www/servbay-bedrock-app) composer install veya composer require komutlarının sorunsuz çalıştığından emin olun.
  • C: Composer ile tema web/app/themes, eklentiler ise web/app/plugins klasörlerinde olmalı, klasörleri kontrol edin.
  • C: WordPress panelinde "Görünüm" -> "Temalar" veya "Eklentiler" -> "Yüklü Eklentiler" üzerinden etkinleştirebilirsiniz.
• S: Bedrock, WordPress çekirdeği, tema veya eklentiler nasıl güncellenir?
  • C: Bedrock Composer ile yönetildiği için proje kök dizininde composer update ile tüm bağımlılıkları; veya belli bir paket için composer update vendor/package-name komutunu çalıştırın. Gerekirse WordPress panelinde veritabanı güncelleme işlemlerini uygulayın.

Özet

Yukarıdaki adımlarla, ServBay yerel geliştirme ortamında bir Bedrock projesini başarıyla kurdunuz. ServBay'in kolay ortam yönetimi, Bedrock'un modern geliştirme yaklaşımı sayesinde WordPress projelerinizi daha hızlı ve güvenli şekilde yönetebilirsiniz. Artık Bedrock avantajlarıyla yeni WordPress sitenizi oluşturmaya başlayabilirsiniz!