Kanboard Documentation

Plugin Schema Migrations

Kanboard executes database migrations automatically for you. Migrations must be stored in a folder Schema and the filename must be the same as the database driver:

Schema
├── Mysql.php
├── Postgres.php
└── Sqlite.php

Each file contains all migrations, here an example for Sqlite:

<?php

namespace Kanboard\Plugin\Something\Schema;

const VERSION = 1;

function version_1($pdo)
{
    $pdo->exec('CREATE TABLE IF NOT EXISTS something (
        "id" INTEGER PRIMARY KEY,
        "project_id" INTEGER NOT NULL,
        "something" TEXT,
        FOREIGN KEY(project_id) REFERENCES projects(id) ON DELETE CASCADE
    )');
}
  • The constant VERSION is the last version of your schema
  • Each function is a migration version_1(), version_2(), etc.
  • A PDO instance is passed as first argument
  • Everything is executed inside a transaction, if something doesn’t work a rollback is performed and the error is displayed to the user

Kanboard will compare the version defined in your schema and the version stored in the database. If the versions are different, Kanboard will execute one by one each migration until to reach the last version.