State vs Langkah: Declarative Schema Magento 2 vs Laravel

Magento menerangkan pangkalan data yang anda mahukan. Laravel merekodkan cara anda sampai ke sana. Perubahan nama lajur menunjukkan bezanya: dalam Magento, ia boleh membuang lajur itu bersama datanya, dan dry run yang sepatutnya memberi amaran kepada anda pula ada kesan sampingan tersendiri.

Magento: fail ialah keadaan semasa

db_schema.xml menerangkan setiap jadual seperti yang sepatutnya. Anda ubah fail itu, jalankan bin/magento setup:upgrade, dan Magento membandingkan XML dengan skema MySQL aktif lalu menjana arahan ALTER sendiri. Anda tidak dapat sejarah langkah. Anda dapat diff.

Satu lagi fail turut terlibat. db_schema_whitelist.json menyenaraikan lajur, indeks dan kekangan yang boleh dibuang oleh Magento.

Laravel: sejarah ialah keadaan semasa

Migrations ialah langkah-langkah. Setiap fail berjalan sekali, dan satu baris dalam jadual migrations mengingatinya: nama fail dan nombor batch. Skema yang anda miliki ialah hasil daripada langkah-langkah tersebut.

Penamaan semula ialah perangkap Magento

Bayangkan satu jadual 2 lajur dengan 3 SKU, MB01, MB02 dan WJ03, dan tukar nama sku kepada product_sku.

Dalam Magento, lajur yang ditukar namanya dalam XML kelihatan seperti satu lajur hilang dan satu lajur baharu ditambah. Dengan lajur lama dalam whitelist, setup:upgrade menjalankan 1 ALTER dengan 2 bahagian: ADD COLUMN product_sku dan DROP COLUMN sku. Ketiga-tiga baris akhirnya mempunyai product_sku yang kosong.

Penyelesaiannya ialah satu atribut pada lajur baharu:. Dengan atribut itu, upgrade yang sama menyalin ketiga-tiga nilai ke lajur baharu sebelum membuang lajur lama.




/>



Tanpa sku dalam whitelist, Magento mengekalkan lajur lama dan datanya, serta menambah product_sku kosong di sebelahnya. Tiada apa-apa yang hilang, tetapi kini anda mempunyai kedua-duanya.

Magento juga ada jaring keselamatan untuk pembuangan itu sendiri. setup:upgrade –safe-mode=1 akan dump lajur ke fail CSV dalam var/declarative_dumps_csv sebelum membuangnya. Dalam ujian, ketiga-tiga SKU ada dalam fail itu, dan –data-restore=1 mengembalikannya selepas lajur tersebut kembali dalam XML.

Baca SQL dahulu, pada salinan

setup:upgrade –dry-run=1 menulis SQL yang dirancang ke var/log/dry-run-installation.log dan tidak menyentuh jadual. Pembuangan itu memang ada dalam log. Dengan migrateDataFrom, log menunjukkan ADD dan DROP yang sama, dan tiada salinan, jadi baca XML juga.

Tulis =1. Dengan –dry-run sahaja, arahan yang sama menjalankan upgrade sebenar: log kekal kosong dan satu lajur tertangguh ditambah ke jadual.

Namun, dry run ini tidak percuma. Ia tetap flush cache, dan tanpa –keep-generated, ia kosongkan generated/code, generated/metadata, pub/static dan var/view_preprocessed: kod terkompilasi serta fail statik yang sudah di-deploy. Jangan arahkan ia ke laman produksi. Jalankan ia pada salinan staging, dengan flag tersebut.

# planned SQL goes to var/log/dry-run-installation.log
# =1 is required: a bare --dry-run runs the real upgrade
# --keep-generated: without it generated/ and pub/static are emptied
bin/magento setup:upgrade --dry-run=1 --keep-generated

Perangkap Laravel pula berbeza.

Rename Laravel sendiri selamat: migration baru dengan renameColumn() pada Blueprint, dan down() yang menukar nama semula. php artisan migrate –pretend memaparkan SQL tanpa menjalankannya. Pada SQLite, ia ialah alter table “export_logs” rename column “sku” to “product_sku”. Selepas run sebenar, semua 3 SKU masih ada, dan rollback mengembalikan sku.

// new file: the create migration already ran and won't run again
return new class extends Migration
{
public function up(): void
{
Schema::table('export_logs', function (Blueprint $table) {
$table->renameColumn('sku', 'product_sku');
});
}

public function down(): void
{
Schema::table('export_logs', function (Blueprint $table) {
$table->renameColumn('product_sku', 'sku');
});
}
};

Kesilapan yang menggiurkan ialah mengedit migration create lama sebagai gantinya. Pada database baru, seperti yang dibina oleh test anda, file yang diedit akan berjalan dan semuanya lulus. Jika migration itu sudah berjalan, migrate akan menjawab “Nothing to migrate” dan table itu masih menyimpan sku. Ini termasuk juga produksi.

Satu pengecualian di pihak Magento.

Data patches juga merupakan langkah. Setiap satu berjalan sekali, dan Magento mencatatnya dalam patch_list. Install Magento 2.4.9 yang baru dari GitHub repository mempunyai 171 baris di sana: 166 data patches dan 5 schema patches. Jadi, Magento tidak memilih satu model sahaja. Kebanyakan struktur menggunakan state, manakala data menggunakan langkah.

Peraturannya.

Semak kedua-duanya secara berbeza. Pada Magento, baca schema diff dan dry-run SQL pada salinan staging, dan pastikan setiap column yang di-rename mempunyai migrateDataFrom. Pada Laravel, jangan sesekali edit migration yang sudah berjalan, dan baca –pretend sebelum anda deploy.

Seterusnya: mengapa product attributes berada dalam 6 table, EAV bersebelahan dengan JSON column.

Bagaimana team anda mengesan perubahan schema yang memusnahkan sebelum ia di-deploy?

Bahagian 7 daripada 15 dalam siri Magento 2 vs Laravel. Asalnya diterbitkan di LinkedIn.


Sumber Rujukan:

  • Artikel asal: Dev.to PHP
  • Diterjemah daripada artikel asal ke Bahasa Melayu oleh AI Editorial – haqis.com
Comments

Similar Posts