İlk Sitenizi Ekleyin

ServBay'de yeni bir web sitesi eklemek ve yerel geliştirme projenizi başlatmak son derece kolay ve sezgiseldir. Bu dokümanda, ServBay'de ilk web sitenizi nasıl ekleyeceğiniz, adım adım işlemler, önemli yapılandırma seçenekleri ve bazı pratik ipuçları ayrıntılı şekilde ele alınmıştır.

İster PHP, Node.js projeleri, ister statik siteler geliştirin; ister ters proxy veya yönlendirme yapılandırın, ServBay tüm bu senaryolara esnek destek sunar.

Genel Bakış

ServBay, web geliştiricileri için güçlü ve kolay yönetilebilir bir yerel geliştirme ortamı sunmayı amaçlar. Kullanıcı dostu grafik arayüzü (GUI) sayesinde, birçok yerel web sitesini kolayca ekleyip, yapılandırıp yönetebilirsiniz. Aşağıdaki adımları izleyerek ServBay'de ilk yerel sitenizi hızlıca oluşturabilir ve proje gereksinimlerinize uygun ayarları yapılandırabilirsiniz.

Önkoşullar

Web sitesi eklemeye başlamadan önce:

• ServBay uygulamasını başarılı bir şekilde macOS üzerinde kurup başlattığınızdan emin olun.

Site Ekleme Adımları

Aşağıda, ServBay arayüzüyle yeni bir web sitesi eklemenin ayrıntılı adımlarını bulabilirsiniz:

Adım 1: ServBay Uygulamasını Açın

Öncelikle, macOS uygulama klasörünüzde ServBay simgesini bulun ve çift tıklayarak uygulamayı başlatın.

Adım 2: Site Yönetim Ekranına Gidin

ServBay başlatıldıktan sonra ana arayüzü göreceksiniz. Sol taraftaki menüden Web Siteleri olan seçeneğe tıklayın. Bu sizi ServBay'in site yönetim sayfasına götürecektir.

Adım 3: Yeni Site Eklemeye Başlayın

Site yönetimi sayfasında, sol alt köşedeki + butonunu bulun ve tıklayın. Tıklandığında, ekranın sağında yeni bir form alanı görünecektir; burada yeni siteye özel ayarlarınızı girebilirsiniz.

Adım 4: Site Ayarlarını Yapılandırın

Açılan site ayarları formunda aşağıdaki temel bilgileri doldurmalı veya seçmelisiniz:

1. İsim: Yerel web siteniz için tanınabilir bir isim belirleyin. Bu, ServBay içinde sitelerinizi yönetirken/kategorilendirirken kullanılır.
2. Alan Adı: Sitenizi yerelde hangi alan adıyla açmak istediğinizi girin. Gerçek dünyadaki alan adlarıyla çakışma yaşamamak için .demo veya ServBay tarafından ayarlanan diğer yerel üst seviye alan adları (ör. servbay.demo veya projem.servbay.demo) kullanmanızı kesinlikle öneririz. ServBay, yerel DNS çözümlemesini otomatik ayarlayarak bu alan adıyla tarayıcıda sitenize erişimi sağlar.
3. Protokol: Sitenizin destekleyeceği protokolü seçin. Varsayılan olarak genellikle HTTP/HTTPS seçili olur ve ServBay, yerel HTTPS yapılandırmasını sizin için otomatik halleder.
4. SSL Sertifikası Alma Yöntemi: Yerel siteniz için SSL/TLS şifrelemesi yapılandırılır.
   • ServBay CA: Yerel geliştirme için önerilir. ServBay, entegre PKI altyapısı sayesinde kendi kök sertifikası ile imzalanmış SSL sertifikasını otomatik olarak üretip yönetir. Tek yapmanız gereken, macOS'ta ServBay'in kök sertifikasına güvenmek (ServBay User CA veya ServBay Public CA); böylelikle tarayıcıda HTTPS erişiminde uyarı görmezsiniz.
   • ACME: Eğer üretim ortamını simüle etmek istiyorsanız ve alan adınız halka açık kullanılabiliyor ve ServBay örneğine yönleniyorsa, ACME protokolüyle (ör. Let's Encrypt, ZeroSSL, Google Trust Services vs.) gerçek bir herkese açık SSL sertifikası alabilirsiniz. ServBay, ACME ile otomatik sertifika başvurusu ve yenilemeyi destekler.
5. Site Türü: Projenizin teknik altyapısına uygun türü seçin:
   • PHP: PHP tabanlı projeler için uygundur (ör: WordPress, Laravel, Symfony). ServBay, bir web sunucusu (Nginx veya Apache) ile PHP-FPM iş birliğinde PHP isteklerini işler.
   • Node.js: Node.js uygulamaları için idealdir. ServBay, genellikle yönlendiriciyle web isteklerini Node.js uygulamanızın dinlediği porta aktarır.
   • Statik: Tamamen statik (HTML, CSS, JavaScript vb.) dosyalardan oluşan siteler için uygundur. Web sunucusu doğrudan dosya servisi sağlar.
   • Ters Proxy: Belirli bir alan adı veya yolun isteğini başka bir yerel/uzaktaki adrese veya porta yönlendirir. Diğer servis veya uygulamalara proxy ihtiyaçlarda kullanılır.
   • Yönlendirme: Bu alan adına gelen tüm istekleri başka bir URL'ye yönlendirir.
6. PHP Sürümü: Eğer site türü PHP ise, açılır listeden kurulu ve çalışan bir PHP sürümü seçmelisiniz. Gerekli olan PHP sürümünü, ServBay'in paket yönetim arayüzünden daha önce yüklediğinizden emin olun.
7. URL Yeniden Yazma (Statik Olmayan): Pek çok modern web framework ve içerik yönetim sistemi (CMS), temiz URL yapısı sağlamak için (örn. /hakkimizda yerine /index.php?page=hakkimizda) URL yeniden yazma kuralları gerektirir. ServBay, Laravel, WordPress, Discuz! gibi popüler uygulamalar için hazır yeniden yazma kuralı şablonları sunar; doğrudan seçip uygulayabilirsiniz. Eğer özel framework veya kendi kurallarınız varsa, Nginx veya Apache yapılandırma dosyalarını kendiniz düzenlemeniz gerekebilir.
8. Kök Dizin: Sitenizin gerçek dosya yolunu belirtin. Web sunucusunun dosyaları arayıp sunmaya başlayacağı dizin burasıdır. Proje dosyalarınızı ServBay'in varsayılan www klasörüne (örn: /Applications/ServBay/www/servbay-demo) koymanız önerilir. Dizin varolmalı ve ServBay uygulama kullanıcısı tarafından okunabilir olmalıdır.

WARNING

Framework kullanan geliştiriciler (ör. Laravel) için: Kök dizini, proje ana klasörü yerine içinde index.php dosyası bulunan public klasörüne yönlendirdiğinizden emin olun.

Adım 5: Siteyi Kaydedin ve Aktifleştirin

Tüm bilgileri eksiksiz doldurup kontrol ettikten sonra, formun altındaki Ekle butonuna tıklayın. ServBay, yeni site için gerekli sunucu yapılandırmasını (ör. Nginx veya Apache için) otomatik oluşturup yükler ve yerel DNS ayarlarını günceller.

Kayıt başarılı olduğunda, yeni sitenizin yapılandırması site listesinden görülebilir. Sağ üstteki tarayıcı simgesine tıklayarak sitenizi hızlıca ziyaret edebilirsiniz.

Adım 6: Hızlı İşlemlerle Siteyi Yönetin

ServBay, listedeki her site için geliştirme sürecinizi kolaylaştıracak bir dizi pratik hızlı işlem düğmesi sunar:

1. IDE ile Aç: Sitenizin kök dizinini varsayılan kod editörünüzde veya IDE'nizde anında açın.
2. Tarayıcıda Aç: Sitenin URL'sini doğrudan varsayılan web tarayıcınızda açar.
3. Site Günlüklerini Görüntüle: Sunucu erişim ve hata günlüklerini inceleyip kolayca hata ayıklayın.
4. Siteyi Durdur/Başlat: Geçiçi olarak sitenin erişimini devre dışı bırakıp tekrar aktif hale getirin.
5. Siteyi Sil: ServBay içindeki sitenizi kaldırır; fakat sitenin dosyalarını silmez.

Basit Örnek: Statik Bir HTML Sitesi Oluşturun

İlk sitenizin doğru yapılandırıldığını test etmek için aşağıdaki adımları takip edebilirsiniz:

1. Yukarıdaki adımları izleyerek yeni bir site ekleyin; örneğin alan adını servbay.demo, site türünü Statik, kök dizini /Applications/ServBay/www/servbay-demo-static olarak belirleyin.

2. Dosya sisteminizde, belirtilen kök dizini (/Applications/ServBay/www/servbay-demo-static) oluşturun.

3. Bu dizinde index.html adlı bir dosya oluşturun.

4. Bir metin editöründe index.html dosyasını açıp aşağıdaki basit HTML kodunu ekleyin:

   <!DOCTYPE html>
   <html>
   <head>
       <title>ServBay Static Test</title>
   </head>
   <body>
       <h1>Tebrikler! İlk ServBay siteniz başarıyla çalışıyor!</h1>
       <p>Bu sayfayı görüyorsanız, ServBay statik sitenizi başarıyla yapılandırıp servis ediyor demektir.</p>
   </body>
   </html>

5. index.html dosyasını kaydedin.

6. ServBay site yönetimine dönün, eklediğiniz servbay.demo sitesini bulun ve hızlı işlem menüsündeki tarayıcı simgesine tıklayın.

7. Tarayıcınızda http://servbay.demo (veya SSL ayarınıza göre https://servbay.demo) adresi açılacak ve hazırladığınız index.html görünecektir.

Dikkat Edilmesi Gerekenler

• Alan Adı Çakışması: Yerel ağınız veya VPN'le çakışabilecek alan adlarından kaçının. .demo kullanmak güvenlidir.
• Kök Dizin Yetkileri: ServBay'in çalıştığı kullanıcı (genellikle siz) site kök dizinine ve altındaki dosyalara okuma iznine sahip olmalıdır.
• Port Çakışması: ServBay, varsayılan olarak 80 (HTTP) ve 443 (HTTPS) portlarını kullanır. Başka uygulamalar bu portları kullanıyorsa, ServBay web sunucusu başlatılamayabilir ya da sitenize erişilemiyebilir. Bu portlarda çalışan uygulamaları kapatmalısınız.
• ServBay CA Güvenliği: ServBay CA ile HTTPS'ye sorunsuz erişim için ServBay User CA veya ServBay Public CA'ya macOS üzerinde güvenmelisiniz. Buna dair ayrıntılı yönerge genellikle ServBay dokümantasyonunda bulunur.

Sıkça Sorulan Sorular (SSS)

• S: Sitemi açarken HTTP Error 403 - Forbidden veya HTTP Error 404 - File not found uyarısı görüyorum, neden?
  • C: Bu, çoğu geliştiricinin karşılaştığı yaygın bir sorundur.
  • Öncelikle, sitenizin kök dizini doğru şekilde ayarlanmış mı diye kontrol edin. Modern frameworklerde (Laravel, Symfony, CakePHP vb.), güvenlik ve proje yönetimi için proje ana dizini (ör: vendor, composer.json, package.json dosyalarını içeren dizin) gerçekte sitenin kök dizini/ana giriş noktası değildir.
  • Yani, sitenin kök dizinini doğru şekilde, giriş dosyasının (index.php, index.htm, index.html) yer aldığı dizine yönlendirmelisiniz.
  • Yaygın giriş dizinleri: public, web, www, htdocs, wwwroot, webroot vb.
• S: Site ekledim ama tarayıcıda alan adını yazınca "Bu siteye ulaşılamıyor" veya "Bağlantı reddedildi" diyor, ne yapmalıyım?
  • C: Öncelikle ServBay'in çalışır durumda olup olmadığını ve web sunucusunun (Caddy/Nginx/Apache) aktif olduğunu kontrol edin (ana ekranda görebilirsiniz).
  • Tarayıcıda yazdığınız alan adının ServBay'de ayarlanan alan adıyla tamamen aynı olduğundan emin olun.
  • Site listesinde ilgili sitenin "çalışır" konumda (durdurulmamış) olduğundan emin olun.
  • Kök dizin yolunun doğru olduğunu ve o dizinde giriş dosyası (ör. index.html, index.php) bulunduğunu kontrol edin.
  • 80 ya da 443 portunun başka bir programca kullanılıp kullanılmadığını kontrol edin.
• S: PHP sitem beklenildiği gibi çalışmıyor, boş sayfa açılıyor ya da dosya indirilmeye başlıyor; sebebi nedir?
  • C: Doğru PHP sürümünü seçip seçmediğinizi kontrol edin ve bu PHP sürümünün paket yönetiminde kurulu ve çalışır durumda olduğundan emin olun.
  • Site kök dizinindeki dosya yetkilerini gözden geçirin.
  • Hata günlüklerinde PHP ile ilgili hata mesajı olup olmadığını (hızlı işlem sayesinde görebilirsiniz) kontrol edin.
  • Projenizde index.php veya ServBay'in ayarladığı varsayılan index dosyalarından biri bulunuyor mu, ona bakın.
• S: HTTPS ayarladım ama tarayıcı sertifika uyarısı gösteriyor, çözümü nedir?
  • C: ServBay CA kullanıyorsanız, işletim sistemi veya tarayıcıda ServBay kök sertifikasına güven vermelisiniz. Bunun için resmi ServBay dokümantasyonundaki "CA sertifikası güven verme" adımlarına bakın.
  • ACME kullanıyorsanız, alan adınızın ServBay örneğine doğru şekilde yönlendiği ve sertifikanın başarıyla alınıp kurulduğu konusunda emin olun. ACME işlemlerinin ayrıntıları ve hata açıklamaları için ServBay günlüklerine bakın.
• S: URL yeniden yazma kuralları çalışmıyor, bazı sayfalar açılmıyor; neden?
  • C: Site ayarlarından uygulamanıza uygun bir URL yeniden yazma kuralı seçtiğinizden emin olun.
  • Apache kullanıyorsanız, .htaccess dosyasının site kökünde veya alt klasörde bulunduğunu ve ServBay Apache ayarlarının .htaccess dosyasını okumaya izin verdiğini kontrol edin.
  • Nginx veya Caddy kullanıyorsanız, yeniden yazma kuralları ServBay tarafından oluşturulan yapılandırma dosyalarında yer alır, doğru şekilde yüklendiğinden emin olun.

Sonuç

Bu makaledeki adımları takip ederek ServBay'in yerel geliştirme ortamında ilk web sitenizi başarıyla ekleyip çalıştırmış olmalısınız. ServBay'in gelişmiş site yönetim özellikleri, esnek yapılandırma seçenekleri (ör. SSL sertifikası, site türü, PHP sürümü, URL yeniden yazma) ve pratik hızlı işlemleri yerel geliştirme verimliliğinizi üst seviyeye çıkaracaktır. Yazılım paket yönetimi, veritabanı yönetimi gibi diğer ServBay özelliklerini de keşfederek eksiksiz bir yerel geliştirme iş akışı oluşturabilirsiniz.