Edición de «KumbiaPHP Framework Versión 1.0 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 framework's 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."

  ;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

extensions = kumbia.logger, kumbia.auth

libs = logger, auth

 

== 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.

 

Constante que contiene la ruta absoluta al directorio donde se encuentra nuestra aplicación (app).

 

echo APP_PATH; //la salida es: /var/www/kumbiaphp/app/ 

 

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.

  include_once APP_PATH.'libs/test.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.'''

 

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.

 

 

 

'''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]]'''

 

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.

 

 

//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

 

 

 

|-- app

|  |-- application.php

|  |-- config

|  |-- controllers

|  |-- index.php

|  |-- tests

|  |-- vendors

|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]

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.

*'''locale''' Localización.

; locale: Localizacion

password = 1qaz2WSX

name = test

password = 1qaz2WSX

type = mssql

password = 1qaz2WSX

type = mssql

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.

O mejor usar el Load::lib('lib')

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 <s>versión 0.5</s> esto es representado por el archivo <s>'''views/index.phtml'''</s> de esta forma no existe una flexibilidad de manera que podamos cambiar ese template, en la [https://launchpad.net/kumbia/1.0 versión 1.0] se crea un directorio '''views/templates/''' por defecto existe el archivo '''default.phtml''' pero podemos agregar cuantos se desee y poderlo cambiar desde nuestro controlador de la siguiente forma:

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.

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).

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)]]'''.

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:

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.

=== Utilizando el método render($view, [$template]) ===

El método '''render($view, [$template])''' se encuentra en la super clase ApplicationController es decir lo tenemos disponible solo en los controladores.

Este es un método que es muy poderoso con una utilización correcta del mismo, en la versión 1.0 lo hemos extendido para ofrecer mas flexibilidad en el manejo de las vistas, el cual nos permite de forma dinámica poder cambiar un view y un [[#views.2Ftemplates.2F | Template]] (el template es opcional) esto nos permite tener varias vistas (views) para la misma action incluso varios [[#views.2Ftemplates.2F | Template]].

Esto es una de las ventajas del manejo de vistas de [http://www.kumbiaphp.com KumbiaPHP] y nos sirve para muchas cosas. Por ej: Si tenemos una aplicación web y también se quiere que esta pueda ser accedida desde dispositivos móviles (celular, PDA, etc.) no es necesario programar toda la aplicación de nuevo, sino que simplemente se cambia la vista pero lo mas importante es que el controlador sigue siendo el mismo.

==== Vamos a lo Práctico ====

'''NOTA: KumbiaPHP muestra el view con el mismo nombre de la acción.'''

    public function saludo($var=null)

            $this->render('adios');

'''app/views/blog/saludo.phtml'''  (vista por defecto de la acción).

  <?php echo "Bienvenido $usuario" ?>

La vista anterior se renderizara (mostrar) cuando tengamos la siguiente URL:

  http://dominio.com/blog/saludo/

'''app/views/blog/adios.phtml'''  (vista cuando existe el parámetro).

<source lang=php>

  <?php echo "Adios $usuario" ?>

La vista anterior se renderizara (mostrar) cuando tengamos la siguiente URL:

  http://dominio.com/blog/saludo/adios/

===== Cambiando el Template con método render($view, $template) =====

<source lang=php>

    if($var == 'adios'){

            $this->render('adios', 'otro_template');

</source>

Ahora mostramos un nuevo [[#views.2Ftemplates.2F | Template]] llamado '''otro_template''' para cuando cambiamos el views a '''adios'''.

===== Ahora sin Template render($view, null) =====

Ahora indicamos que no deseamos mostrar el [[#views.2Ftemplates.2F | Template]] veamos la misma acción pero sin el template.

<?php

     public function saludo($var=null)

     {

         $this->usuario = 'Usuario';

    if($var == 'adios'){

            $this->render('adios', null);

     }

===== Ahora sin view render(null, [$template]) =====

            Flash::notice('Adios '.$this->usuario);

            //sin el view y con el template por defecto

            $this->render(null);

===== Ahora sin view y sin template render(null, null) =====

Ahora indicamos que no deseamos mostrar el View de la acción y el Template, veamos la misma acción pero sin el view y sin template.

<?php

    public function saludo($var=null)

        $this->usuario = 'Usuario';

    if($var == 'adios'){

            $this->render(null, null);

            return Router::route_to('controller: otro_controller');

== Logger ==

La clase Logger para el manejo de [http://es.wikipedia.org/wiki/Log_(registro) Log] fue reescrita de forma estática, esto quiere decir ya no es necesario crear una instancia de la clase Logger. Esta clase dispone de una variedad de métodos para manejar distintos tipos de Log.

<?php Logger::error('Mensaje de Error')?>

La salida de la instrucción anterior será lo siguiente:

<pre>[Thu, 05 Feb 09 15:19:39 -0500][ERROR] Mensaje de Error</pre>

Por defecto los archivos log tienen el siguiente nombre '''logDDMMYYY.txt''' este nombre puede ser cambiado si así lo deseamos a través de un parámetro adicional al método.

Logger::warning ($msg);

Logger::error ($msg)

Logger::debug ($msg)

Logger::alert ($msg)

Logger::info ($msg)

Logger::emergence ($msg)

Logger::custom ($type='CUSTOM', $msg)

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").

 

===Cache::driver($driver=null)===

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'''.

 

$data = Cache::driver()->get('data');

 

// manejador para memcache

$data_memcache = Cache::driver('memcache')->get('data');

 

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")

$data = Cache::driver()->get('data');

===save($value, $lifetime=null, $id=false, $group='default')===

Guarda los datos a cachear.

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 '''$id''': identificador del elemento a almacenar, si no se especifica, se toma el id y grupo del ultimo get efectuado<br>

<?php if($data = Cache::driver()->get('data')): ?>

    <?php ob_start() ?>

        $data = ob_get_contents();

        Cache::driver()->save($data, '+21 days');

        ob_end_flush();       

<source lang=php>

Cache::driver()->save('hola', null, 'data');

$data = Cache::driver()->get('data');

Nota: el grupo "kumbia.*" esta reservado para el uso exclusivo de KumbiaPHP.

 

string '''$lifetime''': tiempo de vida de los datos (formato de 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 '''$group''': grupo al cual pertenece

<?php if($data = Cache::driver()->start('+1 day','data')): ?>

===clean($group=false)===

Limpia la cache. Si no se indica grupo limpia toda la cache.

<source lang=php>

Cache::driver()->clean('default');

</source>

Cache::driver()->remove('data');

=== cache($time, $type='view') ===

Para cachear una vista desde la acción:

Para cachear un template:

<pre>

$this->cache('+1 day', 'template');

Si no desea cachear:

<pre>

</pre>

 

        $this->validates_uniqueness_of('cedula', 'message: La cedula ya existe');

</source>

===validates_uniqueness_of($field, $params=array())===

Valida que el campo sea único

field: nombre del campo (muestra un mensaje con el valor del campo)

 

$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', 'field: cedula')

$this->validates_uniqueness_of('cedula', array('field'=>'cedula'))

</source>

 

===validates_date_in($field, $params=array())===

 

string '''$field''': campo a validar<br>

array '''$params''': array de parametros con nombre

$this->validates_date_in('fecha', 'message: Fecha invalida')

$this->validates_date_in('fecha', array('message'=>'Fecha invalida'))

 

===validates_presence_of($field, $params=array())===

Valida que el campo no sea nulo

$this->validates_presence_of('fecha_opt', 'field: Fecha')

===validates_length_of($field, $max, $min=0, $params=array())===

Valida el tamaño mínimo y máximo de caracteres permitidos en el campo

too_long: mensaje a mostrar cuando sea muy largo<br>

too_short: mensaje a mostrar cuando sea muy corto<br>

$this->validates_length_of('nombre', '25')

$this->validates_length_of('nombre', '25', 0,array('too_long'=>'Nombre muy largo'))

===validates_inclusion_in($field, $list, $params=array())===

Valida que el campo este incluido en los valores de la lista

$this->validates_inclusion_in('seleccion', array('a', 'b'))

===validates_exclusion_of($field, $list, $params=array())===

Valida que el campo no este incluido en los valores de la lista

array '''$list''': lista de elementos<br>

array '''$params''': array de parametros con nombre

Parametros con nombre:<br>

$this->validates_exclusion_of('seleccion', array('a', 'b'))

===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

$this->validates_format_of('seleccion', '/^\d{3}[A-Z]/')

...

Valida que el campo sea numerico

 

string '''$field''': campo a validar<br>

Parametros con nombre:<br>

$this->validates_numericality_of('cedula')

===validates_email_in($field, $params=array())===

string '''$field''': campo a validar<br>

Parametros con nombre:<br>

message: mensaje a mostrar<br>

field: nombre del campo

$this->validates_email_in('email')

==Modos de una Aplicación==

'''KumbiaPHP''' ofrece dos modos de ejecución de una aplicación el cual es indicado en el '''config.ini''', estos se describen a continuación:

===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 = Off"''', se entra en el modo de desarrollo, en este la cache de [http://www.kumbiaphp.com KumbiaPHP] 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.

 

'''Cuando se cambia de modo, es necesario limpiar la cache que [http://www.kumbiaphp.com KumbiaPHP] 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.'''

== 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"'''.

==== Load::models($model) ====

Si la carga se efectúa en el controlador, automaticamente una instancia del modelo es cargada en un atributo del controlador correspondiente al nombre del modelo en notación camelcase.

''NOTA: El parámetro '''$model''' puede ser un directorio y/o archivo, en el caso de ser el archivo debe ser igual al nombre del mismo.''

 

    //usuario.php y datos_personales.php

Asimismo se puede indicar con el atributo de controlador $models y estos serán cargados en cada acción.

  //Se cargan los modelos Usuario y DatosPersonales

  public $models = array('usuario', 'datos_personales');

<source lang=php >

  public function index()

    /** se cargan los modelos en:

    * mi_app/models/dir2/model1.php

    * mi_app/models/model2.php

    Load::models('dir', 'dir2/model1', 'model2')

==== Load::model($model) ====

* Construye una lista desplegable para países

function pais_select($id, $value=null) {

    //carga el modelo models/pais.php

        $code .= "<option value=\"$pais->id\"";

    return $code;

Uso avanzado...

...

    //carga el modelo ubicado en models/dir/user.php

    Load::model('dir/user')->find();

    //carga el modelo ubicado en models/user_group.php

    Load::model('user_group')->find();

 

Es un nuevo controlador para el manejo de páginas estáticas (views estáticos), aunque se puede utilizar como cualquier otro controlador haciendo uso de los [[KumbiaPHP_Framework_Versión_1.0_Spirit#Vistas |Templates y Partials]].

Los parámetros pasados al método '''show()''' indican vistas que están en views/pages/  manteniendo su estructura de directorios

Ejemplos:

Asi al ir a www.dominio.com/aviso enseñara la vista views/pages/aviso.phtml

<pre>

Al ir a www.dominio.com/organizacion/privacidad enseñará la vista en views/pages/organizacion/privacidad.phtml (si existe).

<?php echo link_to('pages/show/aviso', 'Ir Aviso') ?>

Mostrará un enlace que al hacer clic ira a dominio.com/pages/show/aviso

=== swf_tag($src) ===

<source lang="php" line>

<?php echo swf_tag("archivo.swf", "height: 300", "width: 300", "wmode: transparent") ?>

 

 

 

 

 

'''$s (mixed)''': el valor a filtrar.

Los filtros se aplican al valor indicado.

<source lang=php>  

$value = Filter::get($s, 'htmlspecialchars', array('charset' => 'UTF-8'));

<source lang=php>

$value = Filter::get($s, 'trim', 'addslashes');

Los filtros en cadena no aceptan opciones de configuración, por lo tanto toman las opciones por defecto.

=== Filter::get_array($array, $options=array()) ===

'''$options (array)''': array de configuración del filtro.

<source lang=php>  

$array = Filter::get_array(array('<b>Hola</b>', '<b>Adios</b>'), 'htmlspecialchars', array('charset' => 'UTF-8'));

<source lang=php>  

$array = Filter::get_array(array('saludo' => '<b>Hola</b>'), 'htmlspecialchars', array('charset' => 'UTF-8'));

=== Filter::get_object($object, $options=array()) ===

$object = Filter::get_object($usuario, 'htmlspecialchars', array('charset' => 'UTF-8'));

=== Filtros ===

 

==== addslashes ====

Escapa las comillas dobles y simples en una cadena de texto.