Cara Menguruskan Migrasi Pangkalan Data dalam PHP

Cara Mengurus Migrasi Pangkalan Data dalam PHP

Penghijrahan pangkalan data ialah bahagian penting dalam pembangunan aplikasi, kerana ia membenarkan pembangun mengawal versi dan mengurus perubahan pada skema pangkalan data dengan cara yang konsisten dan berstruktur. Dalam PHP, mengurus migrasi pangkalan data boleh dilakukan secara manual, tetapi menggunakan alat migrasi yang mengautomasikan proses adalah lebih cekap dan kurang ralat. Alat migrasi menyediakan cara tersusun untuk mengendalikan perubahan skema, memastikan pangkalan data disegerakkan dengan kod aplikasi.

Dalam artikel ini, kami akan meneroka cara mengurus migrasi pangkalan data dalam PHP, termasuk penggunaan perpustakaan popular, amalan terbaik dan contoh praktikal.

---

1. Apakah Migrasi Pangkalan Data?

Penghijrahan pangkalan data ialah cara membuat versi perubahan pada skema pangkalan data (cth., mencipta, mengemas kini atau memadamkan jadual dan lajur) dan menggunakan perubahan tersebut dengan cara terkawal. Penghijrahan membenarkan pasukan untuk:

• Jejaki Perubahan: Migrasi menyediakan sejarah versi perubahan skema, membolehkan pasukan menjejak perubahan yang dibuat dan bila.
• Automasikan Kemas Kini Skema: Migrasi boleh dijalankan secara automatik atau dengan satu arahan, memastikan skema pangkalan data dikemas kini dalam semua persekitaran (pembangunan, pementasan, pengeluaran) dengan cara yang konsisten.
• Kembalikan Perubahan: Jika berlaku masalah dengan penghijrahan, ia boleh ditarik balik, memberikan keselamatan dan fleksibiliti semasa pembangunan dan penggunaan.

---

2. Mengapa Penghijrahan Penting?

• Ketekalan: Mereka memastikan semua orang dalam pasukan pembangunan menggunakan skema pangkalan data yang sama.
• Automasi: Migrasi boleh dijalankan secara automatik, mengurangkan ralat manual semasa kemas kini.
• Versi: Migrasi memudahkan untuk menjejaki evolusi skema pangkalan data anda dari semasa ke semasa.
• Kemudahan Penggunaan: Migrasi membantu semasa penggunaan, menjadikannya mudah untuk mengatur dan menyegerakkan perubahan skema merentas persekitaran yang berbeza (tempatan, pementasan, pengeluaran).

---

3. Cara Mengurus Migrasi dalam PHP

Terdapat beberapa cara untuk mengendalikan migrasi pangkalan data dalam PHP, tetapi pendekatan yang paling biasa ialah menggunakan pustaka migrasi. Begini cara melakukannya menggunakan perpustakaan PHP yang popular seperti Phinx dan Migrasi Doktrin.

---

4. Menggunakan Phinx untuk Migrasi Pangkalan Data

Phinx ialah alat migrasi PHP yang popular yang membolehkan anda membuat dan menjalankan migrasi pangkalan data. Ia menyokong berbilang platform pangkalan data seperti MySQL, PostgreSQL, SQLite dan lain-lain.

Langkah 1: Pasang Phinx melalui Komposer

Untuk memasang Phinx, anda boleh menggunakan Komposer untuk menambahkannya sebagai pergantungan.

composer require robmorgan/phinx

Langkah 2: Fail Konfigurasi

Phinx memerlukan fail konfigurasi (phinx.php atau phinx.yml) untuk mengurus tetapan sambungan dan pilihan konfigurasi lain. Berikut ialah contoh konfigurasi dalam phinx.php:

<?php
return [
    'paths' => [
        'migrations' => 'db/migrations',
        'seeds' => 'db/seeds'
    ],
    'environments' => [
        'default' => 'development',
        'development' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'your_database_name',
            'user' => 'root',
            'pass' => '',
            'charset' => 'utf8',
        ],
        'production' => [
            'adapter' => 'mysql',
            'host' => 'production_host',
            'name' => 'your_production_database',
            'user' => 'prod_user',
            'pass' => 'prod_password',
            'charset' => 'utf8',
        ]
    ]
];

Konfigurasi ini menyediakan dua persekitaran (pembangunan dan pengeluaran), di mana Phinx akan menguruskan migrasi untuk pangkalan data anda.

Langkah 3: Mencipta Migrasi

Untuk membuat migrasi, anda boleh menggunakan arahan Phinx berikut:

php vendor/bin/phinx create CreateUsersTable

Arahan ini mencipta fail migrasi dalam direktori db/migrasi. Fail migrasi akan kelihatan seperti ini:

<?php

use Phinx\Migration\AbstractMigration;

class CreateUsersTable extends AbstractMigration
{
    public function change()
    {
        $table = $this->table('users');
        $table->addColumn('name', 'string')
              ->addColumn('email', 'string')
              ->create();
    }
}

Penghijrahan ini mencipta jadual pengguna dengan dua lajur: nama dan e-mel.

Langkah 4: Menjalankan Migrasi

Setelah migrasi dibuat, anda boleh menggunakan migrasi ke pangkalan data menggunakan arahan berikut:

php vendor/bin/phinx migrate

Phinx akan menggunakan sebarang migrasi baharu yang belum dijalankan. Anda juga boleh menentukan persekitaran tertentu:

php vendor/bin/phinx migrate -e production

Langkah 5: Mengundur Migrasi

Jika anda perlu membuat asal penghijrahan (contohnya, apabila anda ingin mengembalikan perubahan), Phinx menyediakan arahan berikut:

php vendor/bin/phinx rollback

Anda juga boleh kembali ke versi atau langkah tertentu, jika perlu:

php vendor/bin/phinx rollback -t 20210101000000

Arahan ini melancarkan semula penghijrahan ke versi yang ditentukan.

---

5. Menggunakan Migrasi Doktrin untuk Migrasi Pangkalan Data

Doctrine Migration ialah satu lagi alat popular untuk migrasi pangkalan data, terutamanya untuk projek yang sudah menggunakan Doctrine ORM untuk interaksi pangkalan data. Ia menyepadukan terus dengan Doktrin dan menyediakan satu set perintah untuk menguruskan migrasi.

Langkah 1: Pasang Doktrin Migrasi

composer require doctrine/migrations

Langkah 2: Konfigurasikan Migrasi Doktrin

Anda perlu menyediakan fail konfigurasi (migrations.php) untuk menentukan sambungan pangkalan data dan laluan migrasi.

Contoh konfigurasi migrasi.php:

<?php
use Doctrine\DBAL\DriverManager;
use Doctrine\Migrations\Configuration\Configuration;
use Doctrine\Migrations\Tools\Console\Command;
use Doctrine\Migrations\Tools\Console\ConsoleRunner;

// Set up the database connection
$conn = DriverManager::getConnection([
    'url' => 'mysql://root:@localhost/your_database_name',
]);

// Set up the migrations configuration
$config = new Configuration($conn);
$config->setMigrationsNamespace('App\Migrations');
$config->setMigrationsDirectory('db/migrations');

// Create the migration tool
$console = ConsoleRunner::createApplication($config);
$console->run();

Langkah 3: Mencipta Migrasi

Anda boleh menjana migrasi menggunakan Doktrin CLI:

php vendor/bin/doctrine-migrations generate

Ini mencipta fail migrasi dalam direktori db/migration.

Langkah 4: Menjalankan Migrasi

Untuk menjalankan migrasi, gunakan:

php vendor/bin/doctrine-migrations migrate

Arahan ini akan menggunakan semua migrasi yang belum selesai pada pangkalan data.

Langkah 5: Mengundur Migrasi

Untuk melancarkan semula penghijrahan, gunakan:

composer require robmorgan/phinx

Anda boleh menentukan versi penghijrahan yang hendak digunakan semula, jika perlu.

---

6. Amalan Terbaik untuk Mengurus Migrasi dalam PHP

• Kawalan Versi: Sentiasa serahkan fail migrasi anda kepada kawalan versi (cth., Git). Ini memastikan pasukan anda boleh menjejak dan menggunakan perubahan pangkalan data yang sama.
• Elakkan Perubahan Manual: Elakkan membuat perubahan manual terus dalam pangkalan data. Gunakan migrasi untuk membuat perubahan skema, supaya ia menjadi versi dan boleh dijejaki.
• Nama Penghijrahan Deskriptif: Namakan fail migrasi dalam cara deskriptif supaya anda boleh memahami dengan mudah perkara yang dilakukan oleh setiap migrasi (cth., AddIndexToUsersTable atau CreateProductsTable).
• Uji Migrasi: Sentiasa uji migrasi anda pada pangkalan data pementasan atau pembangunan sebelum menggunakannya pada pengeluaran untuk mengelakkan kemungkinan isu.
• Pastikan Penghijrahan Kecil dan Bertambah: Elakkan migrasi besar dan monolitik. Sebaliknya, buat perubahan tambahan, kerana ini memudahkan untuk nyahpepijat dan memahami.

---

7. Kesimpulan

Menguruskan migrasi pangkalan data adalah bahagian penting dalam mana-mana proses pembangunan aplikasi PHP. Menggunakan alatan migrasi seperti Phinx atau Doctrine Migration menyediakan cara berstruktur dan automatik untuk mengurus perubahan skema pangkalan data. Alat ini membantu anda mengelakkan ralat manual, mengekalkan konsistensi merentas persekitaran dan memastikan bahawa skema pangkalan data anda berkembang dalam cara terkawal dan versi.

Dengan menggunakan alatan ini, anda boleh menumpukan pada membina logik aplikasi, sambil memastikan pangkalan data anda sentiasa disegerakkan dengan perubahan dalam kod anda.

---

Atas ialah kandungan terperinci Cara Menguruskan Migrasi Pangkalan Data dalam PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!