Guide de migration vers la version 4.2¶

L”Exception::responseHeader() est maintenant dépréciée. Les utilisateurs doivent utiliser HttpException::setHeaders() pour définir les en-têtes de la réponse HTTP. Les exceptions d’applications et de plugins qui définissent des en-têtes de réponse devraient être mises à jour pour hériter de HttpException.

Cake\Core\Exception\Exception a été renommée en Cake\Core\Exception\CakeException.

Cake\Database\Exception a été renommée en Cake\Database\Exception\DatabaseException.

TableLocator::allowFallbackClass() a été ajoutée. Cette méthode vous permet de désactiver les classes de table fallback générées automatiquement. La désactivation est actuellement une option, mais deviendra à l’avenir le comportement par défaut.

ORM\Behavior::getTable() a été dépréciée. Utilisez table() à la place. Ce changement marque une différence des noms de méthodes par rapport à ORM\Table, car les valeurs de retour de ces méthodes sont différentes.

Collection::groupBy() et Collection::indexBy() lèvent maintenant une exception quand le chemin n’existe pas ou quand le chemin contient une valeur null. Les utilisateurs qui ont besoin de null devraient utiliser un callback pour renvoyer plutôt une valeur par défaut.

Controller::$components a été marquée protected. Elle était auparavant documentée comme protected. Cela ne devrait pas impacter la plupart des codes d’application puisque les implémentations peuvent augmenter la visibilité à public.

FlashComponent::set() définit maintenant l’option element à error par défaut quand elle est utilisée avec une instance Exception.

Le TimeType sérialisera désormais correctement les valeurs dans le format H:i. Auparavant ces valeurs étaient castées en null après validation.

Le pilote Sqlserver réessayera de se connecter après une erreur « Azure Sql Database paused ».

Validation::time() rejettera désormais une chaîne de texte s’il manque les minutes. Auparavant, elle acceptait des chiffres correspondant uniquement aux heures alors que la documentation de l’API disait que les minutes étaient exigées.

La dépendance envers le paquet Aura.Intl a été supprimée car il n’est plus maintenu. Si votre application/plugin a des traducteurs génériques (custom translation loaders) alors elle doit retourner désormais une instance Cake\I18n\Package à la place de Aura\Intl\Package. Les deux classes ont des API compatibles donc vous n’avez rien besoin de changer d’autre.

Les noms de fixtures autour des UUIDs ont été consolidés (UuidItemsFixture, BinaryUuidItemsFixture). Si vous utilisez l’une d’entre elles, assurez-vous d’avoir mis à jour ces noms. La UuidportfoliosFixture n’était pas utilisée dans le cœur et a maintenant été retirée.

Un support expérimental pour un Injection de Dépendance a été ajouté.

ConsoleIo::comment() a été ajouté. Cette méthode formate le texte en bleu comme des commentaires dans le texte d’aide généré.

TableHelper supporte maintenant un tag de formatage <text-right>, qui aligne le contenu de la cellule par rapport au côté droit plutôt que le gauche.

Cake\Http\Middleware\SessionCsrfProtectionMiddleware a été ajouté. Plutôt que de stocker les jetons CSRF dans un cookie, ce middleware stocke les jetons en session. Cela limite la portée des jetons CSRF à l’utilisateur et les relie à l’heure de la session, offrant une sécurité accrue par rapport aux jetons basés sur des cookies. Ce middleware est un substitut à CsrfProtectionMiddleware.

Les types hal+json, hal+xml, et jsonld ont été ajoutés à Response, les rendant utilisables avec withType().

Client::createFromUrl() a été ajoutée. Cette méthode peut être utilisée pour créer des clients HTTP limités à des domaines incluant une base d’adresse spécifique.

Une nouvelle classe utilitaire Cake\Http\FlashMessage a été ajoutée, dont l’instance est disponible par ServerRequest::getFlash(). La classe similaire à FlashComponent vous permet de définir des messages flash. Elle peut être particulièrement utile pour définir des messages flash depuis les middlewares.

Table::subquery() et Query::subquery() ont été ajoutées. Ces méthodes vous permettent de créer des objets qui n’ont pas d’aliasing automatique. Cela aide à réduire l’empilement et la complexité de la construction de sous-requêtes et d’expressions de tables communes.

La règle IsUnique accepte maintenant l’option allowMultipleNulls qui était disponible dans la version 3.x. Elle est désactivée par défaut, contrairement à ce qui se faisait dans la version 3.x.

EmailTrait::assertMailSubjectContains() et assertMailSubjectContainsAt() ont été ajoutées.

mockService() a été ajoutée à ConsoleIntegrationTestTrait et IntegrationTestCaseTrait. Cette méthode permet de remplacerr les services injectés avec le conteneur d”Injection de Dépendance par des Mocks ou des stubs.

Les classes de contexte incluent maintenant les options de métadonnées comment, null, and default dans les résultats de attributes().

ViewBuilder::addHelper() accepte maintenant un paramètre $options pour passer des options dans le constructeur de l’Helper.

L’option assetUrlClassName a été ajoutée à UrlHelper. Cette option vous permet de remplacer l’asset URL resolver par défaut par un autre qui soit spécifique à l’application. Cela peut être utile si vous avez besoin de personnaliser les paramètres de l’asset cache busting.