2.5 Guide de Migration¶

SchemaShell¶

• Les sous-commandes create et update ont maintenant une option yes. L’option yes vous permet de passer les différentes questions interactives forçant ainsi une réponse à yes.

CompletionShell¶

• CompletionShell a été ajoutée. Il a pour objectif d’aider à la création de librairies autocompletion pour les variables d’environnement de shell comme bash, ou zsh. Aucun script shell n’est inclu dans CakePHP, mais les outils sous-jacents sont maintenant disponibles.

AuthComponent¶

• loggedIn() est maintenant dépréciée et sera retirée dans 3.0.

• Lors de l’utilisation de ajaxLogin, AuthComponent va retourner un code de statut 403 au lieu de 200 quand l’utilisateur n’est pas authentifié.

CookieComponent¶

• CookieComponent peut utiliser le nouveau chiffrement AES-256 offert par Security. Vous pouvez activer ceci en appelant CookieComponent::type() avec “aes”.

RequestHandlerComponent¶

• RequestHandlerComponent::renderAs() ne définit plus Controller::$ext. Cela posait des problèmes lors de l’utilisation d’une extension autre que celle par défaut pour les vues.

AclComponent¶

• Les échecs de vérification de noeud ACL sont maintenant directement mis dans les logs. L’appel de trigger_error() a été retiré.

Scaffold¶

• Le scaffold dynamique est maintenant déprécié et sera retiré dans 3.0.

App¶

• App::pluginPath() a été dépréciée. CakePlugin::path() doit être utilisé à la place.

CakePlugin¶

• CakePlugin::loadAll() fusionne maintenant les options par défaut et celles spécifiques au plugin comme on peut s’y attendre intuitivement. Regardez les cas de test pour plus de détails.

EventManager¶

Les Events liés au gestionnaire global sont maintenant déclenchés dans l’ordre de priorité des events liés au gestionnaire local. Ceci peut entraîner le déclenchement des listeners dans un ordre différent par rapport aux versions précédentes. Au lieu d’avoir des listeners globaux attrapés, et ensuite instancier les listeners étant déclenchés plus tard, les deux ensembles de listeners sont combinés en une liste de listeners basé sur leurs priorités et ensuite déclenchés en un ensemble. Les listeners globaux d’une prioriété donnée sont toujours déclenchés avant l’instanciation des listeners.

CakeEmail¶

• Les adresses Email dans CakeEmail ne sont pas validées avec filter_var par défaut. Cela assouplit les règles d’addresse email en autorisant les addresses d’email interne comme root@localhost par exemple.

• Vous pouvez maintenant spécifier la clé layout dans la config d’email sans avoir à spécifier la clé template.

CakeRequest¶

• CakeRequest::addDetector() supporte maintenant options qui accepte un tableau des options valides lors de la création de paramètre basé sur les detecteurs.

• CakeRequest::onlyAllow() a été dépréciée. En remplacement, une nouvelle méthode nommée CakeRequest::allowMethod() a été ajoutée avec une fonctionnalité identique. Le nouveau nom de la méthode est plus intuitif et transmet mieux ce que la méthode fait.

CakeSession¶

• Sessions ne seront pas démarrées si elles sont connues pour être vides. Si le cookie de session ne peut être trouvé, une session ne sera pas démarrée à moins qu’une opération d’écriture ne soit faite.

Router¶

• Router::mapResources() accepte la clé connectOptions dans l’argument $options. Regardez Routing REST Personnalisé pour plus de détails.

Debugger¶

• Debugger::dump() et Debugger::log() supportent un paramètre $depth. Ce nouveau paramètre facilite la sortie de structures d’objet imbriquée plus profonde.

Hash¶

• Hash::insert() et Hash::remove() supportent maintenant les expressions de matcher dans les selecteurs de chemin.

File¶

• File::replaceText() a été ajoutée. Cette méthode vous permet de facilement remplacer le texte en un fichier en utilisant str_replace.

Folder¶

• Folder::addPathElement() accepte maintenant un tableau pour le paramètre $element.

Security¶

• Security::encrypt() et Security::decrypt() ont été ajoutées. Ces méthodes montrent une API très simple pour accéder au chiffrement symétrique AES-256. Ils doivent être utilisés en faveur des méthodes cipher() et rijndael().

Validation¶

• Le troisième paramètre pour Validation::inList() et Validation::multiple() a été modifié de $strict en $caseInsensitive. $strict a été retiré puisqu’il ne fonctionnait pas correctement et pouvait être facilement contourné. Vous pouvez maintenant définir ce paramètre à true pour des comparaisons non sensibles à la casse. Par défaut, c’est à false et cela ca comparer la valeur et lister la casse sensible comme avant.

• Le paramètre $mimeTypes de Validation::mimeType() peut aussi être une chaîne regex. Aussi maintenant quand $mimeTypes est un tableau ses valeurs sont en minuscule.

FileLog¶

• CakeLog ne s’auto-configure plus tout seul. Au final, tous les fichiers de log ne seront plus auto-créés si aucun flux n’est écouté. Assurez-vous que vous avez au moins un moteur par défaut configuré si vous voulez écouter tous les types et les niveaux.

ExceptionRenderer¶

ExceptionRenderer remplit maintenant les tempplates d’erreur avec les variables « code », « message » et « url ». « name » a été déprécié mais est toujours disponible. Cela uniformise les variables à travers tous les templates d’erreur.

View¶

• $title_for_layout est déprécié. Utilisez $this->fetch('title'); et $this->assign('title', 'your-page-title'); à la place.

• View::get() accepte maintenant un deuxième argument pour fournir une valeur par défaut.

FormHelper¶

• FormHelper va maintenant générer les inputs de fichier pour les types de champ binary.

• FormHelper::end() a eu un deuxième paramètre ajouté. Ce paramètre vous laisse passer les propriétés supplémentaires aux champs utilisés pour sécuriser les formulaires avec SecurityComponent.

• FormHelper::end() et FormHelper::secure() vous permettent de passer des options supplémentaires qui sont changées en attributs sur les inputs cachés générés. C’est utile quand vous voulez utiliser l’attribut HTML5 form.

• FormHelper::postLink() vous permet maintenant de faire un tampon de la balise de formulaire généré au lieu de la retourner avec le lien. Ceci permet d’éviter les balises de formulaire imbriquées.

PaginationHelper¶

• PaginatorHelper::sort() a maintenant une option lock pour créer le tri des liens de pagination avec seulement la direction par défaut.

ScaffoldView¶

• Le Scaffold Dynamique est mainteanant déprécié et sera retiré dans 3.0.