PDF de programación - Manual de KumbiaPHP Framework Versión 1.0 Spirit

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: 
 

 
 (Zero­Config). Empezar con KumbiaPHP es demasiado fácil, es solo 
1. Es muy ​fácil de usar
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