# Schema Builder

Una vez creada una migración tenemos que completar sus métodos `up` y `down` para indicar la tabla que queremos crear o el campo que queremos modificar. En el método `down` siempre tendremos que añadir la operación inversa, eliminar la tabla que se ha creado en el método `up` o eliminar la columna que se ha añadido. Esto nos permitirá deshacer migraciones dejando la base de datos en el mismo estado en el que se encontraban antes de que se añadieran.

Para especificar la tabla a crear o modificar, así como las columnas y tipos de datos de las mismas, se utiliza la clase *Schema*. Esta clase tiene una serie de métodos que nos permitirá especificar la estructura de las tablas independientemente del sistema de base de datos que utilicemos.

## Crear y borrar una tabla

Para añadir una nueva tabla a la base de datos se utiliza el siguiente constructor:

```php
Schema::create('users', function (Blueprint $table) {
    $table->increments('id');
});
```

Donde el primer argumento es el nombre de la tabla y el segundo es una función que recibe como parámetro un objeto del tipo *Blueprint* que utilizaremos para configurar las columnas de la tabla.

En la sección `down` de la migración tendremos que eliminar la tabla que hemos creado, para esto usaremos alguno de los siguientes métodos:

```php
Schema::drop('users');

Schema::dropIfExists('users');
```

Al crear una migración con el comando de Artisan `make:migration` ya nos viene este código añadido por defecto, la creación y eliminación de la tabla que se ha indicado y además se añaden un par de columnas por defecto (*id* y *timestamps*).

## Añadir columnas

El constructor `Schema::create` recibe como segundo parámetro una función que nos permite especificar las columnas que va a tener dicha tabla. En esta función podemos ir añadiendo todos los campos que queramos, indicando para cada uno de ellos su tipo y nombre, y además si queremos también podremos indicar una serie de modificadores como valor por defecto, índices, etc. Por ejemplo:

```php
Schema::create('users', function($table)
{
    $table->increments('id');
    $table->string('username', 32);
    $table->string('password');
    $table->smallInteger('votos');
    $table->string('direccion');
    $table->boolean('confirmado')->default(false);
    $table->timestamps();
});
```

*Schema* define muchos tipos de datos que podemos utilizar para definir las columnas de una tabla, algunos de los principales son:

| Comando                                       | Tipo de campo                                        |
| --------------------------------------------- | ---------------------------------------------------- |
| $table->boolean('confirmed');                 | BOOLEAN                                              |
| $table->enum('choices', array('foo', 'bar')); | ENUM                                                 |
| $table->float('amount');                      | FLOAT                                                |
| $table->increments('id');                     | Clave principal tipo INTEGER con Auto-Increment      |
| $table->integer('votes');                     | INTEGER                                              |
| $table->mediumInteger('numbers');             | MEDIUMINT                                            |
| $table->smallInteger('votes');                | SMALLINT                                             |
| $table->tinyInteger('numbers');               | TINYINT                                              |
| $table->string('email');                      | VARCHAR                                              |
| $table->string('name', 100);                  | VARCHAR con la longitud indicada                     |
| $table->text('description');                  | TEXT                                                 |
| $table->timestamp('added\_on');               | TIMESTAMP                                            |
| $table->timestamps();                         | Añade los *timestamps* "created\_at" y "updated\_at" |
| ->nullable()                                  | Indicar que la columna permite valores NULL          |
| ->default($value)                             | Declare a default value for a column                 |
| ->unsigned()                                  | Añade UNSIGNED a las columnas tipo INTEGER           |

Los tres últimos se pueden combinar con el resto de tipos para crear, por ejemplo, una columna que permita nulos, con un valor por defecto y de tipo *unsigned*.

Para consultar todos los tipos de datos que podemos utilizar podéis consultar la documentación de Laravel en:

<http://laravel.com/docs/5.7/migrations#creating-columns>

## Añadir índices

*Schema* soporta los siguientes tipos de índices:

| Comando                                  | Descripción                          |
| ---------------------------------------- | ------------------------------------ |
| $table->primary('id');                   | Añadir una clave primaria            |
| $table->primary(array('first', 'last')); | Definir una clave primaria compuesta |
| $table->unique('email');                 | Definir el campo como UNIQUE         |
| $table->index('state');                  | Añadir un índice a una columna       |

En la tabla se especifica como añadir estos índices después de crear el campo, pero también permite indicar estos índices a la vez que se crea el campo:

```php
$table->string('email')->unique();
```

## Claves ajenas

Con *Schema* también podemos definir claves ajenas entre tablas:

```php
$table->integer('user_id')->unsigned();
$table->foreign('user_id')->references('id')->on('users');
```

En este ejemplo en primer lugar añadimos la columna "`user_id`" de tipo UNSIGNED INTEGER (siempre tendremos que crear primero la columna sobre la que se va a aplicar la clave ajena). A continuación creamos la clave ajena entre la columna "`user_id`" y la columna "`id`" de la tabla "`users`".

> La columna con la clave ajena tiene que ser **del mismo tipo** que la columna a la que apunta. Si por ejemplo creamos una columna a un índice auto-incremental tendremos que especificar que la columna sea *unsigned* para que no se produzcan errores.

También podemos especificar las acciones que se tienen que realizar para "*on delete*" y "*on update*":

```php
$table->foreign('user_id')
      ->references('id')->on('users')
      ->onDelete('cascade');
```

Para eliminar una clave ajena, en el método `down` de la migración tenemos que utilizar el siguiente código:

```php
$table->dropForeign('posts_user_id_foreign');
```

Para indicar la clave ajena a eliminar tenemos que seguir el siguiente patrón para especificar el nombre `<tabla>_<columna>_foreign`. Donde "tabla" es el nombre de la tabla actual y "columna" el nombre de la columna sobre la que se creo la clave ajena.