Convenciones en CakePHP¶

Convenciones en los Controladores¶

Nombre del Controlador en plural, CamelCased, y colocando Controller al final. PeopleController y LatestArticlesController son ejemplos que siguen esta convención.

El primer método a escribir en el controlador es index(). Cuando una petición vaya dirigida a este controlador, pero no se especifique acción, CakePHP ejecutará por defecto el método index(). Por ejemplo, la petición http://example.com/apples/ será dirigida al método index() del controlador ApplesController, así como la llamada a http://example.com/apples/view/ se mapeará al método view() de este mismo controlador.

Puedes cambiar la visibilidad de los métodos de CakePHP usando el carácter subrayado «_» al principio para ocultar su acceso directo desde la web, aunque será accesible internamente. Por ejemplo:

class NewsController extends AppController {

    function latest() {
        $this->_findNewArticles();
    }

    function _findNewArticles() {
        //Logic to find latest news articles
    }
}

El acceso a la url http://example.com/news/latest podrá realizarse con normalidad, mientras que al acceder a la url http://example.com/news/_findNewArticles/ retornará un error, ya que este método está precedido por un «_». También puedes usar los modificadores de visibilidad de PHP (private, protected, public) para esto. Los métodos que no sean públicos, no podrán ser accedidos.

Convenciones sobre nombres de fichero y nombres de clases¶

Como regla general, los nombres de fichero y los nombres de clase serán iguales, en formato CamelCased. Si tienes una clase MyNiftyClass, el fichero que la contiene se llamará MyNiftyClass.php. En el listado siguiente se muestran algunos ejemplos:

• El controlador con nombre KissesAndHugsController estará definido en el fichero KissesAndHugsController.php

• El componente con nombre MyHandyComponent estará en el fichero MyHandyComponent.php

• El modelo con nombre OptionValue estará en el fichero OptionValue.php

• El comportamiento (behavior) EspeciallyFunkableBehavior estará en el fichero EspeciallyFunkableBehavior.php

• La vista SuperSimpleView estará en el fichero SuperSimpleView.php

• El helper BestEverHelper estará, como ya habrás adivinado, en el fichero BestEverHelper.php

Cada uno de estos ficheros estará en la carpeta correspondiente bajo el directorio /app.

Convenciones para modelos y bases de datos¶

Los nombres de clase para los modelos serán CamelCased. Persona, GranPersona y SuperGranPersona, son ejemplos válidos para modelos.

Para las tablas en la base de datos se utiliza plural y el carácter subrayado (underscored) de esta forma: gran_personas, super_gran_personas. Verás que al leer los plurales en español, no tienen el sentido correcto. Ten en cuenta que esta convención proviene del inglés y si escribes los nombres de tus modelos en inglés, todo tiene mucho más sentido. Puedes saltarte esta convención en cualquier momento y escribir plurales más adecuados al español.

Puedes también usar la clase de utilidad Inflector para comprobar el singular y plural de las palabras. Consulta la documentación aquí Inflector.

Los nombres de los campos con más de una palabra se escriben en minúscula y subrayado, por ejemplo first_name.

Las claves foráneas o ajenas (foreign keys) en las relaciones “a muchos” (hasMany), “pertenece a” (belongsTo) y “a uno” (hasOne) se reconocen por defecto si el nombre del campo se escribe usando el singular de la tabla con la que se relaciona y terminando en _id. Por ejemplo el modelo Baker tiene una relación “a muchos” con el modelo Cake. En la tabla cakes escribiremos un campo con el nombre baker_id. En caso de que el nombre de la tabla tenga varias palabras, como en category_types, la clave sería category_type_id.

Cuando la tabla es el resultado de una relación de “muchos a muchos” (HABTM o hasAndBelongsToMany), se nombrará utilizando el nombre de cada tabla de la relación, en orden alfabético y plural. Por ejemplo se usará apples_zebras en lugar de zebras_apples.

Todas las tablas que utilicemos en CakePHP, salvo las tablas de unión de las relaciones “muchos a muchos”, requieren una clave primaria en un único campo para identificar cada fila. Si necesitas que algún modelo no tenga clave primaria en un único campo, la convención es que añadas este campo a la tabla.

CakePHP no soporta claves primarias compuestas. Si quieres manipular directamente los datos de una tabla de unión, usa query y construye una query manualmente, o añade una clave primaria a la tabla para poder trabajar con ella como con un modelo normal. Ejemplo:

CREATE TABLE posts_tags (
id INT(10) NOT NULL AUTO_INCREMENT,
post_id INT(10) NOT NULL,
tag_id INT(10) NOT NULL,
PRIMARY KEY(id));

En vez de usar un campo numérico autoincremental como clave primaria, también puedes usar un char(36). Si has definido así tu clave primaria, CakePHP gestionará esta clave añadiendo un UUID (String::uuid), que es un código único que identificará a cada registro, cada vez que realices un Model::save en ese modelo.

Convenciones en la vistas¶

Los nombres de las vistas son iguales a los del método del controlador al que hacen referencia, en formato subrayado. Por ejemplo el método getReady() del controlador PeopleController buscará el fichero de vista en la ruta /app/View/People/get_ready.ctp.

El patrón para nombrar las vistas es /app/View/Controller/underscored_function_name.ctp.

Si usas las convenciones de CakePHP para tu aplicación, ganas inmediatamente funcionalidad gratis, que se mantiene sola y no necesita tocar la configuración. Sirva para ilustrar esto un ejemplo:

• Tabla en la base de datos: «people»

• Nombre de Modelo: «Person» (es el singular de people para CakePHP), en el fichero /app/Model/Person.php

• Nombre del Controlador: «PeopleController», en el fichero /app/Controller/PeopleController.php

• Plantilla para la vista en el fichero /app/View/People/index.ctp

Si usas estas convenciones, CakePHP sabrá que una llamada a http://example.com/people/ se mapeará a una llamada al método index() del controlador PeopleController, donde el modelo Person será instanciado automáticamente para su uso (leerá los datos de la tabla “people” en la base de datos). Ninguna de estas relaciones necesita ser creada ni configurada si nombras de la forma correcta los ficheros que de todos modos tienes que crear para que tu aplicación funcione.

Ahora conoces los fundamentos y convenciones que debes utilizar en CakePHP, te recomendamos que le eches un vistazo al tutorial para hacer un blog para ver cómo encajan estas piezas en una aplicación completa.