README

Un sencillo y práctico ORM derivado de la instancia \PDO.

Requisitos

• PDO
• PHP 5.6+

Soporte de las bases de datos

• Postgres 9.5+

Instalación

composer require matajm/php-orm

Establece la conexión de la base de datos

Para establecer la conexión de la base de datos solo usa los siguientes comandos en la cabecera inicial del archivo.

    Database::$dns = 'pgsql:port=[port];host=[host];dbname=[db_name]';
    Database::$username = 'Ingrese su usuario';
    Database::$password = 'Contraseña';

Estas tres lineas representan la configuración inicial del ORM.

Crea tus modelos

Crear un modelo es tan simple como crear una clase.

    use \phpORM\Models;
    use \phpORM\Fields\StringField;
    use \phpORM\Fields\AutoIncrementField;
    use \phpORM\Fields\IntegerField;

    class Animal extends Models {
        protected static $table_name = "animal";
        public $id = [
            "type" => AutoIncrementField::class,
            "db_column" => "animal_id",
            "primary_key" => true
        ];
        public $name = [
            "type" => StringField::class,
            "db_column" => "animal_nombre"
        ];
        public $eyes = [
            "type" => StringField::class,
            "db_column" => "animal_cantidad_ojos",
            "default" => 0
        ];
    }

Heredar modelos

Puedes crear modelos que heredan atributos, funcionabilidad a través de las herencias.

    class Perro extends Animal {
        protected static $table_name = "perro";
        public $eyes = [
            "type" => StringField::class,
            "db_column" => "animal_cantidad_ojos",
            "default" => 2
        ];
    }

Como se observa en el modelo anterior la clase Perro hereda todos los metodos y atributos, cambiando el atributo $eyes su valor por defecto.

Crear la tabla en la base de datos

Para crear las tablas correspodientes puedes realizarlo uno a uno o usando el metodo Database::createTables

    Animal::createTable() # crea la tabla animal
    Database::createTables([
        Animal::class,
        Perro::class
    ]) # crea todas las tablas

Eliminar la tabla en la base de datos

Para eliminar las tablas correspodientes puedes realizarlo uno a uno o usando el metodo Database::dropTable

    Animal::dropTable() # elimina la tabla animal
    Database::dropTables([
        Animal::class,
        Perro::class
    ]) # crea todas las tablas

Crear un objeto

Crear un objeto Serializers no inserta un registro en la base de datos, sino genera un objeto representativo del esquema de la base de datos para persistir los cambios deberá usar el metodo Serializers::save().

    $mascota = Perro::create([
        "name" => "Punky",
    ]);
    $mascota->name
    #Punky
    $mascota->id
    #NULL
    $mascota->save() # Inserta el registro
    $mascota->id
    # 1

El metodo Serializers::save() registra todos los cambios, en caso de no existir el registro lo inserta y en caso de detectarse cambios actualiza el registro.

    $mascota->name = "Bolt";
    $mascota->save();

Eliminar un registro

El metodo Serializers::remove() elimina el objeto de la base de datos.

    $mascota->remove();
    $mascota->save(); # IntegrityError no existe

Buscar registros

Para buscar registros existen tres metodos de acuerdo a las necesidades de busqueda

    Perro::find() # busca todos los registros
    Perro::findOne() #  busca un registro

    Perro::findId(1) #busca el registro que posea la clave id 1