Como Crear Relacion 1:N KumbiaPHP Framework

{{#if: |}} {{#if: |}}

Este Artículo esta siendo revisado por los Kumbieros. El ejemplo presente es completamente funcional, pero su redacción debe mejorar

{{{imageright}}}

En este ejemplo se explica como se realizan asociaciones sobre nuestro modelos haciendo uso de las Relaciones de ActiveRecord.

Tenemos dos tablas (especialidades y profesionales) entre las cuales existe una relación de 1:N (1 a muchos), es decir un profesional tiene una especialidad (para efecto del ejemplo) y una especialidad tiene muchos profesionales, la idea de las relaciones en KumbiaPHP es que cuando se realice una búsqueda de profesionales implícitamente este su relación, en este caso seria su especialidad (un objeto) y cuando se realice una búsqueda por especialidad obtener los profesionales (array de objectos) asociados a esta.

Estructura de las Tablas

-- -----------------------------------------------------
-- Table `mydb`.`especialidades`
-- -----------------------------------------------------
CREATE  TABLE IF NOT EXISTS `mydb`.`especialidades` (
  `id` INT NOT NULL ,
  `nombre` VARCHAR(45) NULL ,
  PRIMARY KEY (`id`) )
ENGINE = InnoDB;


-- -----------------------------------------------------
-- Table `mydb`.`profesionales`
-- -----------------------------------------------------
CREATE  TABLE IF NOT EXISTS `mydb`.`profesionales` (
  `id` INT NOT NULL AUTO_INCREMENT ,
  `nombre` VARCHAR(45) NULL ,
  `apellido` VARCHAR(45) NULL ,
  `especialidades_id` INT NOT NULL ,
  PRIMARY KEY (`id`) ,
  INDEX `fk_profesionales_especialidades` (`especialidades_id` ASC) ,
  CONSTRAINT `fk_profesionales_especialidades`
    FOREIGN KEY (`especialidades_id` )
    REFERENCES `mydb`.`especialidades` (`id` )
    ON DELETE NO ACTION
    ON UPDATE NO ACTION)
ENGINE = InnoDB;

Relación entre los Modelos

El Modelo

Con el método belongs_to(), se establece una relación de pertenece a, es decir de una relación 1:1 (Modelo ER) entre el profesional y la especialidad desarrollada por el mismo.

Por otra parte con has_many(), se establece una relación es de tiene muchos, es decir una relación 1:N (Modelo ER), en el caso del ejemplo una especialidad puede tener (engloba) a varios profesionales.

<?php
class Profesionales extends ActiveRecord
{
    public function initialize()
    {
        //Relaciones
        //Un profesional tiene una especialidad
        $this->belongs_to('especialidades');
    }
}

<?php
class Especialidades extends ActiveRecord
{
    public function initialize()
    {
        //Relaciones
        //Un especialidad tiene muchos profesionales
        $this->has_many('profesionales');
    }
}

Ejemplo de Uso

Suponiendo que necesitamos crear una lista de los profesionales guardados en la tabla profesionales con sus respectivas especialidades.

Listar los Profesionales con su Especialidad

[ profesionales_controller.php ]

Tenemos que definir en el controlador el arreglo (variable $profesionales) que devuelve la operación en la base de datos.

<?php

Load::models('profesionales');

class ProfesionalesController extends AppController {
    public function listar() 
    {
    	$profesional = new Profesionales();
    	$this->profesionales = $profesional -> find(); //Obtenemos todos los profesionales
    	
    }
}
?>

Obteniendo las Relación de Profesionales

Para obtener la relación de un profesional obviamente hay que recorrer el array que devolvió el método find() pero internamente en cada objeto está la relación porque así fue definida, Un Profesional tiene una Especialidad.

Vista [ listar.phtml ]

<?php View::content()?>
<br><br>
<div align="center">
<h5>Lista de Profesionales</h5><br>
<table border="1">
<tr style="background-color: #c0c0c0;">
   <td>Profesional</td>
   <td>Especialidad</td>
</tr>
<?php foreach ($profesionales as $profesional) :?>
<tr>
  <td><?php echo $profesional->apellido . ", " . $profesional->nombre ?></td>
  <td><?php echo $profesional->getEspecialidades()->nombre ?></td>
</tr>  
<?php endforeach;?>
</table>
</div><br><br>

¿Pero como se obtienen los datos de la Especialidad?

Pongamos nuestra atención en esta linea:

<td><?php echo $profesional->getEspecialidades()->nombre ?></td>

De esta forma KumbiaPHP nos hace la conexión entre las dos tablas, solo tenemos que especificar getNombreDelModelo()->campo;

Si por ejemplo tuviéramos una relación adicional entre una tabla Facultades y la tabla Especialidades, podríamos obtener la facultad de cada profesional mediante:

<td><?php echo $profesional->getEspecialidades()->getFacultad()->nombreFacultad; ?></td>

Screenshot de la Vista

Obteniendo las Relación de Especialidades

Para obtener la relación de las Especialidades, se debe obtener la lista de especialidades y luego, por cada una de las especialidades, agrupar los profesionales que tienen esa especialidad.

[ profesionales_controller.php ]

Se deben realizar las siguientes modificaciones al controlador.

<?php

Load::models('especialidades');

class ProfesionalesController extends AppController {
    public function listar() 
    {
    	$especialidad = new Especialidades();
    	$this->especialidades = $especialidad -> find(); //Obtenemos todas las especialidades
    	
    }
}
?>

En la Vista correspondiente

<?php View::content()?>
<div align="center">
<h5>Lista de Profesionales por Especialidad</h5><br>
<table border="1">
<?php foreach ($especialidades as $especialidad) :?>
 <tr><td colspan="2">Especialidad : <h5><?php echo $especialidad->nombre ?></h5><br></td></tr>
<tr style="background-color: #c0c0c0;">
   <td>Profesional</td>
   <td>Telefono</td>
</tr>
<tr>
  <?php foreach ($especialidad->getProfesionales() as $profesional) : ?>
  <td><?php echo $profesional->apellido .", ".$profesional->nombre  ?></td>
  <td><?php echo $profesional->telefono1 ?></td>
</tr>  
<?php  endforeach; ?>
<?php endforeach;?>
</table>
</div>

Screenshot de la vista

Realizado Por: Adrián Murúa (adolphm) Modificado Por: Juan Felipe (JF)