Versi pangkalan data dengan migrasi tangga

mata teras

Ladder adalah alat untuk membuat, menjalankan, dan menguruskan migrasi pangkalan data yang membolehkan pengesanan perubahan dalam skema pangkalan data dengan cara yang sama seperti kod aplikasi. Alat ini boleh diintegrasikan ke dalam rangka kerja utama dan boleh digunakan untuk perubahan dan pengurusan ciri dalam kawalan versi.
Migrasi sentiasa dijalankan secara berturut -turut, dan tangga memastikan ini dengan penomboran migrasi dalam urutan dan menyimpan rekod migrasi yang telah dijalankan dalam pangkalan data itu sendiri, dengan itu menghalang pengulangan migrasi sebelumnya.
tangga juga membolehkan pangkalan data pra-penduduk atau "benih" dibuat, seperti akaun pengguna lalai. Ini boleh dilakukan dengan menggunakan kedai nilai utama Ladder, menyimpan beberapa data untuk rujukan kemudian.
Alat ini menyediakan perintah tambahan untuk mengurus dan memantau pangkalan data, seperti arahan status untuk keadaan pangkalan data, perintah diff dan penyelamat untuk membuang dan memulihkan keadaan pangkalan data, dan perintah versi untuk memeriksa versi tangga yang digunakan.

Sistem kawalan versi tidak ternilai untuk mengesan perubahan dalam kod, terutama ketika bekerja dalam pasukan. Walau bagaimanapun, kebanyakan aplikasi mengandungi lebih daripada sekadar kod aplikasi. Menguruskan perubahan kepada pangkalan data lebih mencabar, terutamanya apabila menambah ciri -ciri baru yang memerlukan corak yang berubah -ubah.

Katakan anda sedang menjalankan modul dan menyedari bahawa jadual pangkalan data memerlukan lajur tambahan. Anda mungkin mahu membuka alat pertanyaan pangkalan data atau baris arahan dan hanya tambahkan lajur itu. Walau bagaimanapun, ini tidak meninggalkan rekod perubahan seperti kod aplikasi yang dikawal versi. Ini boleh diburukkan lagi apabila bekerja dalam satu pasukan - jika rakan sekerja mengekstrak perubahan kod anda tanpa menjalankan kemas kini pangkalan data yang sama, maka versi permohonan mereka kemungkinan besar akan terhempas. Ini menjadi lebih bermasalah apabila anda melepaskan kemas kini produk, kerana ini boleh memecahkan aplikasi bukan hanya untuk rakan sekerja anda, tetapi untuk pengguna anda.

Satu penyelesaian adalah menggunakan penghijrahan untuk memindahkan tanggungjawab untuk membuat dan mengubah suai skema pangkalan data ke dalam kod anda. Dengan cara ini, perubahan boleh diuruskan bersama -sama dengan aplikasi lain, dan kami boleh menggunakan ciri -ciri yang kami terbiasa dengan kawalan versi (seperti dapat membandingkan versi dan menyimpan laluan audit) untuk mengendalikan perubahan pangkalan data. Ia juga membolehkan perubahan ini disepadukan dengan lancar ke dalam versi, kerana ia boleh menjadi sebahagian daripada cawangan atau tag yang sama.

Banyak rangka kerja utama mempunyai pelaksanaan penghijrahan mereka sendiri, tetapi bagi mereka yang tidak - jika anda tidak menggunakan apa -apa - anda boleh menggunakan tangga.

Pengenalan tangga

tangga adalah alat untuk membuat, menjalankan, dan menguruskan migrasi pangkalan data. Migrasi hanya kelas PHP, jadi kawalan versi boleh diperiksa dengan kod aplikasi yang lain.

Anda boleh membuat banyak perubahan pada skema dalam penghijrahan tunggal, walaupun lebih baik untuk mengehadkan penghijrahan ke satu jadual atau ciri.

Migrasi sentiasa dijalankan dengan teratur. Oleh itu, katakan anda menulis penghijrahan untuk membuat jadual produk dan membuat penghijrahan baru beberapa minggu kemudian untuk menambah lajur tambahan kepadanya. Cuba untuk menjalankan bekas sebelum yang terakhir akan menghasilkan kesilapan. Ladder menyelesaikan masalah ini dengan menimpa penghijrahan dalam urutan dan menyimpan rekod (dan masa) migrasi menjalankan dalam pangkalan data itu sendiri.

Pemasangan

tangga boleh dimuat turun dari bitbucket atau melalui komposer. Walau bagaimanapun, ia mengambil beberapa langkah untuk bangun dan berjalan.

Cara paling mudah (walaupun mengakui menjadi kurang elegan) adalah untuk memuat turun atau mengklonkannya dari akar projek dan meletakkannya dalam direktori yang dipanggil Ladder. Masalah dengan menggunakan komposer ialah Kemas Kini Komposer yang menjalankan akan menimpa fail konfigurasi anda.

Terdapat lima fail konfigurasi, yang masing -masing perlu dibuat secara manual;

cp ladder/config/config.php.example ladder/config/config.php
cp ladder/config/database.php.example ladder/config/database.php
cp ladder/config/diff.php.example ladder/config/diff.php
cp ladder/config/editor.php.example ladder/config/editor.php
cp ladder/config/table.php.example ladder/config/table.php

anda hanya perlu mengubah suai database.php (yang mengandungi butiran sambungan pangkalan data) dan editor.php, di mana anda boleh menentukan editor teks pilihan, dan memilih untuk membuka penghijrahan baru secara automatik apabila dibuat.

Buat penghijrahan

mari kita mulakan dengan membuat penghijrahan untuk membuat jadual pengguna.

pada baris arahan:

php ladder/ladder.php create create_users_table

Ini mewujudkan fail bernama tangga/migrasi/00001_create_users_table, yang secara lalai mengandungi struktur asas dengan panggilan contoh yang dikomentari. Jika anda telah menetapkan edit auto ke TRUE dalam tangga/config/editor.php, fail ini akan dibuka dengan segera dalam editor teks yang ditentukan. Anda boleh memanggil migrasi mengikut kehendak, tetapi ia akan membantu dapat melihat apa yang dilakukan oleh penghijrahan dari nama fail sekilas.

inilah yang kelihatan seperti fail (saya memadamkan baris kod yang dikomentari untuk kejelasan):

class Create_Users_Table_Migration_00001 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->create_table('users')
            ->column('email', 'varchar', array('limit' => 128, 'null' => FALSE))
            ->column('password', 'varchar', array('limit' => 32, 'null' => FALSE));
    }

    public function down() {
        $this->table('users')->drop();
    }   
}

panggil kaedah UP () apabila penghijrahan dijalankan, dan kaedah bawah () apabila penghijrahan dilancarkan kembali - jadi ia sentiasa perlu melakukan operasi bertentangan ke kaedah UP (). Dalam contoh ini, kaedah UP () mencipta jadual yang dinamakan pengguna, dan kaedah Down () memadamkannya.

Kaedah

create_table () mengembalikan rujukan kepada jadual baru, manakala kelas meja mempunyai kaedah lajur () untuk menambah lajur baru. Ia mempunyai antara muka yang lancar supaya anda boleh menghubungkannya bersama -sama untuk membuat pelbagai lajur pada masa yang sama. Anda akan melihat bahawa tiada lajur ID - ini dibuat secara automatik - iaitu kunci utama integer auto -incremental yang dinamakan ID.

Jadual () Jadual () Mengembalikan rujukan ke jadual, tetapi ia juga mencipta jadual jika jadual belum wujud - jadi anda boleh menukar panggilan create_table () dengan selamat ke meja ()

mari kita buat penghijrahan lain, kali ini mencipta jadual peranan:

Fail sendiri:

php ladder/ladder.php create create_roles_table

Sekarang anda perlu menjalankan penghijrahan. Untuk melakukan ini:

class Create_Roles_Table_Migration_00002 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('roles')
            ->column('nme', 'varchar', array('limit' => 128, 'null' => FALSE));            
    }

    public function down() {
        $this->table('roles')->drop();
    }   
}

Jika anda melihat pangkalan data, anda akan menemui empat jadual:

php ladder/ladder.php migrate

migrasi dicipta secara automatik untuk mengesan migrasi yang telah dijalankan Migrasi_kvdata juga dicipta untuk anda, dan penghijrahan anda boleh digunakan untuk sebarang penyimpanan nilai utama Pengguna dan peranan adalah jadual yang kami tambah.

Walau bagaimanapun, jika anda memberi perhatian kepada migrasi peranan, anda akan melihat bahawa ia mewujudkan lajur yang dipanggil NME dan bukannya nama. Pada ketika ini, kita boleh membetulkannya dengan "membatalkan" penghijrahan, mengubahsuai kelas, dan menjalankannya lagi. Untuk melancarkan migrasi:

cp ladder/config/config.php.example ladder/config/config.php
cp ladder/config/database.php.example ladder/config/database.php
cp ladder/config/diff.php.example ladder/config/diff.php
cp ladder/config/editor.php.example ladder/config/editor.php
cp ladder/config/table.php.example ladder/config/table.php

Nombor 2 menunjukkan penghijrahan yang akan dilancarkan kembali ke - ia adalah awalan nama fail penghijrahan, tanpa nol terkemuka.

Sekarang anda hanya boleh membuat pembetulan dan menjalankan penghijrahan lagi:

php ladder/ladder.php create create_users_table

Oleh kerana jadual migrasi telah menyimpan rekod kandungan berjalan dan tidak dapat, anda tidak perlu bimbang bahawa penghijrahan pertama anda akan menjadi semula.

Terdapat juga cara yang lebih cepat untuk menggunakan semula:

class Create_Users_Table_Migration_00001 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->create_table('users')
            ->column('email', 'varchar', array('limit' => 128, 'null' => FALSE))
            ->column('password', 'varchar', array('limit' => 32, 'null' => FALSE));
    }

    public function down() {
        $this->table('users')->drop();
    }   
}

Ini akan memanggil kaedah Migrasi Kedua () sekaligus, dan kemudiannya () kaedahnya.

Sekarang katakan selepas beberapa ketika, kami membangunkan ciri baru yang memerlukan jadual pengguna untuk mengandungi medan status. Untuk melakukan ini, kita perlu membuat penghijrahan baru:

php ladder/ladder.php create create_roles_table

penghijrahan akan kelihatan seperti ini:

class Create_Roles_Table_Migration_00002 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('roles')
            ->column('nme', 'varchar', array('limit' => 128, 'null' => FALSE));            
    }

    public function down() {
        $this->table('roles')->drop();
    }   
}

seperti dahulu, lari dengan arahan berikut:

php ladder/ladder.php migrate

Sekarang, jika anda menyemak pangkalan data anda, anda akan melihat bahawa jadual pengguna mempunyai lajur baru.

Pembenihan pangkalan data

Selain menulis migrasi untuk menguruskan skema pangkalan data, anda juga boleh menggunakan tangga untuk pra-populasi (iaitu benih) pangkalan data.

Contohnya, anda boleh melanjutkan penghijrahan create_users_table untuk membuat akaun pengguna root lalai:

Perhatikan bahawa kami menggunakan kaedah set () dan mendapatkan () untuk memanfaatkan kedai nilai utama Ladder, menyimpan ID pengguna supaya kami dapat merujuknya kemudian.

php ladder/ladder.php remove 2

anda juga boleh mengimport data dari fail CSV yang dipindahkan, contohnya:

untuk mengemas kini dan bukan memasukkan data CSV, anda boleh melakukan ini:

php ladder/ladder.php migrate

Dalam kes ini, parameter Hantar bermakna kami ingin menjalankan kemas kini, dan parameter ketiga mengandungi senarai medan utama untuk menentukan rekod yang akan dikemas kini.

php ladder/ladder.php reapply 2

Tambah pangkalan data lain

Anda akan melihat bahawa fail konfigurasi pangkalan data lalai/config/database.php menunjukkan cara menambah sambungan pangkalan data tambahan; Contohnya:

anda boleh menentukan sambungan untuk digunakan seperti ini:

php ladder/ladder.php create add_status_to_users_table

Perintah lain

class Add_Status_To_Users_Table_Migration_00003 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('users')
            ->column('status', 'integer', array('null' => FALSE, 'default' => 0));            
    }

    public function down() {
        $this->table('users')->drop_column('status');      
    }
}

status

anda boleh menggunakan arahan status untuk mendapatkan status pangkalan data:

Output Contoh: (Output contoh ditinggalkan di sini kerana dokumen asal tidak memberikan kandungan output tertentu)

php ladder/ladder.php migrate

diff dan diff-save

(deskripsi perintah diff dan diff menyelamatkan di sini, kerana arahan ini telah diterangkan secara terperinci dalam dokumen asal)

versi

(perihalan arahan versi ditinggalkan di sini, kerana arahan telah diterangkan secara terperinci dalam dokumen asal)

Ringkasan

Artikel ini memperkenalkan tangga, digunakan untuk mengekalkan skema pangkalan data dan data pra-populasi. (Bahagian ringkasan ditinggalkan di sini, kerana dokumen asal telah diringkaskan tangga)

FAQs Mengenai Versi Pangkalan Data dan Migrasi Ladder

(bahagian FAQ ditinggalkan di sini, kerana dokumen asal sudah menyediakan FAQ terperinci)

Atas ialah kandungan terperinci Versi pangkalan data dengan migrasi tangga. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!