Statamic güvenle nasıl güncellenir (ve nasıl geri dönülür)
6 dk okuma
Statamic güncellemesini olaysız kılan sıra. Sürümü öğrenin, doğru klasörleri yedekleyin, Composer ile önce kopyada güncelleyin, doğru önbellekleri temizleyin ve bir şey bozulursa tek adımda geri dönün. Statamic 6 ile denendi.
Statamic'i güncellemek tek bir Composer komutudur. Güncellemenin olaysız mı yoksa kötü bir öğleden sonra mı olacağını o komutun çevresindekiler belirler: nerede çalıştırdığınız, öncesinde neyi kaydettiğiniz ve sonrasında neyi temizlediğiniz.
Buradaki komutları 12 Kasım 2026'da yeni bir Statamic 6.41.0 projesiyle denedik (Laravel 13, PHP 8.5).
Kısaca
- Güncelleme komutu:
composer update statamic/cms --with-dependencies. - İlk olarak canlı sitede çalıştırmayın. Bir kopyada çalıştırın, deneyin, sonra sonucu dağıtın.
- Güncellemeden önce
composer.lockdosyasını ve içeriğinizi tutan klasörleri kaydedin:content/,users/,resources/ve varlıklarınız. - Güncellemeden sonra
php please stache:warmçalıştırın; statik önbellek kullanıyorsanız onu da temizleyin. - Geri dönmek için
composer.jsonvecomposer.lockdosyalarını geri koyupcomposer installçalıştırın.
1. Elinizdekini bilin
php please --version
ve daha geniş tablo:
php please support:details
Laravel Version: 13.42.0
PHP Version: 8.5.12
...
Statamic
Sonra composer.json dosyasına bakın:
"statamic/cms": "^6.0"
^6.0 şu demektir: herhangi bir 6.x sürümü, asla 7 değil. Hangi tür güncelleme yapacağınızı bu belirler.
2. Küçük güncelleme mi, ana sürüm yükseltmesi mi?
Aynı ana sürüm içinde (6.38'den 6.41'e): küçük, sık ve güvenli olması amaçlanan güncellemeler. Statamic bunları sık yayımlar; 6.41.0, 11 Kasım 2026'da çıktı. Düzenli yapmanız gereken güncelleme budur, çünkü güvenlik düzeltmeleri bu yolla gelir.
Yeni bir ana sürüme (5'ten 6'ya): güncelleme değil, projedir. Gereksinim de değişir: en yeni Statamic 5 sürümü Laravel 12 ister, Statamic 6 ise Laravel 12.40 ya da 13. O sürümün resmi yükseltme rehberini baştan sona okuyun, composer.json içindeki kısıtı değiştirin:
"statamic/cms": "^6.0"
ve bir şeyleri düzeltmeyi bekleyin. Her seferinde bir ana sürüm ilerleyin.
3. Doğru şeyleri yedekleyin
Statamic içeriği veritabanında değil, dosyalarda tutar. Bu yedeklemeyi kolaylaştırır, ama ancak doğru klasörleri alırsanız:
| Ne | Nerede |
|---|---|
| Girdiler, taksonomiler, global değerler, gezinme | content/ |
| Kullanıcılar | users/ |
| Blueprint'ler, alan setleri, formlar, şablonlar | resources/ |
| Yüklenen varlıklar | genellikle public/assets/ (varlık kapsayıcılarınıza bakın) |
| Form gönderimleri | storage/forms/ |
| Tam paket sürümleri | composer.json ve composer.lock |
| Gizli değerler ve ayarlar | .env |
Proje Git'teyse bunların çoğu zaten kayıtlıdır: güncellemeden önce commit edin. Varlıklar, form gönderimleri ve .env genellikle Git'te değildir; onları kopyalayın.
İçeriği Eloquent sürücüsüyle veritabanına taşıdıysanız veritabanının dökümünü de alın.
4. Önce kopyada güncelleyin
Kendi makinenizde ya da sitenin hazırlık (staging) kopyasında:
composer update statamic/cms --with-dependencies
--with-dependencies, Composer'ın Statamic'in ihtiyaç duyduğu paketleri de güncellemesine izin verir. Onsuz güncelleme çoğu zaman çakışmayla durur.
Eklentileri ve geri kalan her şeyi de güncellemek için paket adı vermeden composer update çalıştırın. Bunu ayrı bir adım olarak yapın. Otuz paketi birden değiştirdikten sonra bir şey bozulursa hangisinin yaptığını bilemezsiniz.
Statamic, Composer güncellemesinden sonra kendi güncelleme betiklerini çalıştırır. Bunları elle yeniden çalıştırmanız gerekirse:
php please updates:run 6.38
Buraya geldiğiniz sürümü yazın.
5. Önbelleğe alınanı temizleyin
php artisan optimize:clear
php please stache:warm
Stache, Statamic'in içerik dosyalarınız için tuttuğu dizindir. Güncellemeden sonra bir kez yeniden oluşturun ki bedelini ilk ziyaretçi ödemesin.
Statik önbellek kullanıyorsanız:
php please static:clear
php please static:warm
Eski önbellek sayfalarını eski sürüm üretti. Onları tutmayın.
6. Ziyaretçi gibi ve editör gibi deneyin
- Ana sayfayı, bir koleksiyon sayfasını, bir girdiyi, bir taksonomi sayfasını açın.
- Bir form gönderin.
- Sitede arama varsa arama yapın.
/cpadresinden kontrol paneline girin. Bir girdi açın, değiştirin, kaydedin. Bir varlık yükleyin.storage/logs/laravel.logdosyasını okuyun.
Güncelleme sorunlarının çoğu ön yüzde değil, kontrol panelinde çıkar: yeni sürümü henüz desteklemeyen özel bir alan türü ya da eklenti. Ana sürüm yükseltmesinden önce her eklentinin desteklediği sürümlere bakın.
7. Sonucu dağıtın, güncellemeyi tekrarlamayın
Canlı sunucuda composer update çalıştırmayın. Az önce denediğiniz composer.lock dosyasını getirin ve şunu çalıştırın:
composer install --no-dev --optimize-autoloader
php artisan optimize
php please stache:warm
composer install, kilit dosyasındaki sürümleri birebir kurar: denediğiniz sürümleri. Sunucuda composer update ise o an en yeni olanı seçer; bu, hiç görmediğiniz bir sürüm olabilir.
8. İşler ters giderse
Kilit dosyası her sürümü adıyla yazdığı için geri dönüş kısadır:
git checkout HEAD~1 -- composer.json composer.lock
composer install --no-dev --optimize-autoloader
php artisan optimize:clear
php please stache:warm
Git yoksa 3. adımda kaydettiğiniz iki dosyayı geri koyun ve aynı komutları çalıştırın.
Güncelleme içerik dosyalarını da değiştirdiyse (bazı ana sürüm yükseltmeleri değiştirir) content/ ve resources/ klasörlerini de yedekten geri yükleyin.
Ne sıklıkla?
Küçük güncellemeler: birkaç haftada bir; bir sürüm güvenlik düzeltmesinden söz ediyorsa hemen. Bir yıl beklemek, on iki küçük güncellemeyi tek ve riskli bir büyük güncellemeye çevirir.
Zefily ile
Zefily, Statamic'i kendi sunucunuza tek tıkla kurar: Composer projesi, PHP sürümü, HTTPS ve süper kullanıcı hesabı sizin için hazırlanır. Güncellemeler için bu rehberin istediği iki şey panelde vardır: güncellemeyi üzerinde çalıştıracağınız bir hazırlık kopyası ve geri yükleyebileceğiniz yedekler. PHP uygulamaları ve Yedekler belgelerine bakın.
Sunucu tarafı için Statamic'i kendi sunucunuzda barındırmak yazısına bakın.
Sık sorulan sorular
Statamic'i güncelleme komutu nedir?
composer update statamic/cms --with-dependencies. Yerel ya da hazırlık kopyasında çalıştırın, deneyin, sonra composer.lock dosyasını dağıtıp sunucuda composer install çalıştırın.
Statamic'i güncellemeden önce veritabanı yedeği gerekir mi?
Genellikle hayır, çünkü Statamic içeriği dosyalarda tutar. content/, users/, resources/, varlıklarınız, storage/forms/ ve composer.lock'u yedekleyin. Veritabanı dökümünü yalnızca Eloquent sürücüsünü kullanıyorsanız alın.
Statamic güncellemesini nasıl geri alırım?
Önceki composer.json ve composer.lock dosyalarını geri koyun, composer install çalıştırın, sonra önbellekleri temizleyip php please stache:warm çalıştırın.
Canlı sunucuda composer update çalıştırmalı mıyım?
Hayır. Orada composer install çalıştırın; böylece sunucu, kilit dosyasındaki denediğiniz sürümleri birebir alır.
Statamic'i güncelledikten sonra ne çalıştırmalıyım?
php artisan optimize:clear ve php please stache:warm; statik önbellek kullanıyorsanız ayrıca php please static:clear ve static:warm.
Zefily'nin kurduğu uygulamalar için PHP uygulamaları belgesine bakın.