2-5-migration-guide.rst

2.5 Guide de Migration

CakePHP 2.5 est une mise à jour complète à partir de l'API de 2.4. Cette page souligne les changements et améliorations faits dans 2.5.

Cache

• Un nouvel adaptateur a été ajouté pour Memcached. Ce nouvel adaptateur utilise ext/memcached au lieu de ext/memcache. Il permet d'améliorer la performance et les connexions persistentes partagées.
• L'adaptateur Memcache est maintenant déprécié en faveur de Memcached.
• :php:meth:`Cache::remember()` a été ajoutée.
• :php:meth:`Cache::config()` accepte maintenant la clé database lors de l'utilisation avec :php:class:`RedisEngine` afin d'utiliser un certain nombre de base de données pas par défaut.

Console

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

• :doc:`CompletionShell </console-and-shells/completion-shell>` 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.

Controller

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

• :php:class:`CookieComponent` peut utiliser le nouveau chiffrement AES-256 offert par :php:class:`Security`. Vous pouvez activer ceci en appelant :php:meth:`CookieComponent::type()` avec 'aes'.

RequestHandlerComponent

• :php:meth:`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.

Core

App

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

CakePlugin

• :php:meth:`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.

Event

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.

I18n

• La classe :php:class:`I18n` a de nombreuses nouvelles constantes. Ces constantes vous permettent de remplacer les hardcoded integers avec des valeurs lisibles par exemple : I18n::LC_MESSAGES.

Model

• Les nombres unsigned sont maintenant supportés par les sources de données qui les fournissent (MySQL). Vous pouvez définir l'option unsigned à true dans vos fichiers schema/fixture pour commencer à utiliser cette fonctionnalité.
• Les Jointures inclues dans les requêtes sont maintenant ajoutées après que les jointures des associations sont ajoutées. Cela facilite la jointure des tables qui dépendent d'associations générées.

Network

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

• :php:meth:`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 :php:meth:`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.

Routing

Router

• :php:meth:`Router::mapResources()` accepte la clé connectOptions dans l'argument $options. Regardez :ref:`custom-rest-routing` pour plus de détails.

Utility

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

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

File

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

Folder

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

Security

• :php:meth:`Security::encrypt()` et :php:meth:`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 :php:meth:`Validation::inList()` et :php:meth:`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 :php:meth:`Validation::mimeType()` peut aussi être une chaîne regex. Aussi maintenant quand $mimeTypes est un tableau ses valeurs sont en minuscule.

Logging

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.

Error

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.

Testing

• Les fichiers de fixture peuvent maintenant être placés dans des sous-répertoires. Vous pouvez utiliser les fixtures dans les sous-répertoires en incluant le nom du répertoire après le .. Par exemple, app.my_dir/article va charger App/Test/Fixture/my_dir/ArticleFixture. On notera que le répertoire de fixture ne sera pas inflecté ou modifié dans tous les cas.
• Les Fixtures peuvent maintenant définir $canUseMemory à false pour désactiver le moteur de stockage de la mémoire utilisée dans MySQL.

View

View

• $title_for_layout est déprécié. Utilisez $this->fetch('title'); et $this->assign('title', 'your-page-title'); à la place.
• :php:meth:`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.
• :php:meth:`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.
• :php:meth:`FormHelper::end()` et :php:meth:`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.
• :php:meth:`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

• :php:meth:`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.