2007-03-01 09:51:22

Para guardar los datos en tus modelos, necesitas proporcionar los datos que deseas almacenar. Los datos que se pasan a la funci�n «save()" deben pasarse como un array en el siguiente formato:
$datosParaGuardar = array('NombreDelModelo' => array('campo1' => 'valor', 'campo2' => 'valor'))

La orden «save()" que utilizaremos desde el controlador para guardar los datos en el modelo, y de paso en la base de datos si procede, quedar�a as�:
$this->Nombre Del Modelo?->save($datosParaGuardar, $validar, $listaDeCampos);

En donde $validar puede tomar los valores 'true' o 'false' y $listaDeCampos debe contener la lista de campos que pretendemos salvar en forma de array.
$listaDeCampos = array('campo1','campo2')

Para conseguir que los datos pasados a tu controlador tengan este formato, lo m�s f�cil es usar HTML Helper, ya que �ste crea elementos de formulario con los nombres apropiados que necesita Cake.

$html->input('Modelo/nombrecampo');

Si no quieres hacer esto asegurate que los elementos de tu formulario tengan nombres como data[Nombre Modelo?][nombrecampo].

Los datos enviados desde el formulario son autom�ticamente formateados de forma correcta y almacenados en la variable "$this->data" dentro de tu controlador, por tanto salvar los datos desde un formulario web es algo instantaneo.

Herencia en Cake

Para derivar una clase de otra en Cake, parece que no basta con la directiva “extends” al definir la clase, hay que a�adir la l�nea «loadModule('ClasePadre');" antes de definir la clase, ah� va un ejemplo:

loadModel('Analysis');
class Analysis Ctt? extends Analysis {
...

Otra forma de hacer esto ser�a: require_once dirname(FILE). DS . 'analysis.php';

Controladores

Propiedades del controlador

$autoRender

Esta variable es la responsable de que las acciones de un controlador llamen o renderizen una vista despu�s de terminar su ejecuci�n. Por defecto es 'true', podr�amos establecerla como 'false' para crear controladores ($var autoRender=false;) o acciones ($this->autoRender = false;) que no llamen a ninguna vista.

$name

Normalmente un controlador toma por defecto el modelo que corresponde a su nombre en singular. Si el controlador utiliza un modelo con nombre distinto o el nombre tiene un plural irregular utilizamos esta propiedad para establecerlo. Este recurso tambi�n resuelve problemas de nombres de modelos con Palabras Camello? en sistemas con PHP4.

La forma de uso es:
var $name = 'NombreDelModelo';

$uses

Si el controlador necesita m�s de un modelo utilizamos esta variable para indicarlo. Hay que incluir tambi�n el modelo que responde al nombre del controlador.

La forma de uso es
var $uses = array('Modelo1','Modelo2','Modelo3');

Funciones de controlador

Aunque en esta secci�n se describen las funciones m�s utilizadas en los Controladores de Cake, es conveniente consultar la api en http://api.cakephp.org// para una referencia completa

Interacci�n con las vistas

set($cadena_variable,$cadena_valor)

Sirve para pasar datos desde un controlador hacia una vista, en forma de variables, arrays, etc.

Por ejemplo:
$this->set('color','blue');

Ahora desde la vista podemos utilizar la variable $color que nos devolver� 'blue'.

render ($cadena_accion, $cadena_layout, $cadena_fichero)

Puede que no use esta funci�n muy a menudo, puesto que la llamada a 'render' se produce autom�ticamente al final de la ejecuci�n de cada acci�n de un controlador, renderizando la vista asociada al nombre de la acci�n. No obstante, puedes llamar a esta funci�n para que renderize la vista en cualquier punto de la ejecuci�n del controlador ( $this->render(); ).

Redireccionado (?)

flash($cadena_mensaje,$cadena_url, $entero_pausa)

Esta funci�n muestra un $mensaje al usuario usando el layout flash (est� en 'app/views/layouts/flash.thtml') durante el tiempo especificado en $pausa y luego env�a al usuario a la p�gina especificada en $url.

En el layout por defecto el usuario tambi�n puede pasar a la $url de destino pulsando en el hiperv�nculo asociado al propio mensaje.

Ejemplo:
$this->flash('La p�gina se ha grabado correctamente', 'paginas/list', 10);

Otras funciones �tiles

Aunque estas funciones son parte de la clase 'Object' de Cake est�n tambi�n disponibles desde el Controlador.

requestAction ($cadena_url, $array_extra)

Esta funci�n llama a una acci�n de otro controlador, retornando datos o una vista renderizada. La $url es una URL tipo Cake (/nombrecontrolador/accion/parametros). Si el array $extra incluye una clave 'return', Auto Render? es establecido autom�ticamente a 'true' para la acci�n, o sea la vista ser� renderizada.

Conseguir datos desde un controlador es simple. S�lo tienes que usar requestAction en el controlador donde necesitas los datos.

<code>
// Este es nuestro sencillo controlador
class Usuarios Controller? extends App Controller?
{

function obtenerListaUsuarios()

{

return $this->Usuario->findAll();

}

}
</code>

Imagina que necesitamos crear una tabla mostrando los usuarios del sistema. En vez de duplicar c�digo en otro controllador, podemos obtener los datos desde Usuarios Controller?::obtenerListaUsuarios() usando un requestAction().

<code>
class Productos Controller? extends App Controller?
{

function muestraUsuarioProductos()
{

$this->set('usuarios', $this->requestAction('/usuarios/obtenerListaUsuarios'));
// Ahora la variable $usuarios en la vista tiene los datos
// de Usuarios Controller?::obtenerListaUsuarios()

}

}
</code>

Si tienes un elemento no est�tico en tu aplicaci�n que usas mu a menudo, podr�as querer usar requestAction() para inyectarlo en tus vistas. Digamos que mejor que pasar s�lo los datos desde Usuarios Controller?::obtenerListaUsuarios(), queremos realmente renderizar la vista de esa acci�n (que podr�a consistir en una tabla), dentro de otro controlador. Esto nos ahorra duplicar c�digo de la vista.

<code>
class Programas Controller? extends App Controller?
{

function verTodo()
{

$this->set('tablaUsuario', $this->requestAction('/usuarios/obtenerListaUsuarios', array('return')));
// Ahora podemos hacer 'echo $tablaUsuario;' desde la vista de esta acci�n
// para ver la lista renderizada que esta disponible tambi�n desde /usuarios/obtenerListaUsuarios

}

}
</code>

Observa que las acciones llamadas desde requestAction() son renderizadas usando un dise�o o layout vac�o. De esta manera no tienes que preocuparte de dise�os renderiz�ndose dentro de otros dise�os.

La funci�n requestAction() es tambi�n de gran utilidad cuando usamos AJAX, donde un peque�o elemento de una vista necesita ser rellenado antes o durante un actualizaci�n AJAX.

Clases

Inflector

Se encarga de realizar conversiones entre nombre de modelos, vistas, controladores y ficheros. Transformando de plural a singular, de camel case a subrayado bajo, etc. Algunas de sus funciones son: pluralize, singularize, camelize, humanize o classify.

Ejemplo de uso: $plural = Inflector::pluralize($singular);
M�s informaci�n: http://api.cakephp.org/class_inflector.html

HtmlHelper

HTMLHelper est� incluido por defecto en cualquier controlador, pero si quermos usar otros helper tendremos que incluir tambi�n a 'Html' en el array que los carga.

var $helpers = array('Html','Ajax','Javascript');

Como todas las clases 'Helper' sus funciones se utilizan desde dentro de una vista, no desde el controlador, aunque se las referencie desde �ste.

link

url($cadena_url, $boolean_return)

Busca la URL para una accio�n especificada.

Devuelve una URL apuntando a una combinaci�n de controlador y acci�n. Si $url est� vac�o devuelve la direcci�n del controlador y la acci�n actual.

La variable $return determina si la funci�n debe devolver un valor o mostrarlo. Esto pasa por encima el valor de AUTO_OUTPUT.

Ejemplos:
$html->url('/productos/edit/92');
$html->url('/'); // Devuelve la url raiz de la aplicaci�n.

Nota: no se debe confundir esta funci�n con Html::link() que devuelve una etiqueta html completa para mostrar un hiperenlace.

SessionComponent

Es el encargado de lidiar con las variables de sesi�n.

startup (&$controller)
write ($name, $value)
read ($name=null)
del ($name)
delete ($name)
check ($name)
error ()
setFlash ($flashMessage, $layout= 'default', $params=array(), $key= 'flash')
flash ($key= 'flash')
renew ()
valid ()

Ficheros de configuraci�n

bootstrap.php

Este fichero se carga automaticamente desde app/webroot/index.php despu�s del bootstrap.php com�n a todos los proyectos de cake.

Este fichero es visible para toda la aplicaci�n y se usa para:

Cargar funciones que no son utilizadas desde dentro de ninguna clase.
Incluir o requerir ficheros para la aplicaci�n.
Proporcionar rutas adicionales para cargar modelos, vistas y controladores.

$modelPaths = array('ruta completa modelos', 'segunda ruta completa modelos', 'etc...');
$viewPaths = array('ruta completa vistas', 'segunda ruta completa vistas', 'etc...');
$controllerPaths = array('ruta completa controladores', 'segunda ruta completa controladores', 'etc...');

Enlaces de inter�s

Web oficiales

http://www.cakephp.org/ – Cake Official Site.
http://bakery.cakephp.org/ – The Bakery
http://wiki.cakephp.org/ – Cake Wiki, A community-powered wiki with various Cake tutorials and how-tos.
http://manual.cakephp.org/ – Cake Manual, Cake�s official manual.
http://www.cakeforge.org – Cake Forge, a repository for third-party Cake PHP? projects.
http://cakeforge.org/projects/cakedocs/ – Documentation for offline use.
http://groups.google.com/group/cake-php – Cake Google user group.
http://groups.google.com/group/CakePHP-es – Cake Google user group en espa�ol
Official Cake PHP? IRC channel: #cakephp on irc.freenode.net
Cake News

Blogs

http://cakebaker.wordpress.com/ – Cake Baker
http://rossoft.wordpress.com/ – Cake Tips & Tricks
http://www.nolimit-studio.com/baking/ – Baking with Sosa
http://www.thinkingphp.org/ – Thinking PHP?

M�s Webs

http://rd11.com/ – Cake PHP's? product manager website
http://www.h3rald.com/ – built with Cake, contains various Cake resources
http://grahambird.co.uk/cake/ – Cake for beginners, tutorials and resources

Articulos

«An overview of the Cake PHP? framework» – http://hades.phparch.com/ceres/public/article/index.php/art::cakephp::overview
"Cake PHP? – A 'tasty' solution for PHP programming": http://www.zzine.org/articles/cakephp – by Fabio Cevasco
“Rails-inspired PHP frameworks”: http://www.h3rald.com/articles/view/rails-inspired-php-frameworks/ – by Fabio Cevasco
21 things I learned about Cake PHP?: http://www.avatarfinancial.com/pages/cake/

2007-02-17 22:31:04

edited by JuananRuiz

2007-02-01 09:18:35

edited by JuananRuiz

2006-12-26 09:26:21

edited by JuananRuiz

2006-12-26 09:25:50

edited by JuananRuiz

2006-12-03 09:42:31

edited by 81.177.14.26

2006-12-03 04:44:39

edited by 81.177.14.26

2006-11-24 23:17:22

edited by JuananRuiz

2006-11-10 08:17:29

edited by JuananRuiz

2006-11-10 08:16:19

edited by JuananRuiz

2006-11-07 12:19:17

edited by JuananRuiz

2006-11-03 09:41:45

edited by JuananRuiz

2006-10-26 14:08:54

edited by JuananRuiz

2006-10-25 18:50:47

edited by JuananRuiz

2006-10-25 18:46:56

edited by JuananRuiz

2006-10-25 18:04:51

edited by JuananRuiz

2006-10-25 17:43:55

edited by JuananRuiz

2006-10-25 17:43:32

edited by JuananRuiz

2006-10-25 17:38:00

edited by JuananRuiz

2006-10-25 17:28:27

edited by JuananRuiz

WikiJuanan - ManualCakePHP

2007-03-01 09:51:22

Manual de Cake PHP

Modelos

�Qu� es un modelo?

Funciones de los modelos

Guardando los datos

Herencia en Cake

Controladores

Propiedades del controlador

$autoRender

$name

$uses

Funciones de controlador

Interacci�n con las vistas

set($cadena_variable,$cadena_valor)

render ($cadena_accion, $cadena_layout, $cadena_fichero)

Redireccionado (?)

flash($cadena_mensaje,$cadena_url, $entero_pausa)

Otras funciones �tiles

requestAction ($cadena_url, $array_extra)

Clases

Inflector

HtmlHelper

link

url($cadena_url, $boolean_return)

SessionComponent

Ficheros de configuraci�n

bootstrap.php

Enlaces de inter�s

Web oficiales

Blogs

M�s Webs

Articulos

2007-02-17 22:31:04

2007-02-01 09:18:35

2006-12-26 09:26:21

2006-12-26 09:25:50

2006-12-03 09:42:31

2006-12-03 04:44:39

2006-11-24 23:17:22

2006-11-10 08:17:29

2006-11-10 08:16:19

2006-11-07 12:19:17

2006-11-03 09:41:45

2006-10-26 14:08:54

2006-10-25 18:50:47

2006-10-25 18:46:56

2006-10-25 18:04:51

2006-10-25 17:43:55

2006-10-25 17:43:32

2006-10-25 17:38:00

2006-10-25 17:28:27