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

Genel Bakış

OctoberCMS, güçlü Laravel çatısı üzerine inşa edilmiş, açık kaynaklı bir içerik yönetim sistemi (CMS) olup sadeliği, esnekliği ve geliştirici dostu özellikleriyle öne çıkar. Bu doküman, macOS için geliştirilmiş hepsi bir arada yerel web geliştirme ortamı olan ServBay üzerinde OctoberCMS’yi başarılı bir şekilde kurup yapılandırmanıza rehberlik etmektedir. Böylece OctoberCMS tabanlı projelerinize hızlıca başlayabilirsiniz.

OctoberCMS Nedir?

OctoberCMS, kullanıcı dostu bir arka uç paneli ve gelişmiş ön yüz geliştirme yetenekleri sunar. Geliştiriciler Eloquent ORM, Blade şablon motoru gibi tanıdık Laravel kavramlarını kullanarak basit bloglardan karmaşık kurumsal uygulamalara kadar çeşitli web siteleri oluşturabilirler.

Ön Gereksinimler

OctoberCMS kurulumuna başlamadan önce aşağıdaki koşulları sağladığınızdan emin olun:

1. ServBay, macOS sisteminizde kurulu ve çalışıyor olmalı.
2. ServBay'de PHP (en az 7.4 veya üstü önerilir) ve MySQL/MariaDB paketleri etkinleştirilmiş olmalı.
3. Composer paketi ServBay içerisinde aktif olmalı.
4. Temel komut satırı işlemleri hakkında bilgi sahibi olmalısınız.

OctoberCMS Kurulum Adımları

ServBay ortamında OctoberCMS’nin kurulumu ve yapılandırılması için ayrıntılı adımlar aşağıdadır:

Adım 1: Proje Dizini Oluşturun

Öncelikle, ServBay’in önerdiği web kök dizini olan /Applications/ServBay/www yoluna gidin ve burada OctoberCMS projeniz için yeni bir klasör oluşturun.

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

Adım 2: Composer ile OctoberCMS Kurulumu

ServBay, Composer'ı önceden yüklemiş ve yapılandırmıştır. Composer paketinin ServBay kontrol panelinde etkin olduğundan emin olun. Ardından, oluşturduğunuz proje dizininde aşağıdaki Composer komutunu çalıştırarak OctoberCMS'nin çekirdek dosyalarını indirin ve kurun:

composer create-project october/october .

Bu komut, OctoberCMS’nin en yeni sürümünü resmi deposundan mevcut dizine (.) indirecektir.

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

OctoberCMS; içerik, kullanıcılar ve yapılandırma gibi bilgileri depolamak için bir veritabanına ihtiyaç duyar. ServBay ile birlikte gelen phpMyAdmin aracıyla veritabanı ve kullanıcı oluşturacağız.

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

   Tarayıcınızı açın ve ServBay'in yerel geliştirme paneli olan https://servbay.host/ adresine gidin. Ardından genellikle https://servbay.host/phpmyadmin/ şeklinde olan phpMyAdmin bağlantısına tıklayarak veritabanı yönetim aracına erişin.

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

   Güvenlik ve yalıtım için her uygulama için ayrı bir veritabanı ve kullanıcı oluşturulması önerilir.

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

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

   2. Yeni Kullanıcı Hesabı Ekleyin

      “Kullanıcı Hesabı Ekle” seçeneğine tıklayın. Aşağıdaki bilgileri doldurun:

      • Kullanıcı Adı: OctoberCMS’in veritabanına bağlanması için bir kullanıcı adı girin, örneğin october_user.
      • Sunucu Adı (Host): localhost veya 127.0.0.1 seçin — bu kullanıcı yalnızca yerelden veritabanına erişebilir, daha güvenli olur.
      • Şifre: Güçlü ve benzersiz bir parola belirleyin. Üretim ortamında asla örnek şifre olarak verilen password123 kullanmayın.
      • Şifreyi Tekrar Girin: Belirlediğiniz parolayı yeniden girin.
      • “Kullanıcı için veritabanı oluştur” bölümünde “Kullanıcı adı ile aynı adı taşıyan bir veritabanı oluştur ve tüm ayrıcalıkları ver” seçeneğini seçin. Bu, otomatik olarak october_user adında bir veritabanı oluşturur ve bu kullanıcının tüm ayrıcalıkları olur.
      • “Küresel Ayrıcalıklar” bölümünde “Tüm ayrıcalıkları ver” kutusunun işaretli olduğundan emin olun (bir önceki adımda otomatik tamamlandıysa ekstra bir işlem yapmanıza gerek yok).
      • Sayfanın altındaki “Git” düğmesine tıklayarak kullanıcı ve veritabanı oluşturma işlemini tamamlayın.

Adım 4: Web Sunucusunu Yapılandırın (ServBay'de Site Ekleme)

OctoberCMS uygulamanıza tarayıcıdan erişim sağlamak için ServBay üzerinde yeni bir yerel web sitesi yapılandırmanız gerekmektedir.

1. Yeni Bir Site Ekleyin

   ServBay kontrol panelini açın, sol taraftaki menüden “Siteler” (eski sürümlerde “Hostlar” olarak geçebilir) sekmesine tıklayın. Ardından “Site Ekle” butonuna basın.

   Gerekli bilgileri girin:

   • Ad: Siteye kolay tanıyabileceğiniz bir ad verin, ör. My OctoberCMS Site.
   • Alan Adı: Yerelde erişmek istediğiniz bir domain adı girin, ör. servbay-octobercms.local. Gerçek alan adıyla çakışmamak için .local uzantısını tercih edin.
   • Site Türü: PHP seçin.
   • PHP Sürümü: OctoberCMS'nin gereksinimini karşılayan ve ServBay’de etkin olan PHP sürümünü seçin.
   • Web Kök Dizini: Gözat butonuna tıklayarak 1. adımda oluşturduğunuz proje dizinini seçin: /Applications/ServBay/www/servbay-octobercms-app.

2. Yapılandırmayı Kaydedin ve ServBay’i Yeniden Başlatın

   Formu doldurduktan sonra kaydet düğmesine tıklayın. ServBay değişikliklerin uygulanması için genellikle ilgili yazılım paketlerini (ör. Caddy veya Nginx) ve ServBay’i yeniden başlatmanızı ister. Ekranda sunulan yönergeleri izleyin. ServBay, servbay-octobercms.local alan adını otomatik olarak yerelde (127.0.0.1) eşleştirir.

Adım 5: OctoberCMS Ortam Değişkenlerini Yapılandırma

OctoberCMS (Laravel tabanlı) uygulamaların çevresel ayarlarını ve veritabanı bağlantısı gibi bilgileri yönetmek için .env dosyasını kullanır.

1. Çevresel Ayar Dosyasını Kopyalayın

   Proje kök dizininizde (/Applications/ServBay/www/servbay-octobercms-app) env.example dosyasını .env olarak kopyalayın:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. .env Dosyasını Düzenleyin

   Favori metin düzenleyiciniz ile yeni oluşturduğunuz .env dosyasını açın. Veritabanı ile ilgili aşağıdaki ayarları, 3. adımda oluşturduğunuz bilgilerle güncelleyin:

   # ... diğer ayarlar ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Oluşturduğunuz veritabanı adı
   DB_USERNAME=october_user  # Oluşturduğunuz veritabanı kullanıcısı
   DB_PASSWORD=password123   # Oluşturduğunuz veritabanı şifresi
   
   # ... diğer ayarlar ...

   Önemli: DB_DATABASE, DB_USERNAME ve DB_PASSWORD alanlarını kendi veritabanı bilgilerinizle değiştirmenizi unutmayın.

Adım 6: OctoberCMS Kurulum Sihirbazını Çalıştırma

OctoberCMS, son ayarları tamamlamak için web tabanlı bir kurulum sihirbazı sunar. Bu adımda veritabanı migrasyonları ve yönetici hesabı oluşturulacaktır.

1. Kurulum Sayfasına Erişin

   Tarayıcıda, 4. adımda yapılandırdığınız yerel alan adının sonuna /install.php ekleyerek aşağıdaki gibi erişin:

   https://servbay-octobercms.local/install.php

   OctoberCMS'nin kurulum sihirbazı ekranını görmelisiniz.

2. Veritabanı Bilgilerini Girin

   Sihirbaz sizden veritabanı bağlantı bilgilerini talep edecek. .env dosyanızdakiyle aynı bilgileri kullanın:

   • Veritabanı Türü: MySQL
   • Veritabanı Sunucusu: localhost veya 127.0.0.1
   • Veritabanı Adı: october_user
   • Veritabanı Kullanıcısı: october_user
   • Veritabanı Şifresi: password123

   (Yine hatırlatmakta fayda var — kendi belirlediğiniz şifreyi kullanın)

3. Yönetici Bilgilerini Girin

   Kuruluma devam ederek istemenize göre OctoberCMS'nin yönetim paneline girişte kullanılacak yönetici adı, şifre, e-posta gibi bilgileri girin.

4. Kurulumu Tamamlayın

   Sihirbazda “Kur” veya ilgili butona tıklayın. Kurulum, veritabanı migrasyonunu ve uygulama anahtarı üretimini otomatik yapacaktır. Kurulum bitene kadar bekleyin.

Adım 7: Eklenti ve Tema Kurulumu (Opsiyonel)

Kurulum tamamlandıktan sonra OctoberCMS yönetim arayüzüne giriş yapabilirsiniz (https://servbay-octobercms.local/backend).

1. Eklenti Kurulumu

   Yönetici panelinde “Sistem” -> “Güncellemeler” -> “Eklentiler” bölümüne gidin. OctoberCMS Marketplace’de sunulan çok sayıda eklentiyi arayabilir ve yeni özellikler ekleyebilirsiniz.

2. Tema Kurulumu

   “Sistem” -> “Güncellemeler” -> “Temalar” sekmesinden, projenize uygun tema seçip kurabilirsiniz.

Kurulum Sonrası Temel Yapılandırma ve Kullanım

OctoberCMS’yi başarıyla kurduktan sonra sitenizi inşa etmeye başlayabilirsiniz. Sık yapılan ilk adımlardan bazıları şunlardır:

• Ön Yüzü Görüntüleme: https://servbay-octobercms.local/ adresinden sitenizin ön yüzünü (çoğunlukla varsayılan temayla) görebilirsiniz.
• Yönetici Paneline Giriş: https://servbay-octobercms.local/backend adresinden yönetici hesabınızla giriş yapabilirsiniz.
• Sayfa Oluşturma: Yönetici panelinde “CMS” -> “Sayfalar” sekmesinde yeni sayfalar oluşturup düzenleyebilirsiniz.
• İçerik Bloğu Oluşturma: “CMS” -> “İçerikler” altında tekrar kullanılabilir içerik blokları oluşturabilirsiniz.
• Tema Yapılandırması: “CMS” -> “Temalar” kısmında mevcut temanın ayarlarını, şablonlarını ve parçalarını yapılandırabilirsiniz.
• Kullanıcılar ve Yetkiler: “Sistem” -> “Yönetim” menüsünden yönetici kullanıcıları ve izinlerini yönetebilirsiniz.

Sıkça Sorulan Sorular (SSS)

• Soru: servbay-octobercms.local adresine gidince ServBay varsayılan sayfası veya hata mı çıkıyor?
  • Cevap: ServBay kontrol panelinden servbay-octobercms.local sitesini başarıyla eklediğinizden ve web kök dizininizin /Applications/ServBay/www/servbay-octobercms-app olarak ayarlandığından emin olun. Herhangi bir değişiklik veya yeni ekleme yaptıktan sonra ServBay'i ve ilgili paketleri yeniden başlattığınızdan emin olun. Caddy/Nginx ve PHP'nin çalışıyor olup olmadığını kontrol edin.
• Soru: https://servbay-octobercms.local/install.php adresinde boş beyaz ekran veya hata mı çıkıyor?
  • Cevap: Bu genellikle bir PHP hatasıdır. ServBay kontrol panelinden PHP hata günlüklerine bakın ve nedenini bulun. Yaygın nedenler: dosya izinleri (özellikle storage, themes, plugins klasörleri ve alt klasörlerinin web sunucu kullanıcısı tarafından yazılabilir olması), uyumsuz PHP sürümü, eksik PHP eklentileri.
• Soru: Kurulum sırasında veritabanı bağlantı hatası alıyorum, neden?
  • Cevap: .env dosyasındaki DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD gibi veritabanı erişim bilgilerinin phpMyAdmin’de oluşturduklarınızla birebir uyuştuğundan emin olun. Ayrıca ServBay’de MySQL/MariaDB paketinin çalıştığını kontrol edin.
• Soru: composer create-project komutu başarısız mı oluyor?
  • Cevap: ServBay kontrol panelinde Composer ve PHP paketlerinin aktif, PHP sürümünüzün uyumlu olduğundan emin olun. Ağ bağlantınızı kontrol edin; Composer kurulum sırasında dosya indirir.

Sonuç

ServBay’in sunduğu pratik ve hızlı ortam ile macOS üzerinde OctoberCMS’yi kolayca kurup yapılandırabilirsiniz. Bu rehberdeki adımları izleyerek güçlü ve geliştirici dostu bir yerel geliştirme altyapısında yeni web projenize hazır olacaksınız. Artık OctoberCMS'nin tüm olanaklarını keşfetmeye başlayabilir ve harika siteler geliştirebilirsiniz!