İçindekiler
- Giriş
- Kurulumu Anlama
- Magento 2.4.6-P6 Kurulumunda Sık Karşılaşılan Hatalar
- Detaylı Hata Giderme ve Çözümler
- Sonuç
Giriş
Magento 2.4.6-p6'yı yerel sunucunuza kurdunuz ve sadece düzgün biçimlendirilmemiş bir anasayfa ve sürekli yüklenen bir yönetici sayfasıyla karşılaştınız mı? Yalnız değilsiniz. Bu gibi hatalar sinir bozucudur, özellikle sitenizi faaliyete geçirmek için sabırsızlandığınızda. Bu blog yazısı, bu sorunların temel nedenlerini tespit etmeye derinlemesine iner ve kapsamlı çözümler sunar. Bu yazının sonunda, bu sorunların neden olduğunu ve nasıl düzeltileceğini öğrenecek, yerel sunucunuzda sorunsuz bir Magento kurulumu sağlayacaksınız.
Kurulumu Anlama
Hataları ve çözümleri detaylı olarak ele almadan önce, yerel sunucuda temel bir Magento kurulumunu kısaca anlamak için:
- Sunucu: Genellikle Apache veya Nginx.
- Veritabanı: MySQL veya MariaDB.
- PHP: Magento'nun gereksinimlerine uygun uygun PHP sürümü.
- Dosya Sistemi: Magento'nun çekirdek dosyalarını, temalarını ve özelleştirmelerini içerir.
Bu bileşenleri iyi anlamak sorun gidermeye daha etkili bir şekilde yardımcı olacaktır.
Magento 2.4.6-P6 Kurulumunda Sık Karşılaşılan Hatalar
Hata 404: Eksik Sabit Kaynaklar
Günlükler, requirejs, requirejs-config ve styles.css gibi önemli sabit kaynaklar için '404 Bulunamadı' hatalarının birden fazla görüntülemesini gösterir. Bu dosyaların eksik olması, Magento sitenizin doğru şekilde görüntülenmesini önleyebilir.
Muhtemel Nedenler
- Yanlış İzinler: Magento'nun, sabit kaynakları okumak ve yüklemek için doğru dosya izinlerine ihtiyacı vardır.
- Yanlış Dosya Oluşturma: Sabit dosyaların kurulum sürecinde doğru şekilde oluşturulmamış olabileceği.
- Önbellek Sorunları: Tarayıcı veya Magento önbelleği eski olabilir.
-
Yapılandırma Sorunları: Magento'nun yapılandırma dosyalarında yanlış ayarlar, örneğin
nginx.confveya.htaccessolabilir.
Yönetici Sayfası Sürekli Yükleniyor
Günlükler ayrıca yönetici sayfasını yüklemek için tekrarlayan girişimleri gösterir, ancak başarısız olur. Bu genellikle arka uç işlemle ilgili sorunları veya kaynak yüklemeyle ilgili sorunları işaret eder.
Muhtemel Nedenler
- JavaScript Hataları: Kritik JavaScript dosyaları yüklenmiyor olabilir, bu da yönetici arayüzünün doğru şekilde çalışmamasına neden olur.
- Sunucunun Zaman Aşımına Uğraması: Sunucunun yönetici kaynaklarını yüklemeye çalışırken zaman aşımı yapması olabilir.
- Bozulmuş Önbellek: Magento'nun önbelleği bozulmuş olabilir, bu da normal işlemlerin yapılamamasına neden olur.
-
PHP Yapılandırması:
max_execution_timeveyamemory_limitgibi PHP ayarları yetersiz olabilir.
Detaylı Hata Giderme ve Çözümler
Adım 1: Dosya İzinlerini Kontrol Edin ve Ayarlayın
İlk olarak, Magento'nun dosyalara okuma ve yazma yetkisi olması gerektiğinden emin olun:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
find var/ pub/static/ pub/media/ app/etc/ -type f -exec chmod 644 {} \;
find var/ pub/static/ pub/media/ app/etc -type d -exec chmod 775 {} \;
chmod u+x bin/magento
Adım 2: Sabit İçeriği Dağıt
İzinler doğruysa ancak hatalar devam ediyorsa, sabit içeriği yeniden dağıtın:
bin/magento setup:static-content:deploy -f
bin/magento cache:clean
bin/magento cache:flush
Bu komut, tüm ön uç ve yönetici arayüzü sabit dosyalarının doğru şekilde oluşturulup yüklendiğini sağlar.
Adım 3: PHP ve Sunucu Yapılandırmasını Kontrol Edin
Sunucu ve PHP yapılandırmalarınızı Magento'nun gereksinimlerini karşıladığından emin olmak için gözden geçirin. Bu PHP ayarlarına özellikle dikkat edin:
-
memory_limiten az 2GB olmalıdır. -
max_execution_time(300 saniye veya daha fazla olarak ayarlanmış) yeterince yüksek olmalıdır.
Adım 4: Önbelleği Temizleyin ve Veri Yeniden Dizinleyin
Magento'nun önbelleğini temizleyin ve veri yapılarını yeniden dizinleyin:
bin/magento cache:clean
bin/magento cache:flush
bin/magento indexer:reindex
Adım 5: Veritabanını Doğrulayın ve Onarın
Bazı durumlarda, veritabanı sorunlara neden olabilir:
- Magento veritabanınızı phpMyAdmin gibi bir araçla açın.
- Tabloları optimize edin ve bozuk olanları onarın.
Adım 6: Daha Fazla Tanı için Günlükleri İnceleyin
Hemen görünmeyebilecek hatalar için hem Magento hem de sunucu günlüklerini kontrol edin:
- Magento günlükleri:
var/log/system.logvevar/log/exception.log - Apache için sunucu günlükleri (
error.log) veya Nginx için (error.log)
Adım 7: Geliştirici Modunu Etkinleştirin
Daha ayrıntılı hata mesajları almak için Geliştirici Moduna geçin:
bin/magento deploy:mode:set developer
Geliştirici Modunda, Magento, kök nedeni belirlemeye yardımcı olabilecek daha ayrıntılı hata mesajları sağlar.
Adım 8: Gereksiz Modülleri Devre Dışı Bırakın
Bazı modüller normal işlemlere müdahale edebilir. Tüm gereksiz olmayan modülleri devre dışı bırakın ve sorunu belirlemek için tek tek yeniden etkinleştirin:
bin/magento module:disable <Module_Name>
bin/magento cache:clean
Sonuç
Yerel sunucuda taze bir Magento 2.4.6-p6 kurulumunu anlama ve sorun giderme zorlayıcı olabilir, ancak yönetilebilir. Dosya izinlerini doğru şekilde ayarlama, sabit içeriği yeniden dağıtma, sunucu ayarlarını optimize etme ve önbelleği temizleme gibi adımları takip ederek yaygın hataları düzeltebilir ve Magento sitenizin sorunsuz çalışmasını sağlayabilirsiniz.
SSS
Neden birçok sabit kaynak için 404 hataları görüyorum?
Bu genellikle eksik sabit dosyaları veya yanlış dosya izinlerini gösterir. Doğru izinleri sağlama ve sabit içeriği yeniden dağıtma bu sorunları çözebilir.
Neden yönetici sayfası sürekli yükleniyor?
Olası nedenler arasında JavaScript hataları, sunucu zaman aşımı veya bozulmuş önbellek bulunur. Sunucu günlüklerini kontrol etmek ve PHP ayarlarını yeniden yapılandırmak yardımcı olabilir.
Yanlış PHP ayarları Magento performansını etkileyebilir mi?
Evet, yetersiz bellek sınırları ve yürütme süreleri Magento'nun düzgün çalışmasını engelleyebilir. PHP ayarlarınızın Magento'nun gereksinimlerine uygun olduğundan emin olun.
Magento sorun giderme korkutucu görünebilir, ancak sistemli bir yaklaşımla sorunları tespit edebilir ve etkili bir şekilde çözebilirsiniz. Günlüklerinizi kullanışlı tutun, en iyi uygulamaları takip edin ve keyifli kodlamalar dilerim!