Edición de «KumbiaPHP Framework Versión 1.0 Spirit»
De KumbiaPHP Framework Wiki
Advertencia: no has iniciado sesión. Tu dirección IP se hará pública si haces cualquier edición. Si inicias sesión o creas una cuenta, tus ediciones se atribuirán a tu nombre de usuario, además de otros beneficios.
Puedes deshacer la edición. Antes de deshacer la edición, comprueba la siguiente comparación para verificar que realmente es lo que quieres hacer, y entonces guarda los cambios para así efectuar la reversión.
Revisión actual | Tu texto | ||
Línea 1: | Línea 1: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Introducción == | == Introducción == | ||
En la [https://launchpad.net/kumbia/1.0 versión 1.0](<s>antigua 0.5.1</s>) el enfoque primordial que ha considerado el [[Team_Development_KumbiaPHP_Framework|Equipo de Desarrollo]] gira en torno al rendimiento del framework a nivel de velocidad y mantenibilidad del framework en este sentido hemos desacoplado el core de kumbiaphp framework en una nueva estructura obteniendo grandes resultados, de manera que las pruebas en base a esta versión nos indica que vamos en buen camino y ademas es bastante rápida con los cambios aplicados siempre con las mejores practicas de desarrollo. | En la [https://launchpad.net/kumbia/1.0 versión 1.0](<s>antigua 0.5.1</s>) el enfoque primordial que ha considerado el [[Team_Development_KumbiaPHP_Framework|Equipo de Desarrollo]] gira en torno al rendimiento del framework a nivel de velocidad y mantenibilidad del framework en este sentido hemos desacoplado el core de kumbiaphp framework en una nueva estructura obteniendo grandes resultados, de manera que las pruebas en base a esta versión nos indica que vamos en buen camino y ademas es bastante rápida con los cambios aplicados siempre con las mejores practicas de desarrollo. | ||
Línea 24: | Línea 18: | ||
Como se menciona al principio muchos de estos cambios son a nivel de '''core''', esto significa que haremos pocas adecuaciones para migrar nuestras aplicaciones que hayan sido desarrolladas con la [https://launchpad.net/kumbia/0.5 versión 0.5] para llevarlas hasta la [https://launchpad.net/kumbia/1.0 versión 1.0](<s>antigua 0.5.1</s>), esto con la finalidad de garantizar compatibilidad entre versiones. | Como se menciona al principio muchos de estos cambios son a nivel de '''core''', esto significa que haremos pocas adecuaciones para migrar nuestras aplicaciones que hayan sido desarrolladas con la [https://launchpad.net/kumbia/0.5 versión 0.5] para llevarlas hasta la [https://launchpad.net/kumbia/1.0 versión 1.0](<s>antigua 0.5.1</s>), esto con la finalidad de garantizar compatibilidad entre versiones. | ||
===¿Por qué Spirit?=== | ===¿Por qué Spirit?=== | ||
− | "Hemos llamado Spirit a la versión 1.0 porque Spirit, [http://es.wikipedia.org/wiki/Spirit nuestro robot de Marte], tiene como características principales, fuerza y velocidad. Fuerza, porque su comunidad cada vez mas grande hace que nuestro framework KumbiaPHP avance a pasos agigantados. Velocidad, porque nuestro core team que pertenece a otro planeta, continuamente esta aplicando las ultimas técnicas y haciendo que otros | + | "Hemos llamado Spirit a la versión 1.0 porque Spirit, [http://es.wikipedia.org/wiki/Spirit nuestro robot de Marte], tiene como características principales, fuerza y velocidad. Fuerza, porque su comunidad cada vez mas grande hace que nuestro framework KumbiaPHP avance a pasos agigantados. Velocidad, porque nuestro core team que pertenece a otro planeta, continuamente esta aplicando las ultimas técnicas y haciendo que otros frameworks se queden atrás día a día. En definitiva Spirit, hace que tus aplicaciones vuelen, resulten mas atractivas y fáciles de mantener." |
== Migración Rápida == | == Migración Rápida == | ||
− | En esta sección se explica de forma rápida y sencilla como migrar nuestras aplicaciones de la | + | En esta sección se explica de forma rápida y sencilla como migrar nuestras aplicaciones de la versión [https://launchpad.net/kumbia/0.5 0.5] a la [https://launchpad.net/kumbia/0.5.1 versión 1.0](<s>antigua 0.5.1</s>) en las próximas secciones se explican en detalle los cambios. |
− | + | *Si has modificado el archivo '''views/index.phtml''' este fue ubicado en el directorio '''views/templates/default.phtml''', es decir que lo debes sobreescribir o aplicar los cambios que quieras. | |
− | + | *Para inicializar tu aplicación es mejor utilizar el archivo '''config/routes.ini''' agregando una regla de enrutamiento estático, por ejemplo. | |
− | + | ;con esta regla cada vez que inicie la aplicación http://localhost/kumbia/ irá hacia un controlador admin y una acción autenticar | |
− | + | / = admin/autenticar | |
− | + | Esto sustituye editar el archivo '''apps/default/controllers/application.php''' en su acción '''init()''', solo se ha de agregar en el '''routes.ini''' la ruta que hacemos en el método '''init()''' | |
− | *Si has modificado el archivo '''views/index.phtml''' este fue ubicado en el directorio '''views/templates/default.phtml''', es decir que | ||
− | |||
− | |||
− | |||
− | *Para inicializar tu aplicación | ||
− | ;con esta regla cada vez que inicie la aplicación http://localhost/kumbia/ irá hacia un controlador | ||
− | admin y una acción autenticar / = admin/autenticar | ||
− | |||
− | Esto sustituye editar el archivo ''' | ||
− | |||
*Si en tus modelos utilizas el atributo '''$mode''' para establecer otros datos de conexión, debes reemplazarlo por '''$database''', [[KumbiaPHP_Framework_Versión_1.0_Spirit#databases.ini| ver mas]]. | *Si en tus modelos utilizas el atributo '''$mode''' para establecer otros datos de conexión, debes reemplazarlo por '''$database''', [[KumbiaPHP_Framework_Versión_1.0_Spirit#databases.ini| ver mas]]. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Nueva Estructura de Directorios == | == Nueva Estructura de Directorios == | ||
− | + | Ahora Kumbia incorpora la siguiente estructura de directorios, a continuación se detallan los elementos mas relevantes: | |
<pre> | <pre> | ||
− | + | . | |
|-- app | |-- app | ||
| |-- application.php | | |-- application.php | ||
| |-- config | | |-- config | ||
+ | | | |-- boot.ini | ||
+ | | | |-- config.ini | ||
+ | | | |-- databases.ini | ||
+ | | | `-- routes.ini | ||
| |-- controllers | | |-- controllers | ||
− | + | | |-- helpers | |
− | |||
− | |||
− | |||
| |-- index.php | | |-- index.php | ||
− | |||
− | |||
| |-- model_base.php | | |-- model_base.php | ||
| |-- models | | |-- models | ||
| |-- public | | |-- public | ||
| |-- temp | | |-- temp | ||
+ | | | |-- cache | ||
+ | | | `-- logs | ||
| `-- views | | `-- views | ||
| |-- errors | | |-- errors | ||
Línea 131: | Línea 56: | ||
| `-- templates | | `-- templates | ||
|-- core | |-- core | ||
− | + | |-- console | |
− | + | |-- docs | |
− | | |-- | + | | |-- LICENSE.txt |
− | | | + | | `-- README |
− | | | + | |-- extensions |
− | + | |-- helpers | |
− | + | |-- kumbia | |
− | + | |-- scaffolds | |
− | + | |-- tests | |
− | + | |-- vendors | |
− | + | `-- views | |
− | |||
− | |||
</pre> | </pre> | ||
− | Anteriormente | + | Anteriormente kumbia utilizaba un fichero index.php el cual servía para enrutar a cada aplicación utilizando inversión de control, esto erá poco flexible y resultaba en un consumo inadecuado de recursos, por lo tanto en esta nueva versión se preparó una nueva estructura de directorios donde cada aplicación posee un directorio independiente con su index.php (Front controller) correspondiente el cual se encarga de cargar las librerias del framework. |
− | Copiando el directorio | + | Copiando el directorio app, tenemos toda la estructura para un nueva aplicación. Ya que podemos tener tantas aplicaciones como necesitemos con un único core. |
− | Asimismo el | + | Asimismo el nucleo, las extensiones de kumbia y otras herramientas que utilizarán las aplicaciones de manera global fueron agrupadas en el directorio core. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== config.ini == | == config.ini == | ||
− | Se agregan opciones para un manejo mas apropiado de la configuración del framework | + | Se agregan opciones para un manejo mas apropiado de la configuración del framework. |
+ | *'''databases''' cuando se necesite trabajar con el framework pero sin interactuar con una Base de Datos. | ||
+ | *'''models_autoload''' Auto carga de modelos, util para cuando se manejan muchos modelos no tener la necesidad de cargarlos todos en un momento, sino que se cargan se de acuerdo lo que se necesiten en el controller, todo esto se traduce en mejor rendimiento, [[KumbiaPHP_Framework_Versi%C3%B3n_1.0_Spirit#Carga_selectiva_de_modelos| leer mas]] | ||
*'''metadata_lifetime''' Tiempo de vida de la metadata cacheada. | *'''metadata_lifetime''' Tiempo de vida de la metadata cacheada. | ||
*'''database''' Base de datos a utilizar, especificada en databases.ini. | *'''database''' Base de datos a utilizar, especificada en databases.ini. | ||
*'''production''' Indica si se encuentra en producción. | *'''production''' Indica si se encuentra en producción. | ||
− | |||
− | |||
− | |||
− | <pre>;; | + | <pre> |
+ | ;; Configuración de Aplicación | ||
; Explicación de la Configuración: | ; Explicación de la Configuración: | ||
− | + | ; production: Indica si esta en producción | |
+ | ; database: base de datos a utilizar | ||
; name: Es el nombre de la aplicación | ; name: Es el nombre de la aplicación | ||
; timezone: Es la zona horaria que usará el framework | ; timezone: Es la zona horaria que usará el framework | ||
− | ; | + | ; interactive: Indica si la aplicación se encuentra en modo interactivo |
− | |||
; dbdate: Formato de Fecha por defecto de la Applicación | ; dbdate: Formato de Fecha por defecto de la Applicación | ||
− | |||
− | |||
; charset: codificacion de caracteres | ; charset: codificacion de caracteres | ||
− | ; | + | ; models_autoload: Habilita la autocarga de modelos |
; metadata_lifetime: Tiempo de vida de la metadata cacheada | ; metadata_lifetime: Tiempo de vida de la metadata cacheada | ||
− | ; locale: | + | ; locale: Localicazion |
− | |||
Línea 270: | Línea 104: | ||
; el contenido del directorio de cache de la aplicacion para que se renueve | ; el contenido del directorio de cache de la aplicacion para que se renueve | ||
; la metadata | ; la metadata | ||
+ | |||
[application] | [application] | ||
name = "KUMBIA PROJECT" | name = "KUMBIA PROJECT" | ||
− | + | timezone = "America/New_York" | |
production = Off | production = Off | ||
database = development | database = development | ||
Línea 280: | Línea 115: | ||
log_exceptions = On | log_exceptions = On | ||
charset = UTF-8 | charset = UTF-8 | ||
− | + | models_autoload = On | |
;metadata_lifetime = "+1 year" | ;metadata_lifetime = "+1 year" | ||
;locale = es_ES | ;locale = es_ES | ||
− | |||
</pre> | </pre> | ||
Línea 293: | Línea 127: | ||
Lo mismo sucede para los modelos, el atributo <s>$mode</s> fue reemplazado por '''$database''' | Lo mismo sucede para los modelos, el atributo <s>$mode</s> fue reemplazado por '''$database''' | ||
− | <source lang=php> | + | <source lang=php line> |
class Usuarios extends ActiveRecord | class Usuarios extends ActiveRecord | ||
{ | { | ||
Línea 311: | Línea 145: | ||
host = localhost | host = localhost | ||
username = root | username = root | ||
− | password = | + | password = |
− | name = | + | name = innogest |
type = mysql | type = mysql | ||
Línea 318: | Línea 152: | ||
host = localhost | host = localhost | ||
username = root | username = root | ||
− | password = | + | password = |
name = test | name = test | ||
− | type = | + | type = mysql |
[test] | [test] | ||
host = localhost | host = localhost | ||
username = root | username = root | ||
− | password = | + | password = |
name = test | name = test | ||
− | type = | + | type = mysql |
</pre> | </pre> | ||
== boot.ini == | == boot.ini == | ||
− | En este archivo | + | En este archivo es donde el usuario carga las extensiones (librerías) que trae el framework o bien alguna que deseen agregar. |
− | + | En este archivo se agregan dos atributos '''kumbia''' y '''extensions''' para que la lectura del mismo sea mas rápida. | |
+ | |||
+ | Extensiones Propias de Kumbiaphp Framework | ||
+ | *logger | ||
+ | *auth | ||
+ | *date | ||
+ | *standard_form | ||
+ | *filter | ||
+ | *acl | ||
+ | *benchmark | ||
+ | *security | ||
+ | |||
+ | Extensiones externas al framework | ||
+ | *excel | ||
+ | *fpdf | ||
+ | *mail | ||
+ | *smarty | ||
+ | |||
+ | <pre> | ||
+ | ; Cargar los modulos de Kumbia en library/ | ||
+ | ; CONVENCIONES | ||
+ | ; La convención para la carga de extensiones (librerías) por medio | ||
+ | ; de este archivo es la siguiente: | ||
+ | ; kumbia = logger indica que en el directorio library/kumbia/logger | ||
+ | ; y a su vez este tiene un archivo logger.php kumbia incluira library/kumbia/logger/logger.php | ||
+ | ; lo mismo sucede para las extensiones externas al core del framework, solo que estas no estan | ||
+ | ; kumbia, sino en la variable extensions | ||
+ | |||
+ | ; kumbia: Modulos del framework que se cargaran library/kumbia | ||
+ | ; extensions: Modulos a cargar library/ | ||
+ | |||
+ | [modules] | ||
+ | kumbia = logger, filter | ||
+ | extensions = | ||
+ | </pre> | ||
== Router == | == Router == | ||
Línea 356: | Línea 224: | ||
Los [http://en.wikipedia.org/wiki/Template_(file_format) Template] son un tipo de archivo pre-formateado utilizado como base para otros archivos. | Los [http://en.wikipedia.org/wiki/Template_(file_format) Template] son un tipo de archivo pre-formateado utilizado como base para otros archivos. | ||
− | En este directorio esta la capa mas externa de nuestras vistas, para aclarar esta idea en esta es donde se coloca la estructura del documento XHTML (doctype, html, head, etc) en la forma como se trabaja en la | + | En este directorio esta la capa mas externa de nuestras vistas, para aclarar esta idea en esta es donde se coloca la estructura del documento XHTML (doctype, html, head, etc) en la forma como se trabaja en la '''versión 0.5''' esto es representado por el archivo '''views/index.phtml''' de esta forma no existe una flexibilidad de manera que podamos cambiar ese template, en la [https://launchpad.net/kumbia/0.5.1 versión 1.0](<s>antigua 0.5.1</s>) se crea un directorio '''views/templates/''' por defecto existe el archivo '''default.phtml''' pero podemos podemos agregar cuantos se desee y poderlo cambiar desde nuestro controlador de la siguiente forma: |
− | + | ||
− | |||
class PruebaController extends ApplicationController | class PruebaController extends ApplicationController | ||
{ | { | ||
public $template = 'plantilla'; | public $template = 'plantilla'; | ||
} | } | ||
− | |||
− | |||
− | |||
− | + | El atributo '''$template''' existe en la super clase '''Controller''' y tiene un valor por defecto (default) esto significa que el sistema de plantillas del framework buscara dentro de directorio views/templates/ el valor que le demos, por defecto buscara '''default.phtml''' pero en otro caso que veamos conveniente podría ser otro template tal como se muestra en el ejemplo seria '''plantilla.phtml''' | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ''' | ||
=== views/partials/ === | === views/partials/ === | ||
Línea 385: | Línea 240: | ||
'''views/partials/fecha.phtml''' | '''views/partials/fecha.phtml''' | ||
− | <source lang=php > | + | <source lang=php line> |
<div style='background: #333eee; padding: 15px 10px 15px 10px; text-align: center'> | <div style='background: #333eee; padding: 15px 10px 15px 10px; text-align: center'> | ||
<i><?php echo date('Y-m-d'); ?></i> | <i><?php echo date('Y-m-d'); ?></i> | ||
Línea 391: | Línea 246: | ||
</source> | </source> | ||
− | Como se aprecia este partials solo mostrará la fecha actual cuando sea invocado, pero como se menciono antes puede contener cualquier información para el usuario, pero aun falta hacer un llamado a este partials para que el mismo sea mostrado este llamado puede ser desde cualquier nivel del sistema de plantilla que ofrece el framework | + | Como se aprecia este partials solo mostrará la fecha actual cuando sea invocado, pero como se menciono antes puede contener cualquier información para el usuario, pero aun falta hacer un llamado a este partials para que el mismo sea mostrado este llamado puede ser desde cualquier nivel del sistema de plantilla que ofrece el framework y basta con hacer en la vista (Templates, views) lo siguiente. |
− | <source lang=php > | + | <source lang=php line> |
− | <?php | + | <?php render_partial('fecha') ?> |
</source> | </source> | ||
'''Describiendo la función de manera mas detallada:''' | '''Describiendo la función de manera mas detallada:''' | ||
− | <source lang=php > | + | <source lang=php line> |
− | + | render_partial($partial, $time=false, $params=array()) | |
</source> | </source> | ||
Para cachear los partials, el tiempo de cacheo debe indicarse con el formato de strtotime tal como lo utiliza el componente cache. | Para cachear los partials, el tiempo de cacheo debe indicarse con el formato de strtotime tal como lo utiliza el componente cache. | ||
− | <source lang=php > | + | <source lang=php line> |
− | <?php | + | <?php render_partial('fecha', '+4 days') ?> |
</source> | </source> | ||
Si no se desea cachear, se indica como segundo argumento "false", el cual es el valor por defecto | Si no se desea cachear, se indica como segundo argumento "false", el cual es el valor por defecto | ||
− | <source lang=php > | + | <source lang=php line> |
− | <?php | + | <?php render_partial('fecha', false) ?> |
</source> | </source> | ||
− | También es posible pasar variables al partial utilizando parámetros con nombre o utilizando como argumento un array. Si estos parámetros se pasan en forma de array soporta cualquier tipo de dato (objecto, array, etc). | + | También es posible pasar variables al partial utilizando parámetros con nombre o utilizando como argumento un array. Si estos parámetros son se pasan en forma de array soporta cualquier tipo de dato (objecto, array, etc). |
− | <source lang=php > | + | <source lang=php line> |
− | <?php | + | <?php render_partial('fecha', false, 'var: valor') ?> |
</source> | </source> | ||
− | <source lang=php > | + | <source lang=php line> |
− | <?php | + | <?php render_partial('fecha', false, array('var' => 'valor')) ?> |
</source> | </source> | ||
Línea 430: | Línea 285: | ||
Los modelos ya no se cargan directamente en los partials, esto mejora la velocidad, para hacer uso de los modelos en los partials, el usuario puede instanciar directamente el modelo, la desventaja de esta manera es que el usuario debe haber cargado previamente el modelo haciendo uso de "load_models" en el controller en caso de utilizar carga selectiva de modelos: | Los modelos ya no se cargan directamente en los partials, esto mejora la velocidad, para hacer uso de los modelos en los partials, el usuario puede instanciar directamente el modelo, la desventaja de esta manera es que el usuario debe haber cargado previamente el modelo haciendo uso de "load_models" en el controller en caso de utilizar carga selectiva de modelos: | ||
− | <source lang=php > | + | <source lang=php line> |
<?php | <?php | ||
$Usuario = new Usuario(); | $Usuario = new Usuario(); | ||
Línea 439: | Línea 294: | ||
También es posible utilizar el método '''Load::models($model)''', el cual se encarga de cargar la clase de ser necesario, este método solo debe usarse para obtener un modelo para efectuar consultas de recuperación de datos (find, findBy, find_first, etc) preferiblemente. | También es posible utilizar el método '''Load::models($model)''', el cual se encarga de cargar la clase de ser necesario, este método solo debe usarse para obtener un modelo para efectuar consultas de recuperación de datos (find, findBy, find_first, etc) preferiblemente. | ||
− | <source lang=php > | + | <source lang=php line> |
<?php | <?php | ||
Load::models('usuario'); | Load::models('usuario'); | ||
Línea 445: | Línea 300: | ||
$result = $usuario->find(1); | $result = $usuario->find(1); | ||
?> | ?> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</source> | </source> | ||
Línea 699: | Línea 335: | ||
==Cache== | ==Cache== | ||
− | El componente cache fué mejorado y ahora posee una implementación | + | El componente cache fué mejorado y ahora posee una implementación estática, para hacer uso de la cache es necesario tener permisos de escritura en el directorio "cache". Los métodos de la clase Cache son los siguientes: |
− | + | ===Cache::get($id, $group='default')=== | |
− | |||
− | ===Cache:: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
Obtiene los datos cacheados. Los elementos cacheados pueden agruparse en grupos, lo cual permite evitar colisiones entre elementos cacheados con igual $id. | Obtiene los datos cacheados. Los elementos cacheados pueden agruparse en grupos, lo cual permite evitar colisiones entre elementos cacheados con igual $id. | ||
Línea 728: | Línea 343: | ||
string '''$group''': grupo al cual pertenece el elemento cacheado (por defecto "default") | string '''$group''': grupo al cual pertenece el elemento cacheado (por defecto "default") | ||
− | < | + | <pre> |
− | $data = Cache:: | + | $data = Cache::get('data'); |
− | </ | + | </pre> |
− | ===save($value, $lifetime=null, $id=false, $group='default')=== | + | ===Cache::save($value, $lifetime=null, $id=false, $group='default')=== |
Guarda los datos a cachear. | Guarda los datos a cachear. | ||
mixed '''$value''': valor a cachear (automaticamente es serializado antes de guardar)<br> | mixed '''$value''': valor a cachear (automaticamente es serializado antes de guardar)<br> | ||
− | string '''$lifetime''': tiempo de vida de los datos (formato de [http:// | + | string '''$lifetime''': tiempo de vida de los datos (formato de [http://fr.php.net/manual/es/function.strtotime.php strtotime]), si es null, los datos no expiran nunca.<br> |
string '''$id''': identificador del elemento a almacenar, si no se especifica, se toma el id y grupo del ultimo get efectuado<br> | string '''$id''': identificador del elemento a almacenar, si no se especifica, se toma el id y grupo del ultimo get efectuado<br> | ||
string '''$group''': grupo al cual pertenece | string '''$group''': grupo al cual pertenece | ||
− | < | + | <pre> |
− | <?php if($data = Cache:: | + | <?php if($data = Cache::get('data')): ?> |
<?php echo $data ?> | <?php echo $data ?> | ||
<?php else: ?> | <?php else: ?> | ||
Línea 748: | Línea 363: | ||
<?php | <?php | ||
$data = ob_get_contents(); | $data = ob_get_contents(); | ||
− | Cache:: | + | Cache::save($data, '+21 days'); |
ob_end_flush(); | ob_end_flush(); | ||
?> | ?> | ||
<?php endif; ?> | <?php endif; ?> | ||
− | </ | + | </pre> |
+ | <pre> | ||
+ | Cache::save('hola', null, 'data'); | ||
+ | $data = Cache::get('hola'); | ||
+ | </pre> | ||
− | + | Nota: el grupo "kumbia.*" esta reservado para el uso exclusivo de Kumbia. | |
− | |||
− | |||
− | |||
− | |||
− | Nota: el grupo "kumbia.*" esta reservado para el uso exclusivo de | ||
− | ===start($lifetime, $id, $group='default')=== | + | ===Cache::start($lifetime, $id, $group='default')=== |
− | Cachea capturando el buffer de salida, se debe utilizar en conjunto a "end()" para terminar la captura, si el elemento esta cacheado entonces lo retorna. | + | Cachea capturando el buffer de salida, se debe utilizar en conjunto a "Cache::end()" para terminar la captura, si el elemento esta cacheado entonces lo retorna. |
string '''$lifetime''': tiempo de vida de los datos (formato de strtotime), si es null, los datos no expiran nunca.<br> | string '''$lifetime''': tiempo de vida de los datos (formato de strtotime), si es null, los datos no expiran nunca.<br> | ||
Línea 769: | Línea 383: | ||
string '''$group''': grupo al cual pertenece | string '''$group''': grupo al cual pertenece | ||
− | < | + | <pre> |
− | <?php if($data = Cache:: | + | <?php if($data = Cache::start('+1 day','data')): ?> |
<?php echo $data ?> | <?php echo $data ?> | ||
<?php else: ?> | <?php else: ?> | ||
Hola | Hola | ||
− | <?php Cache:: | + | <?php Cache::end()?> |
<?php endif; ?> | <?php endif; ?> | ||
− | </ | + | </pre> |
− | ===end()=== | + | ===Cache::end()=== |
Guarda los datos en la cache tomados del buffer de salida. | Guarda los datos en la cache tomados del buffer de salida. | ||
− | ===clean($group=false)=== | + | ===Cache::clean($group=false)=== |
Limpia la cache. Si no se indica grupo limpia toda la cache. | Limpia la cache. Si no se indica grupo limpia toda la cache. | ||
− | < | + | <pre> |
− | Cache:: | + | Cache::clean('default'); |
− | </ | + | </pre> |
− | ===remove($id, $group='default')=== | + | ===Cache::remove($id, $group='default')=== |
Elimina un elemento específico de la cache | Elimina un elemento específico de la cache | ||
− | < | + | <pre> |
− | Cache:: | + | Cache::remove('data'); |
− | </ | + | </pre> |
+ | |||
+ | ===Cache::active($active)=== | ||
+ | Activa el uso de la cache | ||
+ | |||
+ | <pre> | ||
+ | Cache::active(true); | ||
+ | </pre> | ||
==Cacheo automático de views y templates== | ==Cacheo automático de views y templates== | ||
Línea 817: | Línea 438: | ||
Ahora se ha definido una forma concreta para el paso de parámetros en los validadores y asimismo se adicionaron parámetros para personalizar los mensajes de error. | Ahora se ha definido una forma concreta para el paso de parámetros en los validadores y asimismo se adicionaron parámetros para personalizar los mensajes de error. | ||
− | < | + | <pre> |
class Model extends ActiveRecord | class Model extends ActiveRecord | ||
{ | { | ||
Línea 826: | Línea 447: | ||
} | } | ||
} | } | ||
− | </ | + | </pre> |
NOTA: El método '''initialize''' hace las veces de constructor y se ejecuta siempre por eso nuestros validadores deberían estar alli... | NOTA: El método '''initialize''' hace las veces de constructor y se ejecuta siempre por eso nuestros validadores deberían estar alli... | ||
Línea 838: | Línea 459: | ||
Parametros con nombre:<br> | Parametros con nombre:<br> | ||
message: mensaje a mostrar<br> | message: mensaje a mostrar<br> | ||
− | field: nombre del campo | + | field: nombre del campo |
− | + | <pre> | |
− | |||
− | < | ||
− | |||
$this->validates_uniqueness_of('cedula', 'message: La cedula ya existe') | $this->validates_uniqueness_of('cedula', 'message: La cedula ya existe') | ||
$this->validates_uniqueness_of('cedula', array('message'=>'La cedula ya existe')) | $this->validates_uniqueness_of('cedula', array('message'=>'La cedula ya existe')) | ||
− | + | </pre> | |
− | </ | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===validates_date_in($field, $params=array())=== | ===validates_date_in($field, $params=array())=== | ||
Línea 868: | Línea 476: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_date_in('fecha', 'message: Fecha invalida') | $this->validates_date_in('fecha', 'message: Fecha invalida') | ||
$this->validates_date_in('fecha', array('message'=>'Fecha invalida')) | $this->validates_date_in('fecha', array('message'=>'Fecha invalida')) | ||
− | + | </pre> | |
− | </ | ||
Línea 886: | Línea 492: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_presence_of('fecha_opt', 'field: Fecha') | $this->validates_presence_of('fecha_opt', 'field: Fecha') | ||
− | + | </pre> | |
− | </ | ||
===validates_length_of($field, $max, $min=0, $params=array())=== | ===validates_length_of($field, $max, $min=0, $params=array())=== | ||
− | Valida | + | Valida que el campo no sea nulo |
string '''$field''': campo a validar<br> | string '''$field''': campo a validar<br> | ||
Línea 906: | Línea 510: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_length_of('nombre', '25') | $this->validates_length_of('nombre', '25') | ||
$this->validates_length_of('nombre', '25', 0,'too_long: Nombre muy largo') | $this->validates_length_of('nombre', '25', 0,'too_long: Nombre muy largo') | ||
$this->validates_length_of('nombre', '25', 0,array('too_long'=>'Nombre muy largo')) | $this->validates_length_of('nombre', '25', 0,array('too_long'=>'Nombre muy largo')) | ||
− | + | </pre> | |
− | </ | + | |
===validates_inclusion_in($field, $list, $params=array())=== | ===validates_inclusion_in($field, $list, $params=array())=== | ||
Línea 925: | Línea 528: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_inclusion_in('seleccion', array('a', 'b')) | $this->validates_inclusion_in('seleccion', array('a', 'b')) | ||
− | + | </pre> | |
− | </ | ||
Línea 943: | Línea 544: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_exclusion_of('seleccion', array('a', 'b')) | $this->validates_exclusion_of('seleccion', array('a', 'b')) | ||
− | + | </pre> | |
− | </ | ||
===validates_format_of($field, $pattern, $params=array())=== | ===validates_format_of($field, $pattern, $params=array())=== | ||
Línea 960: | Línea 559: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_format_of('seleccion', '/^\d{3}[A-Z]/') | $this->validates_format_of('seleccion', '/^\d{3}[A-Z]/') | ||
− | + | </pre> | |
− | < | + | |
+ | ===validates_format_of($field, $pattern, $params=array())=== | ||
+ | Valida que el campo coincida con el patron indicado | ||
+ | |||
+ | string '''$field''': campo a validar<br> | ||
+ | array '''$pattern''': expresion regular compatible con perl<br> | ||
+ | array '''$params''': array de parametros con nombre | ||
+ | |||
+ | Parametros con nombre:<br> | ||
+ | message: mensaje a mostrar<br> | ||
+ | field: nombre del campo | ||
+ | <pre> | ||
+ | $this->validates_format_of('seleccion', '/^\d{3}[A-Z]/') | ||
+ | </pre> | ||
Línea 978: | Línea 589: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_numericality_of('cedula') | $this->validates_numericality_of('cedula') | ||
− | + | </pre> | |
− | </ | ||
Línea 995: | Línea 604: | ||
field: nombre del campo | field: nombre del campo | ||
− | < | + | <pre> |
− | |||
$this->validates_email_in('email') | $this->validates_email_in('email') | ||
− | + | </pre> | |
− | </ | ||
==Modos de una Aplicación== | ==Modos de una Aplicación== | ||
Línea 1005: | Línea 612: | ||
===Production=== | ===Production=== | ||
− | Indicando en el config.ini '''"production = On"''', se entra en el modo de producción, en este la cache de kumbiaphp framework esta activada y se cachea información necesaria para agilizar la carga de la aplicación tal como la metadata de la base datos (información de tablas y campos), asimismo las vistas que el usuario desee cachear. | + | Indicando en el config.ini '''"production = On"''', se entra en el modo de producción, en este la cache de kumbiaphp framework esta activada y se cachea información necesaria para agilizar la carga de la aplicación tal como la metadata de la base datos (información de tablas y campos), asimismo las vistas que el usuario desee cachear. |
===Development=== | ===Development=== | ||
− | Indicando en el config.ini '''"production = Off"''', se entra en el modo de desarrollo, en este la cache de | + | Indicando en el config.ini '''"production = Off"''', se entra en el modo de desarrollo, en este la cache de kumbiaphp framework esta desactivada y cualquier cambio que se haga en los campos y tablas de la base de datos (adición de campos, etc), vistas de la aplicación que se cacheen, surtirán efecto inmediatamente. |
− | La | + | La cache de kumbiaphp framework se puede activar nuevamente utilizando el método active de la clase Cache. |
− | < | + | <pre> |
− | + | Cache::active(true); | |
− | </ | + | </pre> |
− | '''Cuando se cambia de modo, es necesario limpiar la cache que | + | '''Cuando se cambia de modo, es necesario limpiar la cache que kumbiaphp framework ha creado para que se pueda renovar los nuevos metadatos y vistas, esto se hace simplemente eliminando el contenido del directorio de cache para la aplicación, en el caso de la aplicación por defecto sería el directorio cache/default/.''' |
== Carga selectiva de modelos == | == Carga selectiva de modelos == | ||
En la [https://launchpad.net/kumbia/0.5.1 versión 1.0](<s>antigua 0.5.1</s>) se puede cargar solo los modelos que el controlador requiera, de esa manera se optimiza los procesos de la aplicación y consume menos recursos. Para utilizar la carga selectiva, es conveniente deshabilitar la autocarga de modelos en el config.ini con '''"models_autoload = Off"'''. | En la [https://launchpad.net/kumbia/0.5.1 versión 1.0](<s>antigua 0.5.1</s>) se puede cargar solo los modelos que el controlador requiera, de esa manera se optimiza los procesos de la aplicación y consume menos recursos. Para utilizar la carga selectiva, es conveniente deshabilitar la autocarga de modelos en el config.ini con '''"models_autoload = Off"'''. | ||
− | + | Para cargar los modelos en el controlador se utiliza el método estático '''"Load::models($modelo)"''' | |
− | |||
− | |||
− | |||
− | + | El parámetro '''$modelo''' puede ser un directorio y/o archivo, en el caso de ser el archivo debe ser igual al nombre del mismo. | |
− | <source lang=php > | + | <source lang=php line> |
− | class UsuarioController extends ApplicationController | + | class UsuarioController extends ApplicationController { |
− | { | ||
public function index() | public function index() | ||
{ | { | ||
Línea 1040: | Línea 643: | ||
</source> | </source> | ||
− | Asimismo se puede indicar con el atributo de controlador $models | + | Asimismo se puede indicar con el atributo de controlador $models. |
− | <source lang=php > | + | <source lang=php line> |
class UsuarioController extends ApplicationController { | class UsuarioController extends ApplicationController { | ||
Línea 1053: | Línea 656: | ||
</source> | </source> | ||
− | + | '''Uso avanzado''' | |
− | <source lang=php > | + | <source lang=php line> |
class UsuarioController extends ApplicationController { | class UsuarioController extends ApplicationController { | ||
Línea 1069: | Línea 672: | ||
} | } | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</source> | </source> | ||
Línea 1141: | Línea 700: | ||
Ademas se pueden utilizar los Helpers y Partials dentro de estos views. | Ademas se pueden utilizar los Helpers y Partials dentro de estos views. | ||
− | < | + | <pre> |
<?php echo link_to('pages/show/aviso', 'Ir Aviso') ?> | <?php echo link_to('pages/show/aviso', 'Ir Aviso') ?> | ||
− | </ | + | </pre> |
Mostrará un enlace que al hacer clic ira a dominio.com/pages/show/aviso | Mostrará un enlace que al hacer clic ira a dominio.com/pages/show/aviso | ||
+ | |||
+ | |||
== Nuevo Helper == | == Nuevo Helper == | ||
Línea 1164: | Línea 725: | ||
El componente Filter, es un componente que permite filtrar y validar datos de una manera intuitiva, facil y simple. | El componente Filter, es un componente que permite filtrar y validar datos de una manera intuitiva, facil y simple. | ||
− | Filter dispone de | + | Filter dispone de un método estático "Filter::get" el cuál permite filtrar el elemento indicado. |
=== Filter::get($s, $options=array()) === | === Filter::get($s, $options=array()) === | ||
− | '''$s ( | + | '''$s (string, array, object)''': array, objeto, o string a filtrar. |
<br> | <br> | ||
'''$options (array)''': array de configuración del filtro. | '''$options (array)''': array de configuración del filtro. | ||
− | Los filtros se aplican | + | Los filtros se aplican de manera recursiva en los arrays y objetos. |
Ejemplo: | Ejemplo: | ||
− | < | + | <pre> |
$value = Filter::get($s, 'htmlspecialchars', array('charset' => 'UTF-8')); | $value = Filter::get($s, 'htmlspecialchars', array('charset' => 'UTF-8')); | ||
− | </ | + | </pre> |
Asimismo se pueden aplicar filtros en cadena. | Asimismo se pueden aplicar filtros en cadena. | ||
− | < | + | <pre> |
$value = Filter::get($s, 'trim', 'addslashes'); | $value = Filter::get($s, 'trim', 'addslashes'); | ||
− | </ | + | </pre> |
− | |||
− | |||
− | |||
− | |||
− | + | Los filtros en cadena no aceptan opciones de configuración, tomando las opciones por defecto. | |
− | |||
− | |||
− | |||
− | Los filtros | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Filtros === | === Filtros === | ||
Línea 1223: | Línea 753: | ||
Escapa las comillas dobles y simples en una cadena de texto. | Escapa las comillas dobles y simples en una cadena de texto. | ||
− | < | + | <pre> |
$value = Filter::get('hola "gente"', 'addslashes'); | $value = Filter::get('hola "gente"', 'addslashes'); | ||
− | </ | + | </pre> |
==== alnum ==== | ==== alnum ==== | ||
Filtra la cadena eliminando los caracteres que no son alfanumericos o espacios. | Filtra la cadena eliminando los caracteres que no son alfanumericos o espacios. | ||
− | < | + | <pre> |
$value = Filter::get('hola "gente112"', 'alnum'); | $value = Filter::get('hola "gente112"', 'alnum'); | ||
− | </ | + | </pre> |
==== alpha ==== | ==== alpha ==== | ||
Filtra la cadena eliminando los caracteres que no son alfabéticos o espacios. | Filtra la cadena eliminando los caracteres que no son alfabéticos o espacios. | ||
− | < | + | <pre> |
$value = Filter::get('hola "gente112"', 'alpha'); | $value = Filter::get('hola "gente112"', 'alpha'); | ||
− | </ | + | </pre> |
==== date ==== | ==== date ==== | ||
Verifica que sea una fecha valida en el formato YYYY-MM-DD. | Verifica que sea una fecha valida en el formato YYYY-MM-DD. | ||
− | < | + | <pre> |
− | if(Filter:: | + | if(Filter::date($s, 'date')) { |
... | ... | ||
} | } | ||
− | </ | + | </pre> |
==== digits ==== | ==== digits ==== | ||
− | Filtra la cadena eliminando los caracteres que | + | Filtra la cadena eliminando los caracteres que nos son digitos. |
− | < | + | <pre> |
$value = Filter::get('hola "gente112"', 'digits'); | $value = Filter::get('hola "gente112"', 'digits'); | ||
− | </ | + | </pre> |
==== htmlentities ==== | ==== htmlentities ==== | ||
Escapa los elementos del lenguaje html con sus correspondientes entidades. | Escapa los elementos del lenguaje html con sus correspondientes entidades. | ||
− | < | + | <pre> |
$value = Filter::get('<p>"hola"</p>', 'htmlentities'); | $value = Filter::get('<p>"hola"</p>', 'htmlentities'); | ||
− | </ | + | </pre> |
'''Opciones:'''<br> | '''Opciones:'''<br> | ||
Línea 1270: | Línea 800: | ||
Escapa caracteres especial de html. | Escapa caracteres especial de html. | ||
− | < | + | <pre> |
$value = Filter::get('<p>"hola"</p>', 'htmlspecialchars'); | $value = Filter::get('<p>"hola"</p>', 'htmlspecialchars'); | ||
− | </ | + | </pre> |
'''Opciones:'''<br> | '''Opciones:'''<br> | ||
Línea 1280: | Línea 810: | ||
Convierte un valor a tipo entero. | Convierte un valor a tipo entero. | ||
− | < | + | <pre> |
$value = Filter::get('1.2', 'int'); | $value = Filter::get('1.2', 'int'); | ||
− | </ | + | </pre> |
==== ipv4 ==== | ==== ipv4 ==== | ||
Verifica si la cadena tiene el formato ipv4. | Verifica si la cadena tiene el formato ipv4. | ||
− | < | + | <pre> |
if(Filter::get($s, 'ipv4')) { | if(Filter::get($s, 'ipv4')) { | ||
... | ... | ||
} | } | ||
− | </ | + | </pre> |
==== lower ==== | ==== lower ==== | ||
Convierte una cadena de texto a minusculas. | Convierte una cadena de texto a minusculas. | ||
− | < | + | <pre> |
$value = Filter::get('TEXTO', 'lower'); | $value = Filter::get('TEXTO', 'lower'); | ||
− | </ | + | </pre> |
==== md5 ==== | ==== md5 ==== | ||
Calcula el hash md5 para el valor indicado. | Calcula el hash md5 para el valor indicado. | ||
− | < | + | <pre> |
$value = Filter::get('TEXTO', 'md5', array('binary' => true)); | $value = Filter::get('TEXTO', 'md5', array('binary' => true)); | ||
− | </ | + | </pre> |
'''Opciones:'''<br> | '''Opciones:'''<br> | ||
Línea 1313: | Línea 843: | ||
Convierte el caracter de nueva linea a "<br>". | Convierte el caracter de nueva linea a "<br>". | ||
− | < | + | <pre> |
$value = Filter::get('TEXTO\nTexto2', 'nl2br'); | $value = Filter::get('TEXTO\nTexto2', 'nl2br'); | ||
− | </ | + | </pre> |
==== numeric ==== | ==== numeric ==== | ||
Filtra una cadena solo permitiendo valores numericos. | Filtra una cadena solo permitiendo valores numericos. | ||
− | < | + | <pre> |
$value = Filter::get('a1.2', 'numeric'); | $value = Filter::get('a1.2', 'numeric'); | ||
− | </ | + | </pre> |
==== stripslashes ==== | ==== stripslashes ==== | ||
Filtra una cadena haciendo la operación inversa a addslashes. | Filtra una cadena haciendo la operación inversa a addslashes. | ||
− | < | + | <pre> |
$value = Filter::get('\"Hola\"', 'stripslashes'); | $value = Filter::get('\"Hola\"', 'stripslashes'); | ||
− | </ | + | </pre> |
==== stripspace ==== | ==== stripspace ==== | ||
Elimina los espacios. | Elimina los espacios. | ||
− | < | + | <pre> |
− | $value = Filter::get(' | + | $value = Filter::get('a1.2', 'numeric'); |
− | </ | + | </pre> |
==== striptags ==== | ==== striptags ==== | ||
Elimina las etiquetas HTML. | Elimina las etiquetas HTML. | ||
− | < | + | <pre> |
$value = Filter::get('<p>Hola</p>', 'striptags'); | $value = Filter::get('<p>Hola</p>', 'striptags'); | ||
− | </ | + | </pre> |
==== trim ==== | ==== trim ==== | ||
Elimina los espacios en blanco a la izquiera y a la derecha. | Elimina los espacios en blanco a la izquiera y a la derecha. | ||
− | < | + | <pre> |
$value = Filter::get(' Hola ', 'trim'); | $value = Filter::get(' Hola ', 'trim'); | ||
− | </ | + | </pre> |
==== upper ==== | ==== upper ==== | ||
Convierte la cadena a mayúsculas. | Convierte la cadena a mayúsculas. | ||
− | < | + | <pre> |
$value = Filter::get('hola', 'upper'); | $value = Filter::get('hola', 'upper'); | ||
− | </ | + | </pre> |
=== Extendiendo el componente Filter === | === Extendiendo el componente Filter === | ||
El componente Filter puede extenderse permitiendo al usuario crear sus propios filtros, para este fin el usuario debe hacer uso de la interface "FilterInterface", la cual se describe a continuación: | El componente Filter puede extenderse permitiendo al usuario crear sus propios filtros, para este fin el usuario debe hacer uso de la interface "FilterInterface", la cual se describe a continuación: | ||
− | < | + | <pre> |
interface FilterInterface | interface FilterInterface | ||
{ | { | ||
Línea 1373: | Línea 903: | ||
public static function execute ($s, $options); | public static function execute ($s, $options); | ||
} | } | ||
− | </ | + | </pre> |
− | Los filtros de usuario deben ubicarse en el directorio "app | + | Los filtros de usuario deben ubicarse en el directorio "app/filters". |
Por convenio la clase que corresponde al filtro debe llevar el sufijo "Filter" y el archivo debe llamarse igual que la clase pero en notación smallcase. | Por convenio la clase que corresponde al filtro debe llevar el sufijo "Filter" y el archivo debe llamarse igual que la clase pero en notación smallcase. | ||
'''Ejemplo:''' | '''Ejemplo:''' | ||
+ | <br> | ||
Un filtro que permite obtener la extension de un archivo, pasandole como valor el nombre del archivo. | Un filtro que permite obtener la extension de un archivo, pasandole como valor el nombre del archivo. | ||
− | app | + | app/filters/file_extension_filter.php |
− | < | + | <pre> |
/** | /** | ||
− | * Filtro para obtener la | + | * Filtro para obtener la extension de un archivo |
**/ | **/ | ||
class FileExtensionFilter implements FilterInterface | class FileExtensionFilter implements FilterInterface | ||
Línea 1394: | Línea 925: | ||
} | } | ||
} | } | ||
− | </ | + | </pre> |
Y se utilizaría de la siguiente manera: | Y se utilizaría de la siguiente manera: | ||
− | < | + | <pre> |
$ext = Filter::get('/home/yo/prueba.php', 'file_extension'); | $ext = Filter::get('/home/yo/prueba.php', 'file_extension'); | ||
− | </ | + | </pre> |
=== Filtrando datos enviados en el Request === | === Filtrando datos enviados en el Request === | ||
Línea 1405: | Línea 936: | ||
Ejemplo: | Ejemplo: | ||
− | <source lang=php > | + | <source lang=php line> |
class UsuarioController extends ApplicationController | class UsuarioController extends ApplicationController | ||
{ | { | ||
Línea 1420: | Línea 951: | ||
En el ejemplo anterior, los datos enviados en el array de campos "usuario", son filtrados con un trim, cargados por el constructor del objecto ActiveRecord y posteriormente se guarda en la base de datos. | En el ejemplo anterior, los datos enviados en el array de campos "usuario", son filtrados con un trim, cargados por el constructor del objecto ActiveRecord y posteriormente se guarda en la base de datos. | ||
− | == Carga | + | === Carga Perezosa, Inyección de Dependencias y el Componente Load === |
− | El componente | + | El componente Load, esta diseñado especialmente para satisfacer las necesidades de Carga Perezosa e Inyección de Dependencias, con este fin se dispone de los siguientes métodos: |
− | === Load:: | + | ==== Load::extensions($extension) ==== |
+ | Carga las extensiones complementarias de KumbiaPHP, se pueden indicar cargar extensiones de manera simultánea indicandolas como argumentos múltiples del método. | ||
− | + | <pre> | |
+ | Load::extensions('auth', 'benchmark', 'filter'); | ||
+ | </pre> | ||
− | + | ==== Load::vendors($vendor) ==== | |
− | + | Carga las librerias de terceros ubicadas en el directorio vendors, se pueden indicar cargar librerias de manera simultánea indicandolas como argumentos múltiples del método. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | <pre> | |
− | + | Load::extensions('wideimage/WideImage.inc', 'fpdf/fpdf'); | |
− | + | </pre> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | </ | ||
− | == | + | ==== Load::helpers($helper) ==== |
− | + | Carga los helpers para vistas, se pueden cargar varios de manera simultánea indicandolos como argumentos múltiples del método. Primero se buscará el helper en el directorio global core/helpers, de no existir el helper se cargará del directorio de helpers de la aplicación. | |
− | + | <pre> | |
+ | Load::helpers('html', 'mi_helper'); | ||
+ | </pre> | ||
− | + | ==== Load::models($model) ==== | |
− | + | Carga los modelos, se pueden cargar varios de manera simultánea indicandolos como argumentos múltiples del método o mediante un array. Asimismo se pueden cargar directorios completos de modelos. | |
− | |||
− | |||
− | .. | ||
− | |||
+ | Si la carga se efectua dentro del controlador, automaticamente se efectua una inyección de dependencias con instancias de los modelos cargadas en atributos del controlador con el nombre correspondiente al modelo. | ||
− | < | + | <pre> |
− | + | class UsuarioController extends ApplicationController | |
− | + | { | |
− | $this-> | + | public function lista() |
− | + | { | |
− | </ | + | Load::models('usuario'); |
+ | $this->usuarios = $this->Usuario->find(); | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
− | + | Cargando un directorio de modelos | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | <pre> | |
− | + | class ViviendaController extends ApplicationController | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | class | ||
{ | { | ||
− | + | public function lista() | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | public function | ||
{ | { | ||
− | + | Load::models('viviendas'); | |
− | } | + | $this->departamentos = $this->Departamento->find(); |
+ | $this->casas = $this->Casa->find(); | ||
+ | } | ||
} | } | ||
− | + | </pre> | |
− | </ | ||
+ | ==== Load::all_models() ==== | ||
+ | Carga los modelos ubicados en la raiz del directorios models. Si la carga se efectua dentro del controlador, automaticamente se efectua una inyección de dependencias con instancias de los modelos cargadas en atributos del controlador con el nombre correspondiente al modelo. | ||
− | + | <pre> | |
− | |||
− | < | ||
− | |||
class UsuarioController extends ApplicationController | class UsuarioController extends ApplicationController | ||
{ | { | ||
− | + | public function index() | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | public function | ||
{ | { | ||
− | $this-> | + | Load::all_models(); |
− | } | + | $this->usuario = $this->Usuario->find(); |
+ | } | ||
} | } | ||
− | + | </pre> | |
− | </ | ||
− | + | ==== Load::model($model) ==== | |
+ | Obtiene una instancia del modelo indicado, esto permite hacer uso de modelos en los helpers y otros lugares de la aplicación de manera intuitiva. | ||
− | < | + | <pre> |
− | + | /** | |
− | + | * Construye una lista desplegable para paises | |
− | + | **/ | |
− | + | function pais_select($id, $value=null) { | |
− | + | $Pais = Load::model('Pais'); | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | + | $code = "<select name=\"$id\" id=\"$id\">"; |
− | </ | + | foreach($Pais->find() as $pais) { |
+ | $nombre = Filter::get($pais->nombre, 'htmlspecialchars'); | ||
+ | $code .= "<option value=\"$pais->id\""; | ||
+ | if($pais->id == $value) { | ||
+ | $code .= ' selected="selected"'; | ||
+ | } | ||
+ | $code .= ">$nombre</option>"; | ||
+ | } | ||
+ | $code .= '</select>'; | ||
+ | |||
+ | return $code; | ||
+ | } | ||
+ | </pre> |