İçindekiler
- Giriş
- Magento 2 Veritabanı Şemasını Anlama
- Değişikliğe Hazırlık
- Veritabanı Sütun Türünü Değiştirme
- Yaygın Sorunlar ve Sorun Giderme
- Sonuç
- S.S.S.
Giriş
Magento 2'de veritabanı yapısını değiştirmek, özellikle e-ticaret platformunun işlevselliğini özelleştirirken veya geliştirirken yaygın bir görevdir. Ancak, doğru belgelerin veya net örneklerin bulunmaması durumunda zor olabilir. Magento'nun temel tablolarından birindeki sütun türünü değiştirmeniz gerektiğini düşünün - bu, doğru yönlendirmeler olmadan ürkütücü görünebilir. Doğru yolu takip edin; bu blog yazısı, Magento 2'de veritabanı sütun türünü değiştirmenin adımlarını size adım adım gösterecektir, böylece sorunsuz ve hatasız bir süreç sağlamış olacaksınız.
Bu konunun önemi küçümsenemez - geliştiriciler genellikle veritabanı verimliliğini artırmak, yeni veri türlerine uyum sağlamak vb. gibi çeşitli gereksinimler nedeniyle bu tür değişiklikler yapmak isteyebilirler. Bu kılavuz, işlemi açıklığa kavuşturmayı, size pratik örnekler sunmayı ve işin içindeki ayrıntıları anlamanızı sağlamayı amaçlamaktadır.
Bu blog yazısının sonunda, Magento 2'de veritabanı sütun türlerini güvenli ve etkili bir şekilde nasıl değiştireceğinizi bileceksiniz. Temelleri anlamaktan, ortamınızı hazırlamaktan, komut dosyaları aracılığıyla taşınmaya, değişikliklerinizi doğrulamaya kadar her şeyi kapsayacağız. Haydi başlayalım!
Magento 2 Veritabanı Şemasını Anlama
Gerçek sürece geçmeden önce, Magento 2'nin veritabanı şemasını nasıl ele aldığını anlamak çok önemlidir. Magento 2, veritabanı şemasını tanımlamak ve yönetmek için XML dosyaları kullanır. Bu, Magento 1'in PHP tabanlı kurulum komutlarından ayrı bir yaklaşımdır.
XML Tabanlı Şema
Magento 2, module dizininin etc dizininde yer alan db_schema.xml dosyasını kullanarak veritabanı tablolarını tanımlar ve yönetir. Bu XML tabanlı yaklaşım, kodun ve veritabanının daha iyi sürüm kontrolü ve daha net bir şekilde ayrıştırılması gibi birkaç avantaj sağlar.
Legacy PHP Komut Dosyaları
Magento, eski veya özel modüllerde özellikle hâlâ PHP komut dosyaları bulabileceğiniz durumlar olsa da, şema tanımları için XML'e geçme yöntemi sağlar.
Değişikliğe Hazırlık
Veritabanınızı Yedekleyin
Herhangi bir değişiklik yapmadan önce veritabanınızı yedeklemek çok önemlidir. Bu, bir şeyler ters giderse verilerinizi geri yükleyebilmenizi ve ortamınızın bütünlüğünü korumanızı sağlar.
Geliştirme Ortamı
Değişikliklerinizi her zaman canlıya geçirmeden önce bir geliştirme ortamında uygulayın ve test edin. Bu, beklenmeyen sorunlardan dolayı canlı sitenizin kesintiye uğrama riskini en aza indirir.
Veritabanı Sütun Türünü Değiştirme
catalog_product_entity_varchar tablosundaki value sütun türünü VARCHAR(255)ten VARCHAR(512)'ye nasıl değiştireceğimizi adım adım takip edelim.
Adım 1: Modülünüzü Oluşturun / Bulun
Varsayalım ki zaten bir özel modülünüz varsa, dizinine gidin. Aksi takdirde, yeni bir Company_Base adlı modül oluşturun. Dizin yapınız aşağıdaki gibi görünmelidir:
app
└── code
└── Company
└── Base
├── etc
├── Setup
└── Ui
Adım 2: db_schema.xml'i Düzenleyin
Modülünüzün içindeki etc dizinine gidin ve db_schema.xml dosyasını oluşturun veya güncelleyin. İşte sütun değişikliğini nasıl tanımlayabileceğinizi gösteren örnek:
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Setup/Declaration/Schema/etc/schema.xsd">
<table name="catalog_product_entity_varchar">
<column xsi:type="varchar" name="value" nullable="true" length="512" comment="Product value"/>
</table>
</schema>
Adım 3: module.xml'i Güncelleyin
etc dizininde bulunan module.xml içinde modülünüzün sürümünü artırın:
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
<module name="Company_Base" setup_version="1.0.1">
</module>
</config>
Adım 4: Yükseltme Komutunu Yürütün
Aşağıdaki komutu çalıştırarak değişiklikleri uygulayın:
bin/magento setup:upgrade
Bu komut, db_schema.xml dosyasını işler ve veritabanını buna göre günceller.
Adım 5: Doğrulama
setup:upgrade komutunu çalıştırdıktan sonra, değişikliklerin uygulandığını doğrulamanız gerekmektedir. Bunun için phpMyAdmin gibi bir veritabanı yönetim aracı veya SQL sorguları kullanarak veritabanı tablosunun yapısını kontrol edebilirsiniz:
DESCRIBE catalog_product_entity_varchar;
value sütununun türünün VARCHAR(512) olarak güncellendiğinden emin olun.
Yaygın Sorunlar ve Sorun Giderme
Veritabanı sütunlarını değiştirmek basit bir görev olsa da, bazı sorunlarla karşılaşabilirsiniz. İşte bunlarla nasıl başa çıkacağınız:
Yanlış Sütun Türü
Sütun türü beklediğiniz gibi güncellenmezse, db_schema.xml sözdizimini hatalar için kontrol edin. Küçük hataları düzeltin ve yükseltme komutunu yeniden çalıştırın.
Veri veya Yorum Kaybı
Sütun türlerini değiştirirken, veriler veya sütun yorumları doğru yönetilmezse kaybolabilir. Her zaman değişiklikler yapmadan önce verilerinizi yedekleyin ve db_schema.xml dosyanızın gerekli yorumları ve diğer nitelikleri içerdiğinden emin olun.
Sonuç
Magento 2'de bir veritabanı sütun türünü değiştirmek başlangıçta biraz karmaşık görünebilir, ancak doğru yaklaşımı ve platformun mimarisini anlama ile yönetilebilir bir görev haline gelir. db_schema.xml kullanarak veritabanı yönetimine daha sürdürülebilir ve sürüm kontrolüne daha uygun bir şekilde yaklaştığınızdan emin olursunuz.
Şimdiye kadar, Magento 2'de veritabanı sütunlarını değiştirmek konusunda kendinize güven duymanız gerekmektedir. Değişiklikler yapmadan önce her zaman veritabanınızı yedeklediğinizden ve her şeyi bir geliştirme ortamında test ettiğinizden emin olun.
S.S.S.
db_schema.xml yerine PHP scriptleri kullanabilir miyim?
Mümkün olsa da, Magento 2, daha iyi sürdürülebilirlik ve açıklık için XML tabanlı şema tanımlarına geçtiği için önerilmez.
Sütun türü değişikliği uygulanmazsa ne yapmalıyım?
Hatalar için db_schema.xml sözdizimini kontrol edin. Magento önbelleğini temizlediğinizden ve setup:upgrade komutunu yeniden çalıştırdığınızdan emin olun.
Canlı bir sitede böyle değişiklikler yapmak güvenli midir?
Bu tür değişiklikleri her zaman önce bir geliştirme ortamında yapmak en iyisidir. Her şeyi tam olarak test ettikten sonra, değişiklikleri canlı sitenize uygulayabilirsiniz, mümkünse yoğun saatler dışında, potansiyel kesintileri en aza indirmek için.
Bu adımları benimseyin ve Magento 2 veritabanı şemanızı yönetmek ve değiştirmek çok daha basit ve verimli hale gelecektir!
