Méthodes Callback¶

beforeFind¶

beforeFind(array $query)

Appelée avant toute opération liée à la recherche. Les $query passées à cette méthode de callback contiennent des informations sur la requête courante : conditions, champs, etc.

Si vous ne souhaitez pas que l’opération de recherche commence (par rapport à une décision liée aux options de $query), retournez false. Autrement, retournez la variable $query éventuellement modifiée, ou tout ce que vous souhaitez voir passé à la méthode find() ou ses équivalents.

Vous pouvez utiliser cette méthode de callback pour restreindre les opérations de recherche en se basant sur le rôle de l’utilisateur, ou prendre des décisions sur la politique de mise en cache en fonction de la charge actuelle.

afterFind¶

afterFind(array $results, boolean $primary = false)

Utilisez cette méthode de callback pour modifier les résultats qui ont été retournés par une opération de recherche, ou pour effectuer toute logique post-recherche. Le paramètre $results passé à cette méthode contient les résultats retournés par l’opération find() du model, càd quelque chose comme:

$results = array(
    0 => array(
        'NomModel' => array(
            'champ1' => 'valeur1',
            'champ2' => 'valeur2',
        ),
    ),
);

La valeur de retour de ce callback doit être le résultat de l’opération de recherche (potentiellement modifié) qui a déclenché ce callback.

Le paramètre $primary indique si oui ou non le model courant est le model d’où la requête provient en tant qu’association ou non. Si un model est requêté en tant qu’association, le format de $results peut différer; à la place du résultat, que vous auriez normalement obtenu à partir d’une opération find, vous obtiendriez peut-être ceci:

$results = array(
    'champ1' => 'valeur1',
    'champ2' => 'valeur2'
);

Ci-dessous un exemple de la manière dont afterfind peut être utilisée pour formater des dates:

public function afterFind($results, $primary = false) {
    foreach ($results as $key => $val) {
        if (isset($val['Event']['begindate'])) {
            $results[$key]['Event']['begindate'] = $this->dateFormatAfterFind(
                $val['Event']['begindate']
            );
        }
    }
    return $results;
}

public function dateFormatAfterFind($dateString) {
    return date('d-m-Y', strtotime($dateString));
}

beforeValidate¶

beforeValidate(array $options = array())

Utilisez ce rappel pour modifier les données du model avant qu’elles ne soient validées ou pour modifier les règles de validation si nécessaire. Cette fonction doit aussi retourner true, sinon l’exécution du save() courant sera annulée.

afterValidate¶

afterValidate()

Appelée après que la donnée a été vérifiée pour les erreurs. Utilisez ce callback pour lancer un nettoyage de données ou préparer des données si besoin.

beforeSave¶

beforeSave(array $options = array())

Placez toute logique de pré-enregistrement dans cette fonction. Cette fonction s’exécute immédiatement après que les données du model ont été validées avec succès, mais juste avant que les données ne soient sauvegardées. Cette fonction devrait toujours retourner true si voulez que l’opération d’enregistrement se poursuive.

Ce callback est particulièrement pratique, pour toute logique de manipulation des données qui nécessite de se produire avant que vos données ne soient stockées. Si votre moteur de stockage nécessite un format spécifique pour les dates, accédez-y par $this->data et modifiez-les.

Ci-dessous un exemple montrant comment beforeSave peut-être utilisée pour la conversion de date. Le code de l’exemple est utilisé pour une application qui a une date de début, au format YYYY-MM-DD dans la base de données et au format DD-MM-YYYY dans l’affichage de l’application. Bien sûr, ceci peut être très facilement modifié. Utilisez le code ci-dessous dans le model approprié.

public function beforeSave($options = array()) {
    if (!empty($this->data['Event']['begindate']) &&
        !empty($this->data['Event']['enddate'])
    ) {

        $this->data['Event']['begindate'] = $this->dateFormatBeforeSave(
            $this->data['Event']['begindate']
        );
        $this->data['Event']['enddate'] = $this->dateFormatBeforeSave(
            $this->data['Event']['enddate']
        );
    }
    return true;
}

public function dateFormatBeforeSave($dateString) {
    return date('Y-m-d', strtotime($dateString));
}

afterSave¶

afterSave(boolean $created, array $options = array())

Si vous avez besoin d’exécuter de la logique juste après chaque opération de sauvegarde, placez-la dans cette méthode de rappel. Les données sauvegardées seront disponibles dans $this->data.

La valeur de $created sera true si un nouvel objet a été créé (plutôt qu’un objet mis à jour).

Le tableau $options est le même que celui passé dans Model::save().

beforeDelete¶

beforeDelete(boolean $cascade = true)

Placez dans cette fonction, toute logique de pré-suppression. Cette fonction doit retourner true si vous voulez que la suppression continue et false si vous voulez l’annuler.

La valeur de $cascade sera true, pour que les enregistrements qui dépendent de cet enregistrement soient aussi supprimés.

// en utilisant app/Model/ProduitCategory.php
// Dans l'exemple suivant, ne laissez pas une catégorie être supprimée si
// elle contient des produits. Un appel de $this->Produit->delete($id) de
// ProduitsController.php a défini $this->id. En admettant que
// 'ProduitCategory hasMany Produit', nous pouvons accéder à $this->Produit
// dans le model.
public function beforeDelete() {
    $count = $this->Product->find("count", array(
        "conditions" => array("produit_category_id" => $this->id)
    ));
    if ($count == 0) {
        return true;
    }
    return false;
}

afterDelete¶

afterDelete()

Placez dans cette méthode de rappel, toute logique que vous souhaitez exécuter après chaque suppression:

// peut-être pour supprimer un enregistrement de la base de données,
// vous pouvez aussi supprimer un fichier associé
public function afterDelete() {
    $file = new File($this->data['SomeModel']['file_path']);
    $file->delete();
}

onError¶

onError()

Appelée si il se produit quelque problème que ce soit.