Portafolio con algunos ejemplos del código que se ha utilizado en el desarrollo de proyectos basados en Yii framework de PHP. Concretamente el código es extraído del desarrollo de una intranet para la administración de estudios de formación personalizados.
El proyecto se creo utilizando la Versión 1.1.8 June 26, 2011 del framework de Yii
El Yii es un framework que: Esta construido siguiendo el patrón del MVC Model, Vista y Controler
Separa en directorios distintos la estructura del framework y la estructura del proyecto, guardados en el directorio yii y en el directorio protected respectivamente. La organización de los directorios del proyecto es configurable, en este caso tenemos que se desarrolló siguiendo la estructura por defecto que sugiere Yii.
En esté portafolio los directorios que están incluidos se utilizaron para los siguientes criterios :
- components contiene componentes que expanden el Yii o clases de soporte
- controllers contiene las clases que realizan las funciones de control
- extensions contiene extensiones de terceros, en el portafolio está un ejemplo de extensión creada ex-proceso para el proyecto
- models contiene los modelos del proyecto.
- test contiene las pruebas unitarias del sistema
En el portafolio encontramos el código implicado en la definición y uso de "behaviors" para los modelos, el código responsable de la relación entre modelos del tipo padre e hijo y un ejemplo de pruebas unitarias.
##Behaviors Yii incorpora la infraestructura para poder definir atributos y métodos para un modelo mediante el añadido de comportamientos a dicho modelo
En este caso se creo un "comportamiento" que va a ser utilizado por todos aquellos modelos en los que se deseaba que quedase registro del nombre del usuario que creó el dato y en que fecha se realizó.
- En protected/extensions/proyecto/EventBehavior.php class EventBehavior vemos la definición del "behavior", para actualizar y validar los atributos de usuario y fecha de creación y dos métodos extras activo y esCreador
- En protected/models/Usuario.php función behaviors se indica que al modelo de usuario se le añade dicho comportamiento.
Así que cuando se produzcan los eventos de guardar o validar de Usuario se ejecutara beforeValidate
y/o el beforeSave, además el modelo Usuario con el EventBehavior incorpora dos métodos mas
(activo y esCreador) que puede llamar como si una función propia suya $usuarioX->activo()
El CArctiveRecord es la clase base para el tratamiento de los Modelos, entonces se ha creado un clase descendiente para tratar los casos de relación entre modelos del tipo de padre e hijo, en donde el hijo solo existe si existe el padre.
- En protected/componets/PHActiveRecord.php se han definido los métodos que sobrescriben el procedimiento normal al momento de validar y guardar los datos para que tengan en cuenta que no se pueda guardar un hijo sin el padre y tampoco que si hay errores en el hijo se actualice el padre. Además se definen un par de nuevos eventos que puedes ser capturados por los modelos implicados llamados beforeActhijos y afterActhijos respectivamente.
- En protected/models/Usuario.php está definido el modelo padre y protected/models/Usuficha.php está el hijo
En protected/tests/unit/fechasTest.php se realizan 3 pruebas sobre el tratamiento de fechas.
- En la primera testPrevio se utiliza para mostrar las características de la función de soporte de Yii CDateTimeParser::parse
- En el segundo testPaso1 se prueba el funcionamiento de la función de ayuda de UtilGIeaem::desglosarPorPeriodos que está en protected/components/UtilGIeaem.php
- En el tercer paso_ testValidator_ se prueba que el modelo Usuficha valide correctamente el contenido del campo de fecha de nacimiento.