Site Kurulum Sihirbazı

Git deposunu bağlamak, .env dosyasını doldurmak, veritabanı oluşturmak ve ilk dağıtımı çalıştırmak için dört adımlı sihirbazı izleyin.

Desteklenen uygulamalarda Siteler → Uygulamalar → Hızlı Kurulum daha hızlıdır. Kendi deponuzu bağlamak, ortamı ve veritabanını yapılandırmak ve ilk dağıtımı elle yönetmek için sihirbazı kullanın.

Örnek Laravel sitesi

Yeni bir site oluşturup git@github.com:example/example.com.git gibi bir Laravel deposunu dağıtmak istiyorsanız, Kurulum Sihirbazı en hızlı yoldur.

Başlamadan önce

  • Önce Siteler → Yeni Site üzerinden siteyi oluşturun.
  • Laravel için başlangıçtaki belge kökünü web_root/public olarak bırakın.
  • Sihirbazı açmadan önce doğru alan adını ve PHP sürümünü seçin.
  • Kök alan adı kullanıyorsanız siteyi oluştururken isteğe bağlı www takma adını etkinleştirebilirsiniz.

1. adım — Dağıtım

Git deposu ve dağıtım bilgilerini girin.

  • Depo URL’si: git@github.com:example/example.com.git
  • Dal: depo başka bir dal kullanmıyorsa genellikle main
  • Dağıtım yolu: projeyi doğrudan sitenin web_root dizinine klonlamak için son eki boş bırakın.

Laravel projeleri için önerilen derleme seçenekleri şunlardır.

  • composer install: etkin
  • npm build: yalnızca yönetilen projenin Node tabanlı bir ön yüz derleme adımı varsa etkinleştirin. Herne Panel’in kendisi npm gerektirmez.
  • php artisan migrate: 3. adımda veritabanını oluşturup aynı bilgileri .env dosyasına yazacaksanız etkinleştirin.
  • optimize / cache clear: etkin

SSH depo adresi girildiğinde, destekleniyorsa dağıtım anahtarı otomatik oluşturulur. Anahtarı daha sonra Dağıtım sayfasından da oluşturabilirsiniz.

2. adım — .env

Uygulamanın üretim ortamına ait .env değerlerini yapıştırın veya düzenleyin. En azından şu ayarları gözden geçirin:

  • APP_NAME
  • APP_ENV=production
  • APP_URL=https://your-domain
  • DB_DATABASE, DB_USERNAME, DB_PASSWORD
  • Uygulamanın ihtiyaç duyduğu e-posta, kuyruk, önbellek ve üçüncü taraf API ayarları.

Uygulama önbellek, oturum veya kuyruk için Redis kullanıyorsa kaydetmeden önce Redis varsayılanlarını uygula seçeneğini kullanın.

Yeni bir sitede depo henüz klonlanmadığı için .env.example bu aşamada sihirbazda bulunmayabilir. Değerleri elle yapıştırmaya hazır olun.

3. adım — Veritabanı

Laravel uygulamanızın ihtiyacı varsa bir MySQL veritabanı oluşturun.

  • Veritabanı adını girin.
  • Veritabanı kullanıcı adını girin.
  • Güçlü bir parola belirleyin.
  • Aynı değerlerin .env dosyasına yazıldığından emin olun.

Proje veritabanı kullanmıyorsa bu adımı atlayabilirsiniz.

Veritabanı sunucuda zaten varsa sihirbazı tamamlayın. Ardından veritabanını siteye bağlamak için Siteler → Veritabanları → Mevcut veritabanını bağla seçeneğini kullanın.

4. adım — İlk dağıtım

Git deposu özelse ve sihirbaz dağıtım anahtarının açık kısmını gösteriyorsa şu adımları uygulayın.

  1. Açık anahtarı sihirbazdan kopyalayın.
  2. GitHub’da depoyu açın.
  3. Settings → Deploy keys → Add deploy key yolunu izleyin.
  4. Anahtarı yapıştırın. Yazma erişimine özel olarak ihtiyacınız yoksa anahtarı salt okunur bırakın.

Depoyu klonlamak ve seçili adımları çalıştırmak için Şimdi Dağıt düğmesine tıklayın.

İlk dağıtımdan sonra

Laravel projelerinde ilk dağıtımdan sonra genellikle birkaç ek kontrol gerekir.

  • APP_KEY boşsa php artisan key:generate çalıştırın.
  • Proje genel depolama sembolik bağlantısını bekliyorsa php artisan storage:link çalıştırın.
  • Dağıtım hata verirse Siteler → Günlükler bölümünü inceleyin.
  • Dağıtımdan sonra Nginx veya PHP-FPM hataları varsa Siteler → Günlükler → Sunucu günlükleri bölümüne bakın.
  • Site açılırken yapılandırma sorunları yaşanıyorsa Siteler → Ortam ve Siteler → Artisan bölümlerini inceleyin.

Hızlı kurulum seçeneği

WebBlocks CMS veya boş bir Laravel uygulaması kurmak için Siteler → Uygulamalar → Hızlı Kurulum sayfasını kullanın. WebBlocks CMS kurulumu veritabanı bilgilerini üretir ve CMS’yi hazırlar. Laravel App seçeneği yalnızca Laravel iskeletini kurar, böylece QuizTem gibi paketleri daha sonra Composer veya Terminal üzerinden ekleyebilirsiniz. Her iki seçenek de güvenli .env değerlerini yazar, APP_KEY değerini korur, gerekli dizinlerin yazılabilirliğini denetler ve yarım kalan kurulumu temizleyerek yeniden denemeye izin verir.