Akrabat_Db_Schema_Manager: Миграция базы данных в Zend Framework

Часто возникает необходимость в миграции базы данных Zend Framework проекта, где используется Zend_Db_Adapter.

Миграция файлов

По сути после того, как осуществляется изменение в базе данных (добавление колонок, таблиц, индексов и т.д.), нужно создавать отдельный файл миграции. Подобные файлы можно размещать в каталоге /scripts/migrations и именовать как 001-CreateUsersTable.php. Номер определяет порядок, в котором данные файлы будут запускаться.

Файл миграции наследуется от Akrabat_Db_Schema_AbstractChange и должен содержать два метода: up() и down(). Метод up() запускает процесс изменения базы данных, а down() используется в том случае, если во время этого процесса возникли какие-то ошибки.

001-CreateUsersTable.php:

class CreateUsersTable extends Akrabat_Db_Schema_AbstractChange 
{
    function up()
    {
        $sql = "CREATE TABLE IF NOT EXISTS users (
                  id int(11) NOT NULL AUTO_INCREMENT,
                  username varchar(50) NOT NULL,
                  password varchar(75) NOT NULL,
                  roles varchar(200) NOT NULL DEFAULT 'user',
                  PRIMARY KEY (id)
                )";
        $this->_db->query($sql);
    
        $data = array();
        $data['username'] = 'admin';
        $data['password'] = sha1('password');
        $data['roles'] = 'user,admin';
        $this->_db->insert('users', $data);
        
    }
    
    function down()
    {
        $sql = "DROP TABLE IF EXISTS users";
        $this->_db->query($sql);
    }
}

Как вы уже поняли, этот код создаёт новую таблицу и вставляет в неё запись. Метод down() содержит код, который просто удалит созданную таблицу, если что-то пойдёт не так.

Фишка в том, что нам необходимо хранить версию сборки базы данных в самой базе. Этого можно достичь используя таблицу calledschema_version, состоящую из одной колонки, которая будет хранить версию.

Akrabat_Db_Schema_Manager создаст эту таблицу, если её не существует.

Akrabat_Db_Schema_Manager

Этот класс сделает для вас всё, что нужно. Он действует на основе кода, который вы можете найти тут. В этом классе (Akrabat_Db_Schema_Manager) есть два публичных метода :

  • getCurrentSchemaVersion()
  • updateTo($version)<

Для того, чтобы класс работал нормально, то для него нужно выделить отдельный каталог, в котором будут храниться миграционные файлы и адаптер базы данных. Функциональность методы To() тоже очень проста:

  1. Находит и создаёт список (порядок) миграционных файлов;
  2. Проходится по всем файлов, используя мнтоды up() и down();
  3. Обновляет версию в базе данных;

Для того чтобы получить текущую версию состояния базы данных следует использовать метод getCurrentSchemaVersion().

Командная строка

Для того, чтобы запустить сам процесс обновления, мы можем воспользоваться инструментом Zend_Tool. Это значит, что нам нужен провайдер, Akrabat_Tool_DatabaseSchemaProvider. Данный провайдер расширит возможности Zend_Tool. Для каждого метода, который мы собираемся запустить создадим отдельную публичную функцию:

  • updateTo($version, $env='development', $dir='./scripts/migrations')
  • update($env='development', $dir='./scripts/migrations')
  • current($env='development', $dir='./scripts/migrations')

Метод update() это простой алиас метода updateTo(), которое отвечает за то, чтобы последняя сборка базы данных была обновлена.

Использование:

$ zf current database-schema
Current schema version is 0

$ zf update database-schema
Schema updated to version 2

$ zf current database-schema
Current schema version is 2

Также вы сможете вернуться к любой другой версии следующим образом:

$ zf current database-schema
Current schema version is 2

$ zf update-to database-schema 1
Schema updated to version 1

$ zf current database-schema
Current schema version is 1

Вот шаги, которые вам нужно пройти для настройки адаптера:

  1. В командной строке пишите zf --setup storage-directory;
  2. После этого будет создана папка с конфигурацией Zend_Tool;
  3. Запустите zf --setup config-file;
  4. В последствии будет создан файл zf.ini;
  5. Отредактируйте файл zf.ini и php.include_path и добавьте путь Akrabat/library. В моём случае пути выглядили так:
  6. php.include_path = "/usr/local/include/zend-framework/library:/usr/local/include/Akrabat/library/"
  7. В конце концов нам необходимо предпринять действия для того, чтобы Zend_Tool могла использовать новый адаптер. Для этого, вставьте в zf.ini следующую строчку:
  8. basicloader.classes.0 = "Akrabat_Tool_DatabaseSchemaProvider"

Если вы сделали всё правильно, то в последствии получите подобный результат:

Вот теперь всё путём. Всё что вам осталось сделать это создать каталог script/migrations, куда необходимо расположить скрипт миграции!

Источник: http://feedproxy.google.com/~r/ruseller/CdHX/~3/xgwljqXL1as/lessons.php

Читать комменты и комментировать

Добавить комментарий / отзыв



Защитный код
Обновить

Akrabat_Db_Schema_Manager: Миграция базы данных в Zend Framework | | 2012-06-19 12:07:48 | | Статьи Web-мастеру | | Часто возникает необходимость в миграции базы данных Zend Framework проекта, где используется Zend_Db_Adapter.Миграция файловПо сути после того, как осуществляется изменение в базе данных (добавление | РэдЛайн, создание сайта, заказать сайт, разработка сайтов, реклама в Интернете, продвижение, маркетинговые исследования, дизайн студия, веб дизайн, раскрутка сайта, создать сайт компании, сделать сайт, создание сайтов, изготовление сайта, обслуживание сайтов, изготовление сайтов, заказать интернет сайт, создать сайт, изготовить сайт, разработка сайта, web студия, создание веб сайта, поддержка сайта, сайт на заказ, сопровождение сайта, дизайн сайта, сайт под ключ, заказ сайта, реклама сайта, хостинг, регистрация доменов, хабаровск, краснодар, москва, комсомольск |
 
Поделиться с друзьями: