6.0.0-git
2024-03-28
Last Modified 2014-12-18 by Guest

Table of Contents

  1. Migration Mechanism
  2. Files

Migration Mechanism

When you take your application to a new revision, you may whish to change your SQL database schema. Tables may be added or removed and columns in a table may be added or removed. For this, horde provides the migration mechanism.

Files

Files under

    
<appname>/migration/

control the migration process. File naming follows the pattern

        
<n>_<appname>_[base|upgrade]_<name>.php

It appears that the [base|upgrade] part in the file name is not relevant and just supposed to indicate whether something is created or modified. Still, the horde applications all seem to make use of it.

Inside the file there is a class defined which must be called

<Appname>[Base|Upgrade]<Name>

Note that the file name is all lowercase and the class name is CamelCase. The class may define an "up" for upgrading an installation and a "down" method for removing the installation, for instance if you which to remove your application from the horde system. For implementation of the methods feel free to steal code from one of the existing horde applications.
Usage

When you use the admin console, horde determines if the revision number of your application matches the highest number of migration files found. If not, the console notifies you ("DB schema needs update") and lets you trigger the migration process with the click of a button. All migration files with numbers between the current revision and the highest number found in a file name will the be considered and the up-methods of those files will be called. The revision number of your application will be set accordingly. Note that this revision number will not necessarily match the version number defined in

<application>/lib/Application.php

Alternatively, you may run the CLI script horde-db-migrate, which should already be in your shell search path. The CLI is especially useful for re-running a migration script as horde will not notice a change in one of the migration files. It also acdcepts a revision number to set.