2.2 Guide de Migration¶

I18N extract shell¶

• Une option a été ajoutée pour écraser les fichiers POT existant par défaut:

  ./Console/cake i18n extract --overwrite
  

Exceptions¶

• NotImplementedException a été ajouté.

Configure¶

• Configure::dump() a été ajoutée. Elle est utilisée pour rendre les données de configuration persistentes dans des stockages durables comme des fichiers. Les deux PhpReader et IniReader fonctionnent avec elle.

• Un nouveau paramètre de config “Config.timezone” est disponible que vous pouvez définir comme une chaîne de timezone d’utilisateur. Par ex, vous pouvez faire Configure::write('Config.timezone', 'Europe/Paris'). Si une méthode de la classe CakeTime est appelée avec le paramètre $timezone à null et “Config.timezone” est défini, alors la valeur de “Config.timezone” sera utilisée. Cette fonctionnalité vous permet de définir le timezone d’utilisateur juste une fois au lieu de le passer chaque fois dans les appels de fonction.

AuthComponent¶

• Les options pour les adapters définies dans AuthComponent::$authenticate accèptent maintenant une option contain. Ceci est utilisé pour définir des options de contenance pour le cas où les enregistrements de l’utilisateur sont chargés.

CookieComponent¶

• Vous pouvez maintenant crypter les valeurs de cookie avec le rijndael cipher. Ceci nécessite l’installation de l’extension mcrypt. Utiliser rijndael donne aux valeurs du cookie le cryptage réel, et est recommandé à la place de XOR cipher disponible dans les versions précédentes. Le XOR cipher est toujours le schéma par défaut de cipher pour maintenir la compatibilité avec les versions précédentes. Vous pouvez en lire plus dans la documentation Security::rijndael().

CakeEmail¶

• CakeEmail::charset() et CakeEmail::headerCharset() ont été ajoutés.

• Les encodages Japonnais légaux sont maintenant gérés correctement. ISO-2202-JP est utilisé lorsque l’encodage est ISO-2202-JP-MS qui fonctionne autour d’un nombre de questions dans les mail clients quand il s’agit des encodages CP932 et Shift_JIS.

• CakeEmail::theme() a été ajoutée.

• CakeEmail::domain() a été ajoutée. Vous pouvez utiliser cette méthode pour définir le nom de domaine utilisé lors de l’envoi de mail à partir d’un script CLI ou si vous voulez contrôler le nom d’hôte utilisé pour envoyer l’email.

• Vous pouvez maintenant définir theme et helpers dans votre classe EmailConfig.

CakeRequest¶

• CakeRequest va maintenant automatiquement décoder les corps de requête application/x-www-form-urlencoded sur les requêtes PUT et DELETE. Ces données seront disponibles dans $this->data exactement comme les données POST le sont.

Set¶

• La classe Set est maintenant dépréciée, et remplacée par la classe Hash. Set ne sera pas retiré avant 3.0.

• Set::expand() a été ajoutée.

Hash¶

La classe Hash a été ajoutée dans 2.2. Elle remplace Set en fournissant une API plus cohérente, fiable et performante pour faire plusieurs des tâches que fait Set. Regardez la page Hash pour plus de détails.

CakeTime¶

• Le paramètre $userOffset a été remplacé par le paramètre $timezone dans toutes les fonctions pertinentes. Donc au lieu de la sortie numérique, vous pouvez maintenant passer une chaîne timezone ou un objet DateTimeZone. Passer les sorties numériques pour le paramètre $timezone est toujours possible pour une compatibilité rétro-active.

• CakeTime::timeAgoInWords() a l’option accuracy ajoutée. Cette option vous permet de spécifier la précision que doivent avoir les times formatés.

• Nouvelles méthodes ajoutées:

  • CakeTime::toServer()

  • CakeTime::timezone()

  • CakeTime::listTimezones()

• Le paramètre $dateString dans toutes les méthodes accèptent maintenant un objet DateTime.

FormHelper¶

• FormHelper gère maintenant mieux l’ajout des classes requises aux entrées. Il honore maintenant la clé on.

• FormHelper::radio() supporte maintenant empty qui fonctionne de la même façon que l’option empty de select().

• Ajout de FormHelper::inputDefaults() pour définir les propriétés habituelles pour chacune de ses entrées générées par le Helper.

TimeHelper¶

• Depuis 2.1, TimeHelper utilise la classe CakeTime pour toutes ses méthodes pertinentes. Le paramètre $userOffset a été remplacé par le paramètre $timezone.

• TimeHelper::timeAgoInWords() a l’option element ajoutée. Cela vous permet de spécifier un élément HTML pour entourer le time formaté.

HtmlHelper¶

• HtmlHelper::tableHeaders() supporte maintenant la configuration des attributs par cellule de table.

Dispatcher¶

• Les écouteurs d’Event peuvent maintenant être attachés aux appels du dispatcher, ceux-ci vont avoir la capacité de changer l’information de requête ou la réponse avant qu’elle soit envoyée au client. Vérifiez la documentation complète pour ces nouvelles fonctionnalités dans Filtres du Dispatcher

• Avec l’ajout de Filtres du Dispatcher vous aurez besoin de mettre à jour app/Config/bootstrap.php. Regardez Etapes requises pour mettre à jour.

Router¶

• Router::setExtensions() a été ajoutée. Avec la nouvelle méthode, vous pouvez maintenant ajouter plus d’extensions à parser, par exemple dans un fichier de routes de plugin.

Redis Engine¶

Un nouveau moteur de cache a été ajouté en utilisant phpredis extension il est configuré de la même manière que le moteur Memcache.

Cache groups¶

Il est maintenant possible de tagger ou de labeliser les clés de cache sous les groupes. Cela facilite pour supprimer en masse les entrées associées mise en cache avec le même label. Les groupes sont déclarés au moment de la configuration quand on crée le moteur de cache:

Cache::config(array(
    'engine' => 'Redis',
    ...
    'groups' => array('post', 'comment', 'user')
));

Vous pouvez avoir autant de groupes que vous le souhaitez, mais gardez à l’esprit qu’ils ne peuvent pas être modifiés dynamiquement.

La méthode de la classe Cache::clearGroup() a été ajoutée. Elle prende le nom du groupe et supprime toutes les entrées labelisées avec la même chaîne.