Welcome to The Cookbook

La propriété useDbConfig spécifie quel paramètre du fichier de configuration de la base de données vous voulez utiliser. Le fichier de configuration de la base de données est stocké dans /app/config/database.php.

Exemple d'utilisation:

class Example extends AppModel {
   var $useDbConfig = 'alternative';
}

1. class Example extends AppModel {
2. var $useDbConfig = 'alternative';
3. }

La valeur par défaut de useDbConfig est 'default'.

La propriété useTable spécifie le nom de la table de la base de données. Par défaut, le modèle utilise le nom de la classe modèle au pluriel et en minuscule. Donnez à cet attribut le nom d’une table alternative, ou false

Exemple d'utilisation :

class Exemple extends AppModel {
   var $useTable = false; // Ce modèle n'utilise pas de table de la base de données
}

1. class Exemple extends AppModel {
2. var $useTable = false; // Ce modèle n'utilise pas de table de la base de données
3. }

Table alternative :

class Exemple extends AppModel {
   var $useTable = 'exmp'; // Ce modèle utilise la table 'exmp'
}

1. class Exemple extends AppModel {
2. var $useTable = 'exmp'; // Ce modèle utilise la table 'exmp'
3. }

Le nom du préfixe de la table utilisée par le modèle. Initialement, le préfixe utilisé est celui renseigné avec la connexion à la base de données dans /app/config/database.php. Par défaut il n'y a aucun préfixe. Vous pouvez surcharger la valeur par défaut en configurant l'attribut tablePrefix dans le modèle.

Exemple d'utilisation :

class Exemple extends AppModel {
   var $tablePrefix = 'alt_'; // cherchera la table 'alt_exemples'
}

1. class Exemple extends AppModel {
2. var $tablePrefix = 'alt_'; // cherchera la table 'alt_exemples'
3. }

Chaque table a normalement une clé primaire, id. Vous pouvez changer le champ qui sera utilisé par le modèle comme sa clé primaire. Ceci est fréquent lorsque l'on configure CakePHP pour utiliser une table existant déjà dans la base de données.

Exemple d'utilisation :

class Exemple extends AppModel {
    var $primaryKey = 'exemple_id'; // exemple_id est le nom du champ dans la base de données
}

1. class Exemple extends AppModel {
2. var $primaryKey = 'exemple_id'; // exemple_id est le nom du champ dans la base de données
3. }

L'attribut displayField spécifie quel champ de la base de données doit être utilisé comme intitulé pour l'enregistrement. L'intitulé est utilisé dans le maquettage rapide (scaffolding) ainsi que dans les appels à find('list'). Le modèle utilisera name ou title par défaut.

Par exemple, pour utiliser le champ pseudo :

class Exemple extends AppModel {
   var $displayField = 'pseudo';
}

1. class Exemple extends AppModel {
2. var $displayField = 'pseudo';
3. }

Les noms de champs multiples ne peuvent pas être combinés en un unique champ à afficher. Par exemple, vous ne pouvez pas spécifier array('prenom', 'nom') comme le champ à afficher.

La propriété recursive définit la profondeur jusqu'à laquelle CakePHP doit récupérer les données des modèles associés, à l'intérieur des méthodes find() et findAll().

Imaginons que votre application représente des Groupes dans un domaine qui ont plusieurs Utilisateurs qui à leur tour ont plusieurs Articles. Vous pouvez attribuer à $recursive des valeurs différentes en fonction de la quantité de données que vous souhaitez récupérer en appelant $this->Groupe->find() :

En fixant une valeur supérieure à ce dont vous avez besoin, CakePHP récupérera des données que vous n’utiliserez jamais ce qui ralentira inutilement votre application.

Si vous voulez combiner $recursive avec la fonctionnalité fields, vous devrez ajouter manuellement les colonnes contenant les clés étrangères nécessaires dans le tableau fields. Dans l'exemple ci-dessus, cela pourrait être l'ajout de domaine_id

L’ordre par défaut des données lors des opérations find. Les valeurs possibles incluent :

$order = "champ"
$order = "Modele.champ";
$order = "Modele.champ asc";
$order = "Modele.champ ASC";
$order = "Modele.champ DESC";
$order = array("Modele.champ" => "asc", "Modele.champ2" => "DESC");

1. $order = "champ"
2. $order = "Modele.champ";
3. $order = "Modele.champ asc";
4. $order = "Modele.champ ASC";
5. $order = "Modele.champ DESC";
6. $order = array("Modele.champ" => "asc", "Modele.champ2" => "DESC");

Le conteneur pour les données récupérées par le modèle. Bien que les données renvoyées depuis une classe de modèle sont en règle générale renvoyées par un appel à find(), vous pourriez avoir besoin d’accéder aux informations stockées dans $data à l’intérieur des callbacks du modèle.

Contient des méta-données décrivant les champs de la table de la base de données associée au modèle. Chaque champ est décrit par :

• nom
• type (integer, string, datetime, etc.)
• null
• valeur par défaut
• longueur

Cet attribut rassemble les règles permettant au modèle de décider de la validité des données avant une sauvegarde. Les clés mentionnées après le champ contiennent des expressions régulières permettant au modèle d’essayer de faire des correspondances.

Pour plus d'informations concernant la validation, regardez le chapitre Validation des données plus loin dans ce manuel

Comme vu plus tôt dans ce chapitre, l'attribut name est une caractéristique pour la compatibilité avec PHP4, il est fixé à la même valeur que le nom du modèle.

Exemple d'utilisation :

class Exemple extends AppModel {
   var $name = 'Exemple';
}

1. class Exemple extends AppModel {
2. var $name = 'Exemple';
3. }

Si il est mis à true, les données récupérées par le modèle lors d’une requête seule sont mises en cache. Cette mise en cache ne se fait qu’en mémoire et ne dure que le temps d’une requête. Ainsi, toutes les requêtes dupliquées pour les même données sont gérées par le cache.