2.3 Guide de Migration¶

Constantes¶

Une application peut maintenant facilement définir CACHE et LOGS, puisqu’ils sont maintenant définis de façon conditionnelle par CakePHP.

AuthComponent¶

• Une nouvelle propriété AuthComponent::$unauthorizedRedirect a été ajoutée.

  • Par défaut la valeur est à true et l’user est redirigé à l’URL de référence lors des échecs d’authorisation.

  • Si défini à une chaîne ou un tableau, l’user est redirigé à l’URL.

  • Si défini à false, une exception ForbiddenException est lancée à la place de la redirection.

• Un nouvel adaptateur d’authenticate a été ajouté pour le support de hash blowfish/bcrypt hashed des mots de passe. Vous pouvez maintenant utiliser Blowfish dans votre tableau $authenticate pour permettre aux mots de passe bcrypt d’être utilisés.

• AuthComponent::redirect() a été dépréciée. Utilisez AuthComponent::redirectUrl() à la place.

PaginatorComponent¶

• PaginatorComponent supporte maintenant l’option findType. Ceci peut être utilisé pour spécifier quelle méthode find vous voulez utiliser pour la pagination. C’est un peu plus facile de manager et de définir que l’index 0ième.

• PaginatorComponent lance maintenant NotFoundException quand vous essayez d’accéder à une page qui n’est pas correct (par ex la page requêtée est supérieure au total du compte de page).

SecurityComponent¶

• SecurityComponent supporte maintenant l’option unlockedActions. Ceci peut être utilisé pour désactiver toutes les vérifications de sécurité pour toute action listée dans cette option.

RequestHandlerComponent¶

• RequestHandlerComponent::viewClassMap() a été ajouté, qui est utilisé pour mapper un type vers le nom de classe de la vue. Vous pouvez ajouter $settings['viewClassMap'] pour configurer automatiquement la viewClass correcte basée sur le type extension/content.

CookieComponent¶

• CookieComponent::check() a été ajoutée. Cette méthode fonctionne de la même façon que CakeSession::check().

L10n¶

• nld est maintenant la locale par défaut pour Dutch comme spécifié par ISO 639-3 et dut pour ses alias. Les dossiers locale ont été ajustés pour cela (from /Locale/dut/ to /Locale/nld/).

• Albanian est maintenant sqi, le Basque est maintenant eus, le Chinese est maintentant zho, Tibetan est maintenant bod, Czech est maintenant ces, Farsi est maitenant fas, French est maitenant fra, Icelandic est maitenant isl, Macedonian est maitenant mkd, Malaysian est maitenant msa, Romanian est maitenant ron, Serbian est maitenant srp et le Slovak est maitenant slk. Les dossiers locale correspondant ont été aussi ajustés.

CakePlugin¶

• CakePlugin::load() peut maintenant prendre une nouvelle option ignoreMissing. Le configurer à true va empêcher les erreurs d’inclusion du fichier quand vous essayez de charger les routes ou le bootstrap, mais qu’ils n’existent pas pour un plugin. Alors essentiellement, vous pouvez maintenant utiliser la déclaration suivante qui va charger tous les plugins et leurs routes et bootstrap quelque soit le plugin trouvé:: CakePlugin::loadAll(array(array('routes' => true, 'bootstrap' => true, 'ignoreMissing' => true)))

Configure¶

• Configure::check() a été ajoutée. Cette méthode fonctionne de la manière que CakeSession::check().

• ConfigReaderInterface::dump() a été ajoutée. Merci de vous assurer que tout lecteur personnalisé que vous avez a maintenant une méthode dump() inplementée.

• Le paramètre $key de IniReader::dump() supporte maintenant les clés comme PluginName.keyname similaire à PhpReader::dump().

Exceptions¶

• CakeBaseException a été ajouté, auquel toutes les Exceptions du coeur étendent. La classe d’Exception de base introduit aussi la méthode responseHeader() qui peut être appelée sur les instances d’Exception créées pour ajouter les headers à la réponse, puisque les Exceptions ne réutilisent pas toute instance de réponse.

Models¶

• Model::find('list') définit maintenant recursive basé sur le containment depth max ou la valeur récursive. Quand la liste est utilisée avec ContainableBehavior.

• Model::find('first') va maintenant retourner un tableau vide quand aucun enregistrement n’est trouvé.

Validation¶

• Les méthodes de manque pour les validations vont toujours maintenant attraper les erreurs au lieu de le faire seulement en mode développement.

SmtpTransport¶

• Le support TLS/SSL a été ajouté pour les connexions SMTP.

CakeRequest¶

• CakeRequest::onlyAllow() a été ajoutée.

• CakeRequest::query() a été ajoutée.

CakeResponse¶

• CakeResponse::file() a été ajoutée.

• Les types de contenu application/javascript, application/xml, application/rss+xml envoient maitntenant aussi le charset de l’application.

CakeEmail¶

• L’option contentDisposition a été ajoutée à CakeEmail::attachments(). Cela vous permet de désactiver le header Content-Disposition ajouté aux fichiers joints.

HttpSocket¶

• HttpSocket vérifie maintenant les certificats SSL par défaut. Si vous utilisez les certificats signés-soi-même ou si vous vous connectez à travers des proxies, vous avez besoin d’utiliser quelques unes des options pour augmenter ce comportement. Regardez Gérer les certificats SSL pour plus d’informations.

• HttpResponse a été renommée en HttpSocketResponse. Ceci évite un problème commun avec l’extension HTTP PECL. Il y a une classe HttpResponse fournie ainsi que pour des raisons de compatibilité.

Router¶

• Support pour tel:, sms: ont été ajoutés à Router::url().

Layout¶

• Le doctype pour les fichiers de layout dans le dossier app et les templates de bake dans le package cake a été changé de XHTML en HTML5.

FormHelper¶

• FormHelper::select() accèpte maintenant une liste de valeurs dans l’attribut disabled. Combiné avec 'multiple' => 'checkbox', cela vous permet de fournir une liste de valeurs que vous voulez désactiver.

• FormHelper::postLink() accèpte maintenant une clé method. Cela vous permet de créer des formulaires en lien en utilisant d’autres méthodes HTTP que POST.

• Lors de la création d’inputs avec FormHelper::input(), vous pouvez maintenant définir l’option errorMessage à false. Ceci va désactiver l’affichage de message erreur, mais laisse les noms de classe d’erreur intact.

• Le FormHelper ajoute aussi l’attribut HTML5 required à vos elements d’input basé sur les règles de validation pour un champ. Si vous avez un bouton « Cancel » dans votre formulaire va soumettre le formulaire puis vous devriez ajouter 'formnovalidate' => true à vos options de bouton pour empêcher le déclenchement de la validation dans le HTML. Vous pouvez aussi empêcher le déclenchement de la validation pour l’ensemble du formulaire en ajoutant 'novalidate' => true dans les options de FormHelper::create().

• FormHelper::input() génère maintenant les elements d’input de type tel et email basé sur les noms de champ si l’option type n’est pas spécifiée.

HtmlHelper¶

• HtmlHelper::getCrumbList() a maintenant les options separator, firstClass et lastClass. Celles-ci vous permettent de mieux contrôler le HTML que cette méthode génère.

TextHelper¶

• TextHelper::tail() a été ajoutée pour tronquer le texte en commençant par la fin.

• ending dans TextHelper::truncate() est déprécié en faveur de ellipsis.

PaginatorHelper¶

• PaginatorHelper::numbers() a maintenant une nouvelle option currentTag pour permettre de specifier une balise supplémentaire pour entourer le nombre de page courant.

• Pour les méthodes: PaginatorHelper::prev() et PaginatorHelper::next(), il est aussi maintenant possible de définir l’option tag à false pour désactiver le wrapper. Aussi une nouvelle option disabledTag a été ajoutée pour ces deux nouvelles méthodes.

CakeNumber¶

• CakeNumber::fromReadableSize() a été ajoutée.

• CakeNumber::formatDelta() a été ajoutée.

• CakeNumber::defaultCurrency() a été ajoutée.

Folder¶

• Folder::copy() et Folder::move() supportent maintenant la possiblité de fusionner les répertoires de cible et de source en plus de sauter le suivant/écrire par dessus.

String¶

• String::tail() a été ajouté pour tronquer le texte en commençant par la fin.

• ending dans String::truncate() est déprécié en faveur de ellipsis.

Debugger¶

• Debugger::exportVar() sort maintenant des propriétés private et protected dans PHP >= 5.3.0.

Security¶

• Le support pour bcrypt a été ajouté. Regardez la documentation de Security::hash() pour plus d’informations sur la façon d’utiliser bcrypt.

Validation¶

• Validation::fileSize() a été ajoutée.

ObjectCollection¶

• ObjectCollection::attached() a été dépréciée en faveur d’une nouvelle méthode ObjectCollection::loaded(). Ceci uniformise l’accès à ObjectCollection puisque load()/unload() remplace déjà attach()/detach().