Magento 2’yi Nasıl Yükseltirsiniz: Güvenli Adım Adım Yükseltme Kılavuzu

Magento 2’yi güncel tutmak çok önemlidir. Her sürüm güvenlik düzeltmeleri getirir ve eski sürümler sonunda yamanın alınmasını durdurur. Yine de birçok mağaza, son güncellemenin kötü geçtiği için yükseltmeleri ertelemektedir.

Çoğu başarısız yükseltme, Magento’nun kendisinden değil, yetersiz hazırlıktan kaynaklanır. Bu kılavuz, güvenli ve tekrarlanabilir bir süreci göstermektedir.

Neden yükseltme yapmalıyız?

• Güvenlik: eski sürümler güvenlik yamanları almaya son verir. Yamanlanmamış bir mağaza, kart kopyalayıcıları ve saldırılar için bir hedefdir.
• Uyumluluk: yeni PHP, MySQL/MariaDB, OpenSearch ve diğer hizmet sürümleri daha yeni Magento sürümlerini gerektirir.
• Performans ve hata düzeltmeleri
• Uzantı desteği: satıcılar zamanla eski sürümler için desteği bırakır.

Yükseltme türleri

Yazın	Örnek	Risk
Güvenlik yaması	İzole bir güvenlik yaması uygulamak	Düşük
Yaman sürüm	2.4.x-p1’den 2.4.x-p2’ye	Düşük ile orta
Küçük/özellik sürümü	2.4.x’tan 2.4.y’ye	Orta ile yüksek
Altyapı değişikliği	Yeni PHP veya veritabanı sürümü Magento ile birlikte	Yüksek

Adobe’nin sürüm notlarını ve yaşam döngüsü politikasını kontrol edin, hangi sürümlerin desteklendiğini ve ne zamana kadar destekleneceğini öğrenin.

Adım 1: Sistem gereksinimlerini kontrol et

Her Magento sürümü, aşağıdaki belirli sürümleri destekler:

• PHP
• MySQL veya MariaDB
• OpenSearch (veya eski sürümler için Elasticsearch)
• Redis, Varnish, RabbitMQ
• Besteci

Hedef sürümünüzün gereksinimlerini sunucunuzla karşılaştırın. Altyapıyı yükseltmek genellikle projenin bir parçasıdır.

Adım 2: Uzantıları ve özelleştirmeleri denetleyin

Bu, çoğu sorunun kaynağıdır.

1. Tüm modülleri listele:

bin/magento module:status
composer show | grep -v magento/

1. Her bir üçüncü taraf eklentisi için, satıcının hedef sürümünüzü destekleyip desteklemediğini kontrol edin.
2. Özelleştirilmiş modülleri, kullanımdan kaldırılmış kod, kaldırılan sınıflar ve değiştirilen arayüzler için gözden geçirin.
3. Tema geçersiz kılmalarını kontrol edin: çekirdekten kopyalanan şablonların güncellenmesi gerekebilir.
4. Kullanmadığınız eklentileri kaldırın

Adım 3: Bir sahneleme ortamı hazırlayın

Üretimi önce asla güncellemeyin. Staging’iniz üretimle eşleşmelidir:

• hedef kurulum ile aynı PHP ve hizmet sürümleri
• Son bir üretim veritabanı kopyası (anonimleştirilmiş)
• Aynı yapılandırma ve uzantılar

Adım 4: Her şeyi yedekle

• Veritabanı yedeği
• Kod (Git deposu)
• app/etc/env.php ve app/etc/config.php
• Medya dosyaları

Ve bunları nasıl geri yükleyeceğinizi bildiğinizden emin olun. Geri alma planı, yükseltmenin bir parçasıdır.

Adım 5: Yükseltmeyi sahnede çalıştırın

Bakım modunu etkinleştir:

bin/magento maintenance:enable

Magento sürüm gereksinimini Composer ile güncelleyin (Magento Open Source örneği):

composer require-commerce magento/product-community-edition 2.4.x-pX --no-update
composer update

require-commerce komutu, Magento’nun Composer kök güncelleme eklentisinden gelir ve diğer kök bağımlılıklarını da günceller. Alternatif olarak, composer.json dosyasını manuel olarak güncelleyebilir ve composer update komutunu çalıştırabilirsiniz.

Sonra:

rm -rf generated/code/* var/cache/* var/page_cache/* var/view_preprocessed/*
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento indexer:reindex
bin/magento cache:flush
bin/magento maintenance:disable

2.4.x-pX ile hedef sürümünüzü değiştirin. Daha fazla komut için, benim Magento 2 komutları kılavuzuma bakın.

Adım 6: Hataları düzeltin

Yaygın sorunlar:

• Composer çatışmaları: bir eklenti, bir bağımlılığın daha eski bir sürümünü gerektiriyor. Eklentiyi güncelleyin veya değiştirin.
• Derleme hataları: özel kod, kaldırılan sınıfları veya değiştirilen yöntem imzalarını kullanıyor.
• Veritabanı şeması hataları: bir modülün deklaratif şeması yeni sürümle çelişiyor.
• Frontend sorunları: temanıza ait güncel olmayan şablon geçersiz kılmaları.

Adım 7: Kapsamlı test yapın

En az:

• Ana sayfa, kategori, ürün, arama sayfaları
• Sepete ekle, sepet, her ödeme ve gönderim yöntemi ile ödeme yapın
• Müşteri kaydı, giriş, hesap sayfaları
• Admin: siparişler, faturalar, kredi notları, ürün kaydetmeleri, ithalatlar
• E-postalar (sipariş onayı, şifre sıfırlama)
• Entegrasyonlar: ERP, PIM, veri akışları, analiz, izleme
• Cron işleri ve indeksleyiciler
• Önceki ile karşılaştırıldığında performans

Otomatik testler, tekrarlanan güncellemeler için çok yardımcı olur.

Adım 8: Üretime dağıtım yapın

• Satış veya tatil öncesi olmayan sakin bir an seçin.
• Normal dağıtım hattınızı kullanın, sunucuda manuel değişiklikler yapmayın.
• Yayın sonrası hata ve dönüşüm oranını izleyin (var/log/exception.log, var/log/system.log).

Geri alma planı

Bir şey ciddi şekilde yanlış giderse:

1. Bakım modunu etkinleştir
2. Önceki kod sürümünü geri yükleyin
3. Veritabanı yedeğini geri yükleyin (not: yedekten sonra verilen siparişler dikkate alınmalıdır)
4. Önbellekleri temizle ve bakımı devre dışı bırak.

Yükseltme ile geri alma arasında verilen siparişler ana riski oluşturur, bu nedenle süreyi kısa tutun ve önceden iyi test edin.

Ne sıklıkla güncelleme yapmalısınız?

Güvenlik yamalarını yayınlandıktan hemen sonra uygulamayı planlayın ve daha büyük sürüm yükseltmelerini yılda en az bir kez gerçekleştirin. Küçük, düzenli yükseltmeler, birkaç yılda bir yapılan büyük bir sıçramadan çok daha kolaydır.

Sıkça sorulan sorular

Magento yükseltmesi ne kadar sürer?

Temiz bir mağazada bir yamanın yükseltilmesi saatler alabilir. Birçok eklenti ve altyapı değişikliği ile birlikte bir sürüm yükseltmesi testler dahil olmak üzere haftalar alabilir.

Sürümleri atlayabilir miyim?

Evet, doğrudan hedef sürüme yükseltebilirsiniz, ancak aradaki her sürümün sürüm notlarını kırıcı değişiklikler için gözden geçirin.

Hyvä’ya aynı anda geçmem gerekiyor mu?

Hayır. Mümkünse güncellemeleri ve ön yüz projelerini ayrı tutun, riski azaltmak için. Hazır olduğunuzda, benim Luma’dan Hyvä’ya geçiş kılavuzuma bakın.

Güvenli bir Magento yükseltmesine mi ihtiyacınız var?

Magento 2 ve Adobe Commerce yükseltmelerini, uzantı denetimlerini, altyapı güncellemelerini ve testlerini planlıyor ve gerçekleştiriyorum. Magento 2 ve Hyvä hizmetimi veya bir yükseltme planı talep edin kısmına bakın.