İpuçları

Herne’de Laravel uygulamaları çalıştırırken yararlı ipuçları ve sık karşılaşılan sorunlar.

İlk dağıtım kontrol listesi

public dizininden web_root dizinine geçiş — Eski site yapisini tasiyorsaniz, document root degistirmeden once mevcut public/ dizinini web_root altina tasiyin.

  1. Siteyi oluşturun ve Git repo, .env, ve veritabanı ayarlamak için Kurulum Sihirbazını çalıştırın.
  2. Eğer daha eski bir siteyi güncelleştiriyorsanız, belgenin kökünü değiştirmeden önce eski /var/www/domain/public dizinini /var/www/domain/web_root ye taşıyın.
  3. İlk deploy'dan sonra APP_KEY boşsa Artisan'dan php artisan key:generate çalıştırın.
  4. Eğer uygulamanız public disk depolama kullanıyorsa Artisan komut satırından storage:link'i çalıştırın.
  5. Artisan komut satırından migrate --force'i çalıştırın veya Deploy Config'de göç adımını etkinleştirin.

Hızlı kurulumu yeniden deneme

Eğer WebBlocks CMS Quick Install başarısız olursa, uygulama loglarını açın, raporlanan veritabanı, izin, DNS veya yürütme problemini düzeltin, sonra Yeniden Yükleme kullanın. kurulum, tekrar denemeden önce güvenli kısmi dosyaları temizler ve tamamlanmış kurulumları üst yazılmaktan korur.

Ortam ayarları için iyi uygulamalar

  • Tüm canlı sitelerde .env dosyasında APP_ENV=production ve APP_DEBUG=false ayarlayın.
  • .env'i değiştirdikten sonra, optimize:clear'yi çalıştırın ya da Artisan koşucusundan cache'leri yeniden yapın.
  • SESSION_DRIVER=file veya database'yi seçin — üretimde cookie'ten kaçının.
  • Kuyruğa alınan işler kullanıyorsanız QUEUE_CONNECTION=database (veya redis) ayarını yapın. Üretimde sync kullanmayın.

DNS ve SSL

  • DNS yayılması zaman alabilir. A kayıt eşleşmelerini katı tut; yanlış sunucuya işaret eden bir sunucu adını görmezden gelme.
  • Yöneticiler Yönetici → DNS bağlantıları altında birden fazla Hetzner DNS hesabı ekleyebilir. Her alan adını kendi bölgesine sahip olan bağlantıya bağlayın.
  • Eğer bir bölge başka bir Hetzner hesabına taşınırsa, yeni bağlantıya token'ı güncelleyin veya alan adı ekleyin, sonra DNS Bölgesi'ne yeniden bağlan kullanın.
  • Göç etmiş dış DNS bölgeleri için, A kaydı doğru olduğunda apex NS uyarıları bilgilendirici olabilir.
  • Takma adlar ekledikten sonra, Herne'nin canlı sertifika kapsamını kontrol etmesi için Ayarlar → SSL / HTTPS → SSL’yi yeniden eşitle kullanın.

Uygulama türünü düzeltme

Eğer bir site Boş / dağıtım hedefi veya Statik site olarak oluşturulmuşsa, ancak bir operatör daha sonra Laravel'i /public belge köküne sahip kanonik web_root'e yerleştirmişse, bir yönetici Site → Ayarlar → Genel → Uygulama çalışma ortamı'i açabilir ve Laravel'e Geç'yı seçebilir.

Bu işlem yalnızca Herne’nin yönetim üst verilerini düzeltir. Laravel kurmaz, uygulamayı incelemez veya onarmaz, dosyaları taşımaz, Nginx’i değiştirmez, veritabanı geçişlerini çalıştırmaz ve kuyruk çalışanı başlatmaz. Onaydan önce dağıtılan uygulamayı ayrı olarak doğrulayın. Ardından yalnızca Laravel ile çalışan her özelliğin kendi ön kontrolünü çalıştırın.

Kuyruk çalışanları

Herne kuyruk çalışanlarını yönetmez. Kuyruk çalışanlarını çalıştırmak için:

  1. Sunucu → Cron işleri e git
  2. Ekle: * * * * * cd /var/www/domain && php artisan queue:work --stop-when-empty >> /dev/null 2>&1

Bu çalışanı her dakika çalıştırır ve kuyruk boş olduğunda çıkar (cron altında uzun süreli bir süreçten daha güvenlidir).

Depolama izinleri

Eğer storage/ veya bootstrap/cache/ üzerinde erişim reddedildi hataları alırsanız, Terminal'den çalıştırın:

chmod -R 775 storage bootstrap/cache

İlk yüklemenin yavaş olması

Deploy Config aracılığıyla config/route önbelleklemeyi etkinleştirdikten sonra, yeni bir yüklemeden sonraki ilk talep OPcache ısındığında yavaş olabilir. Bu normaldir.

WebBlocks UI dosyaları

Herne WebBlocks UI'yi resources/views/partials/_webblocks-assets.blade.php ve App\Support\WebBlocksUiAssets üzerinden yükler. Kaldırılmış /public/webblocks-ui varlık dizinine yeni referanslar ekleme.