ServBay Ortamında Craft CMS Kurulumu ve Yapılandırması

Genel Bakış

Craft CMS, esnek içerik modelleme kabiliyetleri, sezgisel kullanıcı arayüzü ve geliştirici dostu özellikleriyle öne çıkan güçlü bir içerik yönetim sistemidir (CMS). Karmaşık ve özelleştirilebilir web siteleri inşa etmek için idealdir.

ServBay’i Craft CMS için yerel geliştirme ortamı olarak kullanmanın birçok avantajı vardır: Önceden yapılandırılmış PHP, veritabanı (MySQL veya PostgreSQL gibi), web sunucusu (Caddy veya Nginx) ve entegre Composer ve komut satırı araçları ile kurulum ve yapılandırma süreci büyük ölçüde basitleşir.

Bu rehber, ServBay ortamında bir Craft CMS projesinin nasıl kurulup yapılandırılacağını adım adım açıklamaktadır.

Ön Koşullar

Başlamadan önce aşağıdaki gereklilikleri sağladığınızdan emin olun:

1. ServBay Kurulu ve Çalışır Durumda: macOS üzerinde ServBay’in başarıyla kurulduğundan ve ilgili PHP sürümünün (Craft CMS’in hangi PHP sürümlerini desteklediğini Craft CMS Resmi Belgesi üzerinden kontrol edebilirsiniz) ve veritabanı yazılımının (genellikle MySQL veya PostgreSQL) etkin olduğundan emin olun. ServBay çoklu PHP sürümü ve veritabanı desteğine sahiptir, ihtiyacınıza uygun olanı kolayca seçip yapılandırabilirsiniz.
2. Temel Komut Satırı Kullanımı: Terminalde bazı komutları çalıştırmanız (örneğin, dizin oluşturmak ve Composer çalıştırmak) gerekecektir.
3. Composer Bilgisi: Craft CMS, bağımlılıklarını Composer ile yönetir. ServBay ile Composer önceden kuruludur ancak composer create-project komutunu nasıl kullanacağınızı bilmelisiniz.

Craft CMS’i Kurma Adımları

ServBay ortamında Craft CMS’in kurulumu ve yapılandırılması için aşağıdaki adımları takip edin.

Adım 1: Proje Dizini Oluşturma

İlk olarak, ServBay'in varsayılan web kök dizini olan /Applications/ServBay/www yolunda yeni bir proje klasörü oluşturun. ServBay, bu dizini web sunucusunun hizmet vereceği klasör olarak varsayılan şekilde ayarlar; böylece projeye doğrudan erişmek kolaylaşır.

Terminali açıp şu komutları yürütün:

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

Bu işlemler /Applications/ServBay/www yolunda servbay-craft-app adında yeni bir klasör oluşturacak ve sizi içine taşıyacaktır.

Adım 2: Composer ile Craft CMS Projesi Oluşturma

ServBay’de Composer önceden yüklü geldiği için, proje klasörünüzde Composer ile doğrudan Craft CMS projesi başlatabilirsiniz. Craft CMS’in resmi kurulum önerisi Composer’dır.

servbay-craft-app klasöründe aşağıdaki komutu çalıştırın:

composer create-project craftcms/craft .

Bu komut, Craft CMS’in en son sürümünü ve tüm bağımlılıklarını mevcut dizine (.) indirip kuracaktır. Composer’ın işlemi tamamlamasını bekleyin.

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

Craft CMS, içerik ve yapılandırma verilerini saklamak için bir veritabanına ihtiyaç duyar. ServBay içinde gelen phpMyAdmin veya Adminer araçlarından biriyle veritabanı ve kullanıcı oluşturabilirsiniz. Bu örnekte phpMyAdmin kullanılacaktır.

1. ServBay’in Veritabanı Yönetim Aracına (phpMyAdmin) Erişin

   Tarayıcınızı açıp ServBay’in yerel yönetim paneline https://servbay.host/ gidin. Panelde “phpMyAdmin” linkine tıklayarak veritabanı arayüzüne ulaşın.

   Not: ServBay’de phpMyAdmin’e varsayılan kullanıcı genellikle root, varsayılan şifre ise ServBay.dev’dir. Güvenlik için, giriş yaptıktan sonra root şifresini değiştirmeniz veya yeni bir yönetici hesabı oluşturmanız önerilir.

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

   Craft CMS’i root ile bağlamak mümkün olsa da, daha iyi güvenlik için her uygulama için ayrı veritabanı kullanıcısı oluşturulması tavsiye edilir.

   1. Kullanıcı Hesapları Sayfasına Geçin

      phpMyAdmin ana ekranında üst menüden “Kullanıcı Hesapları” sekmesine tıklayın.

   2. Yeni Kullanıcı Ekleme

      “Kullanıcı Ekle”ye tıklayın ve şu bilgileri girin:

      • Kullanıcı adı: Örneğin, craft_user gibi bir isim seçin.
      • Sunucu (Host): localhost veya Yerel olarak ayarlayın; kullanıcı sadece yerel erişim için geçerli olur.
      • Şifre: Güvenli bir şifre belirleyin. Üretim ortamlarında asla örnek şifre olarak password123 kullanmayın. Yerel geliştirme için basit şifre kullanılabilir ama güvenliği unutmayın.
      • Yeniden girin: Onaylamak için şifreyi tekrar yazın.
      • “Veritabanı oluştur ve tüm yetkileri ver” kısmında, “Kullanıcı adıyla aynı isimde veritabanı oluştur ve tüm yetkileri ver” seçeneğini işaretleyin. Böylece hem craft_user adında bir veritabanı hem de ona tam yetkili bir kullanıcı oluşturulur.
      • “Tüm yetkileri ver” kutucuğu işaretli olmalı.
      • Sayfanın en altında “Git” butonuna tıklayın.

   Artık craft_user adında bir veritabanı kullanıcısı ve ona ait bir veritabanını tüm yetkileriyle oluşturmuş oldunuz.

Adım 4: Web Sunucusu Yapılandırması (ServBay’de Site Oluşturma)

ServBay’de Caddy veya Nginx web sunucusunun Craft CMS projenize hizmet verebilmesi için yeni bir “site” tanımlamanız gerekir.

1. ServBay Uygulamasını Açın

   ServBay uygulamasını çalıştırın.

2. Yeni Site Ekleyin

   Sol taraftaki “Siteler” sekmesini bulun (Eski sürümlerde “Hostlar” olarak görünebilir). Alttaki “+” butonuna veya sağ üstteki “Site Ekle” butonuna tıklayarak yeni site ekleyin.

   Aşağıdaki bilgileri doldurun:

   • İsim (Name): Tanıyabileceğiniz bir ad girin, örneğin My Craft Site.
   • Alan Adları (Domains): Yerelde kullanmak istediğiniz bir alan adı girin, örneğin servbay-craft.local. ServBay, yerel DNS yönlendirmesini otomatik olarak yapılandıracaktır.
   • Site Türü (Type): PHP seçin.
   • PHP Sürümü (PHP Version): Önkoşullarda belirttiğiniz ve Craft CMS ile uyumlu PHP sürümünü seçin. ServBay birden fazla PHP sürümünü aynı anda çalıştırabilir.
   • Site Kök Dizini (Website Root): Çok kritik bir adım! Craft CMS’in kamuya açık dosyaları (index.php gibi) proje klasörünüzdeki web alt klasöründe bulunur. Güvenlik için, web sunucusunun kök dizini doğrudan bu web klasörüne yönlendirilmelidir. Yol olarak şunu girin: /Applications/ServBay/www/servbay-craft-app/web Yolun doğru olduğundan, adım 1’de oluşturduğunuz proje klasöründeki web klasörüne işaret ettiğinden emin olun.

3. Yapılandırmayı Kaydedin

   Tüm bilgileri girdikten sonra “Kaydet”’e tıklayın. ServBay web sunucusu yapılandırmasını yeniden yükleyecek ve yeni siteniz kullanılabilir hale gelecektir. servbay-craft.local adresini site listesinde görebilirsiniz.

Adım 5: Craft CMS Kurulum Sihirbazını Çalıştırma

Artık tarayıcıda tanımladığınız alan adı üzerinden Craft CMS’in web tabanlı kurulum sihirbazını çalıştırabilirsiniz.

1. Kurulum Sayfasını Ziyaret Edin

   Tarayıcınızda https://servbay-craft.local/ adresine gidin. Craft CMS henüz kurulu olmadığını tespit edip kurulum sayfasına (https://servbay-craft.local/index.php?p=admin/install) yönlendirecektir.

2. Veritabanı Bilgilerini Girin

   Craft CMS kurulum adımlarında, 3. adımda oluşturduğunuz veritabanı bilgilerini girin:

   • Veritabanı Sunucusu (Database Server): localhost
   • Veritabanı Adı (Database Name): craft_user (veya oluşturduğunuz isim)
   • Kullanıcı Adı (Username): craft_user (veya belirlediğiniz kullanıcı)
   • Şifre (Password): craft_user için belirlediğiniz şifre

   Devam edin. Craft CMS veritabanı bağlantısını test edecek. Her şey doğruysa sonraki adıma ilerler.

3. Yönetici Hesabı Bilgilerini Doldurun

   Ekrandaki talimatlara uyarak bir Craft CMS yönetici hesabı oluşturun. Kullanıcı adı, şifre ve e-posta adresi girin. Güvenli bir şifre seçmeyi unutmayın.

   Devam edin.

4. Site Ayarları

   Site adınızı ve temel bilgileri doldurun.

   “Kurulumu Bitir (Finish Up)” butonuna tıklayın. Craft CMS veritabanı tablolarını oluşturup ayar dosyalarını hazırlayacaktır.

   İşlem bittikten sonra Craft CMS yönetim paneli giriş ekranına yönlendirileceksiniz.

Adım 6: İlk Yapılandırma ve Keşif

Craft CMS yönetim paneline giriş yaptıktan sonra aşağıdaki ilk ayarları yapabilirsiniz:

1. .env Dosyasını Kontrol Edin: Craft CMS, ortam değişkenlerini yönetmek için .env dosyası kullanır (veritabanı bağlantı bilgileri dahil). Kurulum sırasında otomatik oluşturulur, proje kökünde (servbay-craft-app/) bulunur. Gerekirse burada örneğin CRAFT_ENVIRONMENT ayarını dev olarak değiştirebilirsiniz.
2. Eklenti Kurulumu: Yönetim panelinde “Eklentiler (Plugins)” bölümünden çeşitli Craft CMS eklentilerini gezebilir, kurabilir ve yönetebilirsiniz.
3. İçerik Yapısı Oluşturun: “Ayarlar (Settings)” bölümünde kendi alanlarınızı tanımlayabilir, bölümler (Sections), kategoriler (Categories) ve etiketler (Tags) gibi içerik yapılarınızı düzenleyebilirsiniz.
4. E-posta Ayarlarını Yapılandırma: Yerelde e-posta gönderimini test etmek için Craft CMS’i ServBay’de gelen Mailpit veya Mailhog ile kullanabilirsiniz. Bu işlem için .env dosyasında veya yönetim panelindeki e-posta ayarlarında SMTP’yi seçin; sunucu adresi genellikle localhost, port ise ServBay panelinde belirtilen Mailpit/Mailhog SMTP portudur.

Sıkça Sorulan Sorular (SSS)

• S: Kurulumda veritabanı bağlantı hatası alıyorum, ne yapmalıyım?
  • C: Craft CMS kurulum ekranında girdiğiniz veritabanı sunucu adresi (localhost), veritabanı adı, kullanıcı adı ve şifrenin phpMyAdmin’da oluşturduklarınızla birebir uyumlu olduğundan emin olun. Ayrıca ServBay’de ilgili veritabanı hizmetinin (MySQL veya PostgreSQL) çalıştığından emin olun.
• S: servbay-craft.local adresine gidince 404 veya beyaz ekran alıyorum?
  • C:
    • ServBay’de site eklerken “Site kök dizini”nin tam olarak /Applications/ServBay/www/servbay-craft-app/web dizinine işaret ettiğinden emin olun. Bu, en sık yapılan hatadır.
    • ServBay’de web sunucusu (Caddy veya Nginx) ve PHP hizmetinin çalıştığından emin olun.
    • ServBay site listesinde servbay-craft.local sitesinin aktif olduğuna bakın.
• S: Composer ile Craft CMS kurulumu çok yavaş veya başarısız oluyor?
  • C: Bu, genellikle ağ bağlantısı veya Composer paket kaynağı ile ilgilidir. Composer’ın yansısını (mirror) Aliyun ya da Packagist China’ya geçirmek hız kazandırabilir.
• S: Kurulumdan sonra yönetici paneli veya ön yüz tasarım ve görselleri kayboluyor/gözükmüyor?
  • C: Bu, genellikle dosya izinlerinden kaynaklanır. ServBay’in çalıştığı kullanıcının storage ve web/cpresources gibi klasörlere yazma izni olduğundan emin olun. ServBay genelde izinleri otomatik ayarla; sorun yaşanıyorsa ilgili klasörlere manuel olarak yazma izni verebilirsiniz.

Özet

Yukarıdaki adımları tamamladıysanız, ServBay yerel geliştirme ortamında Craft CMS’i başarıyla kurup yapılandırmış olmalısınız. ServBay’in bütünleşik ortamı PHP sürümü yönetimi, veritabanı ayarları ve web sunucusu yapılandırmasını kolaylaştırarak odak noktanızın doğrudan Craft CMS geliştirme olmasını sağlar. Artık Craft CMS’in güçlü içerik modelleme özellikleriyle kendi web sitenizi veya uygulamanızı geliştirmeye başlayabilirsiniz.