summaryrefslogtreecommitdiff
path: root/doc/es_ES/plugin-schema-migrations.markdown
blob: b71654907945d404f4bec3d1bac3eefa3002ac21 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
Plugin Migración de esquemas
============================

Kanboard realiza migraciones de base de datos automaticamente para ti.
Las migraciones deben ser almacenadas en una carpeta **Schema** y el nombre de archivo debe ser el mismo que el controlador de base de datos:

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

Cada archivo contiene todas las migraciones, aqui un ejemple para Sqlite:

```php
<?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
    )');
}
```

- La constante `VERSION` es la ultima versión de tu esquema
- Cada funcion es una migración `version_1()`, `version_2()`, etc.
- Una instancia `PDO` es pasado como un primer argumneto
- Todo se ejecuta dentro de una transacción , si algo no funciona se realiza una operación de rollback y se muestra el error al usuario

Kanboard siempre compara la version definida en tu esquema y la version almacenada en la base de datos. Si la versiones son diferentes, kanboard siempre ejecuta cada migración una por una hasta alcanzar la ultima version.