PDF de programación - Manual KumbiaPHP 1.0 beta2 56

Si no usamos headings no tendremos TOC !!!​ (TOC = tabla de contenido o índice)
Los nombres de archivo y métodos en ​itálica​.
El código en una tabla. ( No hemos encontrado mejor solución), por ahora se colorea con
http://codepad.org​ ​y fuente ​Courier New.
El texto y headings en Arial.



Manual de KumbiaPHP Framework



Versión 1.0 Spirit
Borrador para la beta2 Final



12 de junio de 2013

www.kumbiaphp.com



Índice general
(no tocar, se crea automático con los headings)

1 Introducción

1.1. Agradecimientos
1.2. Prefacio

1.2.1.
1.2.2.
1.2.3.
1.2.4.
1.2.5.
1.2.6.

Sobre este libro
Sobre KumbiaPHP
Sobre la comunidad
¿Porque usar KumbiaPHP Framework?
¿Qué aporta KumbiaPHP?
Modelo, Vista, Controlador (MVC)

1.2.6.1. ¿Que es MVC?
1.2.6.2. ¿Como KumbiaPHP aplica el MVC?
1.2.6.3. Más información
1.2.6.4. Caso práctico (CAMBIAR EJEMPLO)

2 Empezando con KumbiaPHP
Instalar KumbiaPHP

2.1.

2.1.1. Requisitos
2.1.2.

Configurar Servidor Web

2.1.2.1. Habitando mod_rewrite de Apache en GNU/Linux (Debian, Ubuntu y
Derivados)
2.1.2.2. ¿Por qué es importante el Mod-Rewrite?

2.1.3.

Mi Primera Aplicación con KumbiaPHP

2.1.3.1. Hola, KumbiaPHP!
2.1.3.2. El Controlador
2.1.3.3. La Vista
2.1.3.4. KumbiaPHP y sus URLs
2.1.3.5. Agregando más contenido

Para agregarle calidez al asunto, le preguntaremos al usuario su nombre vía

2.1.3.6. Repitiendo la Historia

3 El Controlador

3.1.

Controlador Frontal

3.1.1.
3.1.2.
3.1.3.

Destripando el Front Controller
Front Controller por defecto
Constantes de KumbiaPHP

3.1.3.1. APP_PATH
3.1.3.2. CORE_PATH
3.1.3.3. PUBLIC_PATH
Las Acciones

3.2.

3.2.1.
3.2.2.

Las acciones y las vistas
Obtener valores desde una acción
3.3. Convenciones y Creación de un Controlador

3.3.1. Convenciones
3.3.2. Creación de un Controlador

3.3.3.
3.3.4.

Clase AppController
Acciones y Controladores por defecto

3.4. Filtros

3.4.1. Filtros de Controladores

3.4.1.1. initialize()
3.4.1.2. finalize()

3.4.2. Filtros de Acciones
3.4.2.1. before_filter()
3.4.2.2. after_filter()

4 La Vista

4.1 Pasando datos a la vista
4.2 Buffer de salida
4.3 Template

4.3.1 ¿Cómo crear un Template?
4.3.2 ¿Cómo utilizar un template?
4.3.3 Pasando datos al template

4.4 Partial

4.4.1 ¿Como crear un partial?
4.4.2 ¿Cómo utilizar un partial?
4.4.3 Pasando datos a los partials

4.5 Agrupando en directorios

4.5.1 Ejemplo de agrupación de vista
4.5.2 Ejemplo de agrupación de partial
4.5.3 Ejemplo de agrupación de template

4.6 Tipos de respuestas
4.7 Uso de cache en las vistas

4.7.1 Cache de vistas

4.7.1.1 Grupos de vistas en cache

4.7.2 Caché de templates
4.7.3 Caché de partials

4.8 Helpers

4.8.1 Clase Html

Html::img()
Html::link()
Html::lists()
Html::gravatar()
Html::includeCss()
Html::meta()
Html::includeMetatags()
Html::headLink()
Html::headLinkAction()
Html::headLinkResource()
Html::includeHeadLinks()

4.8.2. Clase Tag

Tag::css()
Tag::js()

Incluye un archivo JavaScript a la vista, partial o template

4.8.3. Clase Form
Form::open()
Form::openMultipart()
Form::close()
Form::input()
Form::text()
Form::pass()
Form::textarea()
Form::label()
Form::hidden()
Form::dbSelect()
Form::select()
Form::file()
Form::button()
Form::submitImage()
Form::submit()
Form::reset()
Form::check()
Form::radio()

Js

Js::link ()
Js::linkAction ()
Js::submit ()
Js::submitImage ()

Ajax

Ajax::link()
Ajax::linkAction()

5 Modelos

5.1 ActiveRecord
5.2 Ejemplo sin ActiveRecord
5.3 Cómo usar los modelos
5.4 ActiveRecord API

5.4.1 Consultas

5.4.1.1 distinct ()
5.4.1.2 find_all_by_sql (string $sql)
5.4.1.3 find_by_sql (string $sql)
5.4.1.4 find_first (string $sql)
5.4.1.5 find ()
5.4.1.6 select_one(string $select_query) (static)
5.4.1.7 exists()
5.4.1.8 find_all_by()
5.4.1.9 find_by_*campo*()
5.4.1.10 find_all_by_*campo*()

5.4.2 Conteos y sumatorias

5.4.2.1 count()

5.4.2.2 sum()
5.4.2.3 count_by_sql()

6 Scaffold

Introducción
Concepto
Objetivo
Primeros Pasos
Controlador
Ventajas
Desventaja
Views para el scaffold

7 Clases padre

7.1 AppController
7.2 ActiveRecord

7.2.1.
7.2.2.
7.2.3.
7.2.4.
7.2.5.

Ventajas del ActiveRecord
Crear un Modelo en Kumbia PHP Framework
Columnas y Atributos
Llaves Primarias y el uso de IDs
Convenciones en ActiveRecord

View

8 Libs de KumbiaPHP

Caché

driver($driver=null)
get($id, $group='default')
save($value, $lifetime=null, $id=false, $group='default')
start ($lifetime, $id, $group='default')
end ($save=true)

Logger

Logger::warning ($msg);
Logger::error ($msg)
Logger::debug ($msg)
Logger::alert ($msg)
Logger::critical ($msg)
Logger::notice ($msg)
Logger::info ($msg)
Logger::emergence ($msg)
Logger::custom ($type='CUSTOM', $msg)

Flash

Flash::error($text)
Flash::valid($text)
Flash::info($text)
Flash::warning($text)
Flash::show($name, $text)

Session

Session::set($index, $value, $namespace='default')
Session::get($index, $namespace='default')

Session::delete($index, $namespace='default')
Session::has($index, $namespace='default')

Load

Load::coreLib($lib)
Load::lib($lib)
Load::model($model)

Auth2

Solicitando un adaptador
Adaptador predeterminado
Como trabaja la autenticación
Adaptador Model

setModel()
identify()
logout()
setFields()
setSessionNamespace()
isValid()
getError()
setAlgos()
setKey()
setCheckSession()
setPass()
setLogin()
Obtener los campos cargados en sesión
Ejemplo

9 Usar clases externas
10 La Consola
Introducción
Cómo utilizar la Consola
Consolas de KumbiaPHP

Cache

clean [group] [--driver]
Permite limpiar la cache.
Argumentos secuenciales:
Argumentos con nombre:
Ejemplo:
php ../../core/console/kumbia.php cache clean

remove [id] [group]

Model

create [model]
delete [model]

Controller

create [controller]
delete [controller]

Desarrollando tus Consolas

Console::input

Apéndices

Integración de jQuery y KumbiaPHP

KDebug

CRUD

Introducción
Configurando database.ini
Modelo
Controller
Vistas
Probando el CRUD

Aplicación en producción
Partials de paginación

Classic
Digg
Extended
Punbb
Simple
Ejemplo de uso

Auth
Beta1 a Beta2
Deprecated
Métodos y clases que se usaban en versiones anteriores y que aun funcionan. Pero que
quedan desaconsejadas y que no funcionaran en el futuro (próxima beta o versión final):
Lista de cambios entre versiones:si no se especifica beta1 es que es compatible en
ambos casos
Cambio en las rutas entre versiones:



Glosario



1 Introducción

1.1. Agradecimientos
Este manual es para agradecer a los que con su tiempo y apoyo, en gran o en poca medida, han
ayudado a que este framework sea cada día mejor. A toda la comunidad que rodea a
KumbiaPHP, con sus preguntas, notificaciones de errores (Bug’s), aportes, críticas, etc., a todos
ellos ¡Gracias!.

1.2. Prefacio

1.2.1.Sobre este libro
El libro de KumbiaPHP intenta comunicar, todo lo que este framework puede ayudar en su
trabajo diario como desarrollador. Le permite descubrir todos los aspectos de KumbiaPHP y
aprender porque KumbiaPHP puede ser la herramienta, que estaba esperando para empezar a
desarrollar su proyecto. Este libro se encuentra en etapa de continuo desarrollo, diseño gráfico,
revisión ortográfica y gramática, contenidos, etc. Tal como sucede con el framework, por lo cual
se aconseja siempre disponer de la última versión.

Esta versión del manual ha cambiado mucho de la anterior. Gracias a la comunidad se han
reflejado cuestiones que se repetían en grupo, foro e IRC. También se detectó el mal uso del
MVC, y no se aprovechaban las facilidades del POO. Se ha intentado mejorar esos puntos
recurrentes de consulta, así como mejorar el entendimiento de uso, para que creen mejores y
más mantenibles aplicaciones.

1.2.2.Sobre KumbiaPHP
KumbiaPHP es un producto latino para el mundo. Programar debe ser tan bueno como bailar y
KumbiaPHP es un baile, un baile para programar. KumbiaPHP es un framework de libre uso bajo
licencia new BSD​. Por lo tanto, puedes usar KumbiaPHP para tus proyectos siempre y cuando
tengas en cuenta la licencia. Te aconsejamos que siempre uses versiones estables y lo más
recientes posibles, ya que se incluyen correcciones, nuevas funcionalidades y otras mejoras
interesantes.

1.2.3.Sobre la comunidad
La comunidad de KumbiaPHP está formada en su gran mayoría por gente hispano-latina, de la
cual nace un framework completamente en español. Y donde radica su mayor diferencia
respecto a otros frameworks que son, de forma nativa, anglosajones. Por otra parte se ha
intentado, con el tiempo, aportar nuevos sistemas de comunicación, así que se cuenta con una
lista de correo, el ​foro​, canal de IRC y una ​WiKi​. Esperamos que todo esto haga que la
comunidad sea una parte importante y vital para enriquecer y mejorar KumbiaPHP.
Puedes encontrar más información en ​www.kumbiaphp.com

1.2.4.¿Porque usar KumbiaPHP Framework?
Mucha gente pregunta ¿cómo es este framework?, ¿otro más?, ¿será fácil? ¿qué tan potente
es? etc. Pues aquí algunas razones para utilizar KumbiaPHP:


 
1. Es muy ​fácil de usar​ (Zero-Config). Empezar con KumbiaPHP es demasiado fácil, es solo
descomprimir y empezar a trabajar, esta filosofía también es conocida como Convención
sobre Configuración.

2. Agiliza el Trabajo​, crear una aplicación muy funcional con KumbiaPHP es cuestión de

horas o minutos, así que podemos darle gusto a nuestros clientes sin que afecte nuestro
tiempo. Gracias a las múltiples herramientas que proporciona el framework para agilizar
el trabajo podemos hacer más en menos tiempo.

3. Separar la Lógica de la Presentación​, una de las mejores prácticas de desarrollo
orientado a la Web es separar la lógica de los datos y la presentación, con KumbiaPHP
es sencillo aplicar el patrón MVC (Modelo, Vista, Controlador) y hacer nuestras
aplicaciones más fáciles de mantener y de e