3.5 Guide de Migration¶

Dépréciation des Méthodes Get / Set combinées¶

Dans le passé, CakePHP a utilisé des méthodes “modal” qui proposaient à la fois un mode get et un mode set. Ces méthodes compliquent l’auto-complétion des IDE et notre capacité à ajouter des return type stricts dans le futur. Pour ces raisons, ces méthodes get / set combinées sont scindées en méthodes get et set séparées.

La liste suivante regroupe les méthodes dépréciées et qu’il faudra remplacer par des méthodes getX() et setX() :

Cake\Cache\Cache

• config()

• registry()

Cake\Console\Shell

• io()

Cake\Console\ConsoleIo

• outputAs()

Cake\Console\ConsoleOutput

• outputAs()

Cake\Database\Connection

• logger()

Cake\Database\TypedResultInterface

• returnType()

Cake\Database\TypedResultTrait

• returnType()

Cake\Database\Log\LoggingStatement

• logger()

Cake\Datasource\ModelAwareTrait

• modelType()

Cake\Database\Query

• la partie « getter » de valueBinder() (maintenant getValueBinder())

Cake\Database\Schema\TableSchema

• columnType()

Cake\Datasource\QueryTrait

• la partie « getter » de eagerLoaded() (maintenant isEagerLoaded())

• eagerLoaded() (maintenant isEagerLoaded())

Cake\Event\EventDispatcherInterface

• eventManager()

Cake\Event\EventDispatcherTrait

• eventManager()

Cake\Error\Debugger

• outputAs() (maintenant getOutputFormat() / setOutputFormat())

Cake\Http\ServerRequest

• env() (maintenant getEnv() / withEnv())

Cake\I18n\I18n

• locale()

• translator()

• defaultLocale()

• defaultFormatter()

Cake\ORM\Association\BelongsToMany

• sort()

Cake\ORM\LocatorAwareTrait

• tableLocator()

Cake\ORM\EntityTrait

• invalid() (maintenant getInvalid(), setInvalid(), setInvalidField(), maintenant getInvalidField())

Cake\ORM\Table

• validator()

Cake\Routing\RouteBuilder

• extensions()

• routeClass()

Cake\Routing\RouteCollection

• extensions()

Cake\TestSuite\TestFixture

• schema()

Cake\Utility\Security

• salt()

Cake\View\View

• template()

• layout()

• theme()

• templatePath()

• layoutPath()

• autoLayout() (maintenant isAutoLayoutEnabled() / enableAutoLayout())

Middleware sur Scopes¶

Les middlewares peuvent maintenant être appliqués conditionnellement à des routes sur des URL “scopées”. Cela vous permet de construire des stacks de middlewares spécifiques pour différentes parties de votre application sans avoir à faire des tests sur l’URL dans le code de vos middlewares. Plus d’informations dans la section Connecter des Middlewares à un scope.

Nouveau Lanceur de Console¶

3.5.0 ajoute Cake\Console\CommandRunner. Cette classe, avec Cake\Console\CommandCollection, intègre l’environnement CLI dans la nouvelle classe Application. Les classes Application peuvent maintenant implémenter un hook console() qui permet d’avoir un contrôle complet sur les commandes CLI exposées, comment elles sont nommées et comment les shells récupèrent leurs dépendances. Adopter cette nouvelle classe nécessite que vous remplaciez le contenu de votre fichier bin/cake.php par le fichier suivant.

Fallbacks pour les Moteurs de Cache¶

Les moteurs de cache peuvent maintenant être configurés avec une clé fallback qui permet de définir une configuration de cache sur laquelle se rabattre si le moteur était mal configuré ou indisponible. Reportez-vous à la section Configurer un Fallback de Cache pour plus d’informations sur la configuration de “fallbacks” pour vos configurations de cache.

Support de dotenv au squelette d’Application¶

Le squelette d’application possède maintenant une intégration « dotenv », facilitant l’utilisation de variables d’environnement pour configurer votre application. Référez-vous à la section Variables d’Environnement pour plus d’informations.

Console Integration Testing¶

La classe Cake\TestSuite\ConsoleIntegrationTestCase a été ajoutée pour faciliter les tests d’intégration des applications console. Pour plus d’informations rendez-vous à la section Tests d’Intégration de la Console. Cette classe de test est compatible avec le dispatcher de shell actuel mais aussi avec le nouveau Cake\Console\CommandRunner.

Collection¶

• Cake\Collection\Collection::avg() a été ajoutée.

• Cake\Collection\Collection::median() a été ajoutée.

Core¶

• Cake\Core\ObjectRegistry implémente maintenant les interfaces Countable et IteratorAggregate.

Console¶

• Cake\Console\ConsoleOptionParser::setHelpAlias() a été ajoutée. Cette méthode permet de définir le nom de la commande à utiliser lors de l’affichage des aides. Par défaut, la valeur est cake

• Cake\Console\CommandRunnner a été ajoutée en remplacement de Cake\Console\ShellDispatcher.

• Cake\Console\CommandCollection a été ajouté afin de fournir une interface pour que les applications puissent définir les outils en ligne de commande qu’elles offrent.

Database¶

• Une nouvelle option mask pour le driver SQLite a été ajoutée. Cette option vous permet de définir les droits sur le fichier de la base SQLite quand il est créé.

Datasource¶

• Cake\Datasource\SchemaInterface a été ajoutée.

• De nouveaux types abstraits ont été définis pour smallinteger et tinyinteger. Les colonnes existantes en SMALLINT and TINYINT seront maintenant introspectées via ces nouveaux types abstraits. Les colonnes TINYINT(1) continueront à être traitées comme des booléen dans MySQL.

• Cake\Datasource\PaginatorInterface a été ajoutée. Le PaginatorComponent utilise maintenant cette interface pour intéragir avec les paginators. Cela permet à des implémentations ORM-like d’être paginées par le component.

• Cake\Datasource\Paginator a été ajouté pour paginer les instances des requêtes ORM/Database.

Event¶

• Les méthodes Cake\Event\EventManager::on() et off() peuvent maintenant être chainées ce qui rend plus simple la définition de plusieurs événements à la fois.

Http¶

• Les classes Cookie & CookieCollection ont été ajoutées. Ces classes vous permettent de travailler avec les cookies de manière orientée objet et sont disponibles dans Cake\Http\ServerRequest, Cake\Http\Response, et Cake\Http\Client\Response. Référez-vous aux sections Cookies et Définir des Cookies pour plus d’informations.

• Un nouveau middleware a été ajouté pour permettre d’appliquer des headers de sécurité plus facilement. Référez-vous à Ajouter des Headers de Sécurité pour plus d’informations.

• Un nouveau middleware a été ajouté pour chiffrer de manière transparente les données de cookie. Référez-vous à Middleware de Gestion de Cookies Chiffrés pour plus d’informations.

• Un nouveau middleware a été ajouté pour permettre une protection CSRF plus simple. Référez-vous à Middleware Cross Site Request Forgery (CSRF) pour plus d’informations.

• Cake\Http\Client::addCookie() a été ajoutée pour faciliter l’ajoute de cookies à une instance d’un client.

InstanceConfigTrait¶

• InstanceConfigTrait::getConfig() accepte maintenant un second paramètre $default. Si aucune valeur n’est disponible pour la $key spécifiée, la valeur de $default sera retournée.

ORM¶

• Cake\ORM\Query::contain() vous permet de l’appeler sans le tableau quand vous faites un contain() sur une seule association. contain('Comments', function () { ... }); fonctionnera maintenant. Cela rend contain() plus cohérent avec d’autres méthodes d’eagerloading comme leftJoinWith() et matching().

Routing¶

• Cake\Routing\Router::reverseToArray() a été ajoutée. Cette méthode vous permet de convertir des objets de requête en tableau qui peuvent être utilisés pour générer des URL sous forme de chaîne.

• Cake\Routing\RouteBuilder::resources() s’est vue ajouter une option path. Cette option vous permet de faire en sorte que le chemin de la ressource et le nom du controller ne correspondent pas.

• Cake\Routing\RouteBuilder a maintenant des méthodes pour créer des routes spécifiques à des méthodes HTTP comme get() et post() par exemple.

• Cake\Routing\RouteBuilder::loadPlugin() a été ajoutée.

• Cake\Routing\Route a maintenant des méthodes « fluide » (fluent interface) pour définir ses options.

TestSuite¶

• TestCase::loadFixtures() chargera maintenant toutes les fixtures si aucun argument n’est passé.

• IntegrationTestCase::head() a été ajoutée.

• IntegrationTestCase::options() a été ajoutée.

• IntegrationTestCase::disableErrorHandlerMiddleware() a été ajoutée pour faciliter le debugging des tests d’intégration.

Validation¶

• Cake\Validation\Validator::regex() a été ajoutée afin de permettre de faire de la validation par regex plus facilement.

• Cake\Validation\Validator::addDefaultProvider() a été ajoutée. Cette méthode vous permet d’injecter des providers de validation dans tous les validators créés dans votre application.

• Cake\Validation\ValidatorAwareInterface a été ajouté pour définir les méthodes implémentées par Cake\Validation\ValidatorAwareTrait.

View¶

• Cake\View\Helper\PaginatorHelper::limitControl() a été ajoutée. Cette méthode vous permet de créer un formulaire avec un select qui permet de mettre à jour la valeur « limite » d’un résultat paginé.