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:
{{cleanupbox
 
|image=[[Archivo:Information_icon4.png|45px]]
 
|imageright=[[Archivo:Information_icon4.png|45px]]
 
|texto ='''Este manual corresponde la versión 1.0 beta 1(Desaconsejada). <br />Se recomienda ver la última versión del [https://github.com/KumbiaPHP/Documentation/tree/master/es Manual de KumbiaPHP 1.0]'''
 
}}
 
 
 
== 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 44: Línea 38:
  
 
*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]].
*Si Cargas librerias vía boot.ini ahora se usa libs= en vez de extensions= Y también se quita el prefijo '''kumbia.'''
 
  
'''KumbiaPHP 0.5'''
+
== Nueva Estructura de Directorios ==
<pre>
+
En la versión de KumbiaPHP se incorpora la siguiente estructura de directorios, a continuación se detallan los elementos mas relevantes:
[modules]
 
extensions = kumbia.logger, kumbia.auth
 
</pre>
 
'''KumbiaPHP 1.0'''
 
<pre>
 
[modules]
 
libs = logger, auth
 
</pre>
 
 
 
== Constante en KumbiaPHP==
 
En la version 1.0 Spirit, se ha creado tres constantes cada cual cumple un objetivo especifico con el fin de brindar mayor flexibilidad al momento de manejar rutas (paths) en el framework.
 
 
 
=== APP_PATH ===
 
Constante que contiene la ruta absoluta al directorio donde se encuentra nuestra aplicación (app).
 
 
 
Ejemplo:
 
<pre>
 
echo APP_PATH; //la salida es: /var/www/kumbiaphp/app/ 
 
</pre>
 
 
 
Esta constante es posible utilizarla para incluir archivos que se encuentre bajo el arbol de directorio de la aplicación, por ejemplo imagine que quiere incluir un archivo que esta en el directio '''app/libs/test.php''' la forma de hacerlo seria.
 
  
 
<pre>
 
<pre>
  include_once APP_PATH.'libs/test.php';
+
spirit/
</pre>
+
|-- app
 
+
|   |-- application.php
'''NOTA: siempre será mejor utilizar el [[KumbiaPHP_Framework_Versión_1.0_Spirit#Carga_Selectiva.2C_Inyecci.C3.B3n_de_Dependencias_y_el_Componente_Load |Componente Load]] para incluir dependencias.'''
+
|  |-- config
 
+
|  |-- controllers
=== CORE_PATH ===
+
|   |-- extensions
Constante que contiene la ruta absoluta al directorio donde se encuentra el [[KumbiaPHP_Framework_Versión_1.0_Spirit#Explicando_dir_core.2F |core]] de KumbiaPHP.
+
|  |  |-- filters
 
+
|  |  |-- helpers
Ejemplo:
+
|  |  `-- scaffolds
<pre>
+
|   |-- index.php
echo CORE_PATH; //la salida es: /var/www/kumbiaphp/core/ 
+
|  |-- libs
</pre>
+
|  |-- locale
 
+
|  |-- model_base.php
Para incluir archivos que se encuentre bajo este arbol de directorio es el mismo procedimiento que se explico para la constante APP_PATH
+
|  |-- models
 
+
|  |-- public
'''NOTA: El core de KumbiaPHP en la version 1.0 esta totalmente desacoplado del directorio de la aplicación. [[KumbiaPHP_Framework_Versión_1.0_Spirit#Ventajas_de_esta_nueva_estructura_de_directorios|Ventajas de la Estructura de directorio]]'''
+
|  |-- temp
 
+
|  `-- views
=== PUBLIC_PATH ===
+
|      |-- errors
Constante que contiene la URL para el navegador (browser) y apunta a '''app/public/''' para enlazar imágenes, CSS, JavaScript y todo lo que sea ruta para browser.
+
|      |-- pages
 
+
|      |-- partials
Ejemplo:
+
|       `-- templates
<pre>
+
|-- core
//Genera un link que ira al controller: controller y action: action
+
|  |-- console
<a href="<?php echo PUBLIC_PATH ?>controller/action/" title="Mi Link">Mi Link</a>
+
|  |-- docs
 
 
//Enlaza una imagen que esta en public/img/imagen.jpg
 
<img src="<?php echo PUBLIC_PATH ?>img/imagen.jpg" alt="Una Imagen" />
 
 
 
//Enlaza el archivo CSS en public/css/style.css
 
<link rel="stylesheet" type="text/css" href="<?php echo PUBLIC_PATH ?>css/style.css"/>
 
</pre>
 
 
 
'''NOTA: siempre será mejor hacer uso de los helpers'''
 
 
 
== Nueva Estructura de Directorios ==
 
En la versión de KumbiaPHP se incorpora la siguiente estructura de directorios, a continuación se detallan los elementos mas relevantes:
 
 
 
<pre>
 
spirit/
 
|-- app
 
|-- application.php
 
|  |-- config
 
|  |-- controllers
 
 
|  |-- extensions
 
|  |-- extensions
|  |  |-- filters
 
 
|  |  |-- helpers
 
|  |  |-- helpers
 
|  |  `-- scaffolds
 
|  |  `-- scaffolds
|  |-- index.php
+
|  |-- kumbia
 
|  |-- libs
 
|  |-- libs
|  |-- locale
+
|  |-- tests
|  |-- model_base.php
+
|  |-- vendors
|  |-- models
 
|  |-- public
 
|  |-- temp
 
|  `-- views
 
|      |-- errors
 
|      |-- pages
 
|      |-- partials
 
|      `-- templates
 
|-- core
 
|  |-- console
 
|  |-- docs
 
|  |-- extensions
 
|  |  |-- helpers
 
|  |  `-- scaffolds
 
|  |-- kumbia
 
|  |-- libs
 
|  |-- tests
 
|  |-- vendors
 
 
|  `-- views
 
|  `-- views
 
|      |-- errors
 
|      |-- errors
Línea 173: Línea 107:
 
|views||Estan agrupados las vistas de los controladores (controllers). Por defecto se encuentran los directorios '''templates/''', '''pages/''', '''partials/''' y '''errors/'''
 
|views||Estan agrupados las vistas de los controladores (controllers). Por defecto se encuentran los directorios '''templates/''', '''pages/''', '''partials/''' y '''errors/'''
 
|-
 
|-
|extensions||En este directorio se ubican las extensiones para nuestra aplicación, una extensión te permite adicionar nuevas características que serán utilizadas e integradas a la aplicación por medio de las librerías que proporciona [http://www.kumbiaphp.com KumbiaPHP]
+
|extensions||En este directorio se ubican las extensiones para nuestra aplicación, una extensión te permite adicionar nuevas características que serán utilizadas he integradas a la aplicación por medio de las librerías que proporciona [http://www.kumbiaphp.com KumbiaPHP]
 
|-
 
|-
 
|libs||En este directorio se pueden colocar clases propias con fines específicos o librerías externas al framework (vendors). Estas para ser utilizadas en los controladores (controllers) y/o Modelos (models).
 
|libs||En este directorio se pueden colocar clases propias con fines específicos o librerías externas al framework (vendors). Estas para ser utilizadas en los controladores (controllers) y/o Modelos (models).
Línea 193: Línea 127:
 
[[Archivo:Application_kumbiaphp_framework.png|center|thumb|200px|application.php]]
 
[[Archivo:Application_kumbiaphp_framework.png|center|thumb|200px|application.php]]
  
Como se aprecia en la imagen existe una estrecha relación entre '''application.php''' y los controladores disponibles en el directorio controllers/. Esta relación se basa principalmente en que las variables y métodos creados en el '''ApplicationController''' (application.php) estarán disponibles para ser usados en cualquier controlador que tengamos en nuestra aplicación.
+
Como se aprecia en la imagen existe una estrecha relación entre '''apllication.php''' y los controladores disponibles en el directorio controllers/. Esta relación se basa principalmente en que las variables y metodos creados en el '''ApplicationController''' (application.php), estarán disponibles para ser usados en cualquier controlador que tengamos en nuestra aplicación.
  
 
En esta clase se encuentran dos métodos principales, dichos métodos se comportan como un filtro antes y después de ejecutar un controller.
 
En esta clase se encuentran dos métodos principales, dichos métodos se comportan como un filtro antes y después de ejecutar un controller.
Línea 241: Línea 175:
 
Se agregan opciones para un manejo mas apropiado de la configuración del framework, para la aplicación.
 
Se agregan opciones para un manejo mas apropiado de la configuración del framework, para la aplicación.
  
 +
*'''models_autoload''' Auto carga de modelos, útil 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.
 
*'''cache_driver''' driver que se utilizara para el manejo de cache. KumbiaPHP cuenta con tres (3) driver: file, sqlite y memsqlite.
 
*'''cache_driver''' driver que se utilizara para el manejo de cache. KumbiaPHP cuenta con tres (3) driver: file, sqlite y memsqlite.
*'''locale''' Localización.
+
*'''locale''' Localicazión
*'''routes''' Activar enrutamiento estatico.
 
  
 
<pre>;; Configuracion de Aplicacion
 
<pre>;; Configuracion de Aplicacion
Línea 260: Línea 194:
 
; log_exceptions: muestra las excepciones en pantalla (On|off)
 
; log_exceptions: muestra las excepciones en pantalla (On|off)
 
; charset: codificacion de caracteres
 
; charset: codificacion de caracteres
 +
; models_autoload: Habilita la autocarga de modelos
 
; cache_driver: driver para la cache (file, sqlite, memsqlite)
 
; cache_driver: driver para la cache (file, sqlite, memsqlite)
 
; metadata_lifetime: Tiempo de vida de la metadata cacheada
 
; metadata_lifetime: Tiempo de vida de la metadata cacheada
; locale: Localizacion
+
; locale: Localicazion
; routes: Activar enrutamiento estatico
 
  
  
Línea 280: Línea 214:
 
log_exceptions = On
 
log_exceptions = On
 
charset = UTF-8
 
charset = UTF-8
 +
models_autoload = On
 
cache_driver = file
 
cache_driver = file
 
;metadata_lifetime = "+1 year"
 
;metadata_lifetime = "+1 year"
 
;locale = es_ES
 
;locale = es_ES
;routes = On
 
 
</pre>
 
</pre>
  
Línea 311: Línea 245:
 
host = localhost
 
host = localhost
 
username = root
 
username = root
password = 1qaz2WSX
+
password =
name = test
+
name = innogest
 
type = mysql
 
type = mysql
  
Línea 318: Línea 252:
 
host = localhost
 
host = localhost
 
username = root
 
username = root
password = 1qaz2WSX
+
password =
 
name = test
 
name = test
type = mssql
+
type = mysql
  
 
[test]
 
[test]
 
host = localhost
 
host = localhost
 
username = root
 
username = root
password = 1qaz2WSX
+
password =
 
name = test
 
name = test
type = mssql
+
type = mysql
 
</pre>
 
</pre>
  
 
== boot.ini ==
 
== boot.ini ==
En este archivo fue eliminado, ahora se recomienda la carga explicita con '''require''' o '''include''' o en su defecto aprovechar la autocarga de librerias de KumbiaPHP.
+
En este archivo es donde el usuario carga las extensiones (librerías) que trae el framework o bien alguna que deseen agregar.
O mejor usar el Load::lib('lib')
 
  
== Router ==
+
Extensiones Propias de Kumbiaphp Framework
Mejoras de Rendimiento.
+
*session
 +
*logger
 +
*auth
 +
*date
 +
*filter
 +
*acl
 +
*benchmark
 +
*security
 +
 
 +
Extensiones externas al framework
 +
*excel
 +
*fpdf
 +
*phpmailer
 +
*libchart
  
== Dispatcher ==
+
<pre>
Mejoras de Rendimiento.
+
; LIBRERIAS DISPONIBLES
 +
; Librerias Propias de KumbiaPHP Framework (libraries)
 +
;  * session
 +
;  * logger
 +
;  * auth
 +
;  * date
 +
;  * filter
 +
;  * acl
 +
;  * benchmark
 +
;  * security
 +
;
 +
; Cargadores en libraries para librerias de terceros (vendors)
 +
;  * excel
 +
;  * fpdf
 +
;  * phpmailer
 +
;  * libchart
  
== Clase Kumbia ==
+
 
Mejoras de Rendimiento.
+
[modules]
 +
libs = logger
 +
</pre>
 +
 
 +
Es decir, se usa libs= en vez de extensions=
 +
Y también se quita el prefijo kumbia.
 +
 
 +
0.5:
 +
<pre>
 +
[modules]
 +
libs = kumbia.logger, kumbia.auth
 +
</pre>
 +
1.0:
 +
<pre>
 +
[modules]
 +
libs = logger, auth
 +
</pre>
 +
 
 +
== Router ==
 +
Mejoras de Rendimiento.
 +
 
 +
== Dispatcher ==
 +
Mejoras de Rendimiento.
 +
 
 +
== Clase Kumbia ==
 +
Mejoras de Rendimiento.
  
 
== Vistas ==
 
== Vistas ==
Línea 391: Línea 377:
 
</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, en la'''versión 0.5''' se hacia uso de la funcion "render_partial", sin embargo con la finalidad de obtener mayor orden e intuitividad, esta función se encapsulo en la clase '''View''',  y basta con hacer en la vista (Templates, views) lo siguiente.
+
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, en la'''versión 0.5''' se hacia uso de la funcion "render_partial", sin embargo con la finalidad de obtener myor orden e intuitividad, esta función se encapsulo en la clase '''View''',  y basta con hacer en la vista (Templates, views) lo siguiente.
  
 
<source lang=php >
 
<source lang=php >
Línea 415: Línea 401:
 
</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 >
Línea 447: Línea 433:
 
</source>
 
</source>
  
Con la intención de ofrecer mayor comodidad, KumbiaPHP también hace posible obtener una instancia de un modelo directamente haciendo uso del método '''[[KumbiaPHP_Framework_Versión_1.0_Spirit#Load::model.28.24model.29 |Load::model($modelo)]]'''.
+
KumbiaPHP con la intención de ofrecer mayor comodidad tambien posible obtener una instancia de un modelo directamente haciendo uso del método '''[[KumbiaPHP_Framework_Versión_1.0_Spirit#Load::model.28.24model.29 |Load::model($modelo)]]'''.
  
 
<source lang=php >
 
<source lang=php >
Línea 458: Línea 444:
 
Este método de la clase '''View''' viene a remplazar la función '''content()''', esta se utiliza para indicar donde [http://www.kumbiaphp.com KumbiaPHP] debe renderizar (mostrar) el contenido almacenado en el buffer de salida, es decir el próximo nivel de la vista.
 
Este método de la clase '''View''' viene a remplazar la función '''content()''', esta se utiliza para indicar donde [http://www.kumbiaphp.com KumbiaPHP] debe renderizar (mostrar) el contenido almacenado en el buffer de salida, es decir el próximo nivel de la vista.
  
Su uso para las vistas de las acciones esta íntimamente ligado a los '''echo''' o '''print''' que efectué el usuario, asimismo determina el lugar donde se mostrarán los mensajes '''Flash''' provenientes de ActiveRecord o los propios. Ejemplo:
+
Su uso para las vistas de las acciones esta íntimamente ligado a los '''echo''' o '''print''' que efectué el usuario, asimismo determina el lugar donde se mostrarán los los mensajes '''Flash''' provenientes de ActiveRecord o los propios. Ejemplo:
  
 
<source lang=php >
 
<source lang=php >
Línea 481: Línea 467:
  
 
===View::helpers($helper)===
 
===View::helpers($helper)===
Un '''''helpers''''' representa una ayuda a nivel de las vistas (view), esto quiere decir siendo consistente con el m'''V'''c solo deben ser utilizados en las vistas.
+
Un '''''helpers''''' representa una ayuda a nivel de las vistas (view), esto quiere decir siendo consistente con el m'''V'''c solo deben ser utilizados en las vitas.
  
 
Los '''''helpers''''' estan ubicados en '''miapp/extensions/helpers/''', en ese directorio pueden existir tantos helpers como necesitemos [http://www.kumbiaphp.com KumbiaPHP], pero tambien pueden existir helpers en '''core/extensions/helpers/''' en estos casos el framework da prioridad a los helpers ubicados en el directorio de la aplicación, esto quiere decir que si existen dos archivos con el mismo nombre en los directorios helpers antes descrito [http://www.kumbiaphp.com KumbiaPHP] cargara el que se encuentra ubicado en el directorio de la aplicación (app).
 
Los '''''helpers''''' estan ubicados en '''miapp/extensions/helpers/''', en ese directorio pueden existir tantos helpers como necesitemos [http://www.kumbiaphp.com KumbiaPHP], pero tambien pueden existir helpers en '''core/extensions/helpers/''' en estos casos el framework da prioridad a los helpers ubicados en el directorio de la aplicación, esto quiere decir que si existen dos archivos con el mismo nombre en los directorios helpers antes descrito [http://www.kumbiaphp.com KumbiaPHP] cargara el que se encuentra ubicado en el directorio de la aplicación (app).
Línea 512: Línea 498:
  
 
     echo $code;
 
     echo $code;
 +
}
 
}
 
}
 
</source>
 
</source>
Línea 699: Línea 686:
  
 
==Cache==
 
==Cache==
El componente cache fué mejorado y ahora posee una implementación utilizando los patrones de diseño factory y singleton, para hacer uso de la cache es necesario tener permisos de escritura en el directorio "cache" (para el caso de los manejadores "sqlite" y "file").
+
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:
  
Puedes obtener un driver de Cache utilizando el metodo '''driver''' que te proporciona la clase Cache.
+
===Cache::get($id, $group='default')===
 +
Obtiene los datos cacheados. Los elementos cacheados pueden agruparse en grupos, lo cual permite evitar colisiones entre elementos cacheados con igual $id.
  
===Cache::driver($driver=null)===
+
string '''$id''': identificador del elemento cacheado<br>
Este metodo permite obtener un manejador de cache específico, si no se indica, se obtiene el manejador de cache por defecto indicado en el '''config.ini'''.
+
string '''$group''': grupo al cual pertenece el elemento cacheado (por defecto "default")
  
Ejemplos:
+
<pre>
 
+
$data = Cache::get('data');
<source lang=php>
+
</pre>
// cache por defecto
 
$data = Cache::driver()->get('data');
 
 
 
// manejador para memcache
 
$data_memcache = Cache::driver('memcache')->get('data');
 
 
 
// manejador para cache con APC
 
$data_apc = Cache::driver('APC')->get('data');
 
</source>
 
 
 
 
 
Todos los manejadores de cache comparten métodos comunes indicados através de la clase abstracta '''Cache''' he implementados especificamente en cada manejador, los metodos de los manejadores de cache son los siguientes:
 
 
 
===get($id, $group='default')===
 
Obtiene los datos cacheados. Los elementos cacheados pueden agruparse en grupos, lo cual permite evitar colisiones entre elementos cacheados con igual $id.
 
 
 
string '''$id''': identificador del elemento cacheado<br>
 
string '''$group''': grupo al cual pertenece el elemento cacheado (por defecto "default")
 
 
 
<source lang=php>
 
$data = Cache::driver()->get('data');
 
</source>
 
  
===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://es2.php.net/manual/en/function.strtotime.php strtotime]), si es null, los datos no expiran nunca.<br>
+
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
  
 
<source lang=php>
 
<source lang=php>
<?php if($data = Cache::driver()->get('data')): ?>
+
<?php if($data = Cache::get('data')): ?>
 
     <?php echo $data ?>
 
     <?php echo $data ?>
 
<?php else: ?>
 
<?php else: ?>
Línea 748: Línea 714:
 
     <?php  
 
     <?php  
 
         $data = ob_get_contents();
 
         $data = ob_get_contents();
         Cache::driver()->save($data, '+21 days');
+
         Cache::save($data, '+21 days');
 
         ob_end_flush();         
 
         ob_end_flush();         
 
     ?>
 
     ?>
Línea 756: Línea 722:
  
 
<source lang=php>
 
<source lang=php>
Cache::driver()->save('hola', null, 'data');
+
Cache::save('hola', null, 'data');
$data = Cache::driver()->get('data');
+
$data = Cache::get('hola');
 
</source>
 
</source>
  
 
Nota: el grupo "kumbia.*" esta reservado para el uso exclusivo de KumbiaPHP.
 
Nota: el grupo "kumbia.*" esta reservado para el uso exclusivo de KumbiaPHP.
  
===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 770: Línea 736:
  
 
<source lang=php>
 
<source lang=php>
<?php if($data = Cache::driver()->start('+1 day','data')): ?>
+
<?php if($data = Cache::start('+1 day','data')): ?>
 
     <?php echo $data ?>
 
     <?php echo $data ?>
 
<?php else: ?>
 
<?php else: ?>
 
     Hola
 
     Hola
     <?php Cache::driver()->end()?>
+
     <?php Cache::end()?>
 
<?php endif; ?>     
 
<?php endif; ?>     
 
</source>
 
</source>
  
===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.
  
 
<source lang=php>
 
<source lang=php>
Cache::driver()->clean('default');
+
Cache::clean('default');
 
</source>
 
</source>
  
===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
  
 
<source lang=php>
 
<source lang=php>
Cache::driver()->remove('data');
+
Cache::remove('data');
 
</source>
 
</source>
 +
 +
  
 
==Cacheo automático de views y templates==
 
==Cacheo automático de views y templates==
Línea 966: Línea 934:
 
</source>
 
</source>
  
 
+
===validates_format_of($field, $pattern, $params=array())===
 
+
Valida que el campo coincida con el patron indicado
===validates_numericality_of($field, $params=array())===
+
 
Valida que el campo sea numerico
+
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
 +
 
 +
<source lang=php>
 +
...
 +
$this->validates_format_of('seleccion', '/^\d{3}[A-Z]/')
 +
...
 +
</source>
 +
 
 +
 
 +
===validates_numericality_of($field, $params=array())===
 +
Valida que el campo sea numerico
  
 
string '''$field''': campo a validar<br>
 
string '''$field''': campo a validar<br>
Línea 1005: Línea 989:
  
 
===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===
Línea 1335: Línea 1319:
  
 
<source lang=php>
 
<source lang=php>
$value = Filter::get(' Hola  ', 'stripspace');
+
$value = Filter::get('a1.2', 'numeric');
 
</source>
 
</source>
  
Línea 1375: Línea 1359:
 
</source>
 
</source>
  
Los filtros de usuario deben ubicarse en el directorio "app/extensions/filters/".
+
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.
Línea 1447: Línea 1431:
 
     //Se carga core/libs/auth/auth.php, siempre que no exista algún archivo
 
     //Se carga core/libs/auth/auth.php, siempre que no exista algún archivo
 
     //con el mismo nombre en app/libs/ ya que KumbiaPHP da prioridad a tu app sobre el core.
 
     //con el mismo nombre en app/libs/ ya que KumbiaPHP da prioridad a tu app sobre el core.
     Load::lib('auth');
+
     Load::lib('Auth');
 
   }
 
   }
 
}
 
}
Línea 1487: Línea 1471:
 
Quedando la extensions Session con los siguientes métodos para el manejo de la sessiones.
 
Quedando la extensions Session con los siguientes métodos para el manejo de la sessiones.
  
===set($index, $value, $namespace='default')===
+
===set($index, $value, $namespace='default')===
Crear o especifica el valor para un indice de la sesión actual.
+
Crear o especifica el valor para un indice de la sesión actual.
 
+
 
<source lang=php>
+
<source lang=php>
Session::set('usuario', 'Administrador');
+
Session::set('usuario', 'Administrador');
</source>
+
</source>
 
+
 
===get($index, $namespace='default')===
+
===get($index, $namespace='default')===
Obtener el valor para un indice de la sesión actual.
+
Obtener el valor para un indice de la sesión actual.
 
+
 
<source lang=php>
+
<source lang=php>
Session::get('usuario');//retorna 'Administrador'
+
Session::get('usuario');//retorna 'Administrador'
</source>
+
</source>
 
+
 
===delete($index, $namespace='default')===
+
===unset_data($index, $namespace='default')===
Elimina el valor para un indice de la sesión actual.
+
Elimina el valor para un indice de la sesión actual.
 
+
 
<source lang=php>
+
<source lang=php>
Session::delete('usuario');
+
Session::unset_data('usuario');
</source>
+
</source>
 
+
 
===has($index, $namespace='default')===
+
===isset_data($index, $namespace='default')===
Verifica que este definido el indice en la sesión actual.
+
Verifica que este definido el indice en la sesión actual.
 
+
 
<source lang=php>
+
<source lang=php>
Session::has('id_usuario');//retorna false.
+
Session::isset_data('id_usuario');//retorna false.
</source>
+
</source>
 
+
 
 
+
 
NOTA: '''$namespace''' es un espacio individual en el cual se pueden contener las variables de sesión, permitiendo evitar colisiones con nombres de variables.
+
NOTA: '''$namespace''' es un espacio individual en el cual se pueden contener las variables de sesión, permitiendo evitar colisiones con nombres de variables.
 +
 
  
 
==Upload==
 
==Upload==
Línea 1552: Línea 1537:
  
  
=== Upload::image($name, $new_name=null) ===
+
=== Upload::img($name, $new_name=null) ===
 
Sube una imagen al directorio público "img/upload".
 
Sube una imagen al directorio público "img/upload".
  
Línea 1561: Línea 1546:
 
<source lang=php>
 
<source lang=php>
 
...
 
...
Upload::image('archivo');
+
Upload::img('archivo');
 
...
 
...
 
</source>
 
</source>
  
==Partials de Paginación==
+
==Vistas de Paginación==
 
Como complemento para el paginador de ActiveRecord, através de vistas parciales se implementan los tipos de vistas de paginación más comunes, estos se ubican en el directorio "core/views/partials/paginators" y estas en capacidad de personalizarlos en tu aplicación aprovechando las características de renderizado de vistas parciales.
 
Como complemento para el paginador de ActiveRecord, através de vistas parciales se implementan los tipos de vistas de paginación más comunes, estos se ubican en el directorio "core/views/partials/paginators" y estas en capacidad de personalizarlos en tu aplicación aprovechando las características de renderizado de vistas parciales.
  

Ten en cuenta que todas las contribuciones a KumbiaPHP Framework Wiki pueden ser editadas, modificadas o eliminadas por otros colaboradores. Si no deseas que las modifiquen sin limitaciones, no las publiques aquí.
Al mismo tiempo, asumimos que eres el autor de lo que escribiste, o lo copiaste de una fuente en el dominio público o con licencia libre (véase Proyecto:Derechos de autor para más detalles). ¡No uses textos con copyright sin permiso!

Para editar esta página, responde la pregunta que aparece abajo (más información):

Cancelar Ayuda de edición (se abre en una ventana nueva)

Plantilla usada en esta página: