3.0 Guide de Migration¶

App¶

• App::pluginPath() a été retirée. Utilisez CakePlugin::path() à la place.

• App::build() a été retirée.

• App::location() a été retirée.

• App::paths() a été retirée.

• App::load() a été retirée.

• App::objects() a été retirée.

• App::RESET a été retirée.

• App::APPEND a été retirée.

• App::PREPEND a été retirée.

• App::REGISTER a été retirée.

Plugin¶

• Cake\Core\Plugin::load() ne configure pas d’autoloader à moins que vous définissiez l’option autoload à true.

• Lors du chargement des plugins, vous ne pouvez plus fournir de callable.

• Lors du chargement des plugins, vous ne pouvez plus fournir un tableau de fichiers de configuration à charger.

Configure¶

• Cake\Configure\PhpReader renommé en Cake\Core\Configure\EnginePhpConfig

• Cake\Configure\IniReader renommé en Cake\Core\Configure\EngineIniConfig

• Cake\Configure\ConfigReaderInterface renommé en Cake\Core\Configure\ConfigEngineInterface

• Cake\Core\Configure::consume() a été ajoutée.

• Cake\Core\Configure::load() attend maintenant un suffixe du nom du fichier sans extension puisque celui-ci peut venir d’un moteur. Par exemple, l’utilisation de PhpConfig utilise app pour charger app.php.

• Définir une variable $config dans un fichier PHP de config est déprécié. Cake\Core\Configure\EnginePhpConfig attend maintenant le fichier de config pour retourner un tableau.

• Un nouveau moteur de config Cake\Core\Configure\EngineJsonConfig a été ajouté.

Object¶

La classe Object a été retirée. Elle contenait au début un tas de méthodes qui étaient utilisées dans plusieurs endroits à travers le framework. Les méthodes les plus utiles qui étaient utilisées ont été extraites dans des traits. Vous pouvez utiliser Cake\Log\LogTrait pour accéder à la méthode log(). Cake\Routing\RequestActionTrait fournit requestAction().

TaskCollection Remplacée¶

Cette classe a été renommée en Cake\Console\TaskRegistry. Regardez la section sur Objets Registry pour plus d’informations sur les fonctionnalités fournies par la nouvelle classe. Vous pouvez utiliser cake upgrade rename_collections pour vous aider à mettre à niveau votre code. Les Tasks n’ont plus accès aux callbacks, puisqu’il n’y avait jamais de callbacks à utiliser.

Shell¶

• Shell::__construct() a changé. Il prend maintenant une instance de Cake\Console\ConsoleIo.

• Shell::param() a été ajoutée pour un accès pratique aux paramètre.

De plus, toutes les méthodes du shell vont être transformées en camel case lors de leur appel. Par exemple, si vous avez une méthode hello_world() dans un shell et que vous l’appelez avec bin/cake my_shell hello_world, vous devez renommer la méthode en helloWorld. Il n’y a pas de changements nécessaires dans la façon d’appeler les commandes.

ConsoleOptionParser¶

• ConsoleOptionParser::merge() a été ajoutée pour fusionner les parsers.

ConsoleInputArgument¶

• ConsoleInputArgument::isEqualTo() a été ajoutée pour comparer deux arguments.

ApiShell Retiré¶

ApiShell a été retiré puisqu’il ne fournit aucun bénéfice sur le fichier source lui-même et sur la documentation/l’API en-ligne.

SchemaShell Removed¶

SchemaShell a été retiré puisqu’il n’a jamais été une implémentation de migrations de base de données complète et de meilleurs outils comme Phinx ont émergé. Il a été remplacé par le Plugin de Migrations pour CakePHP qui permet l’utilisation de Phinx avec CakePHP.

ExtractTask¶

• bin/cake i18n extract n’inclut plus les messages de validation non traduits. Si vous voulez traduire les messages de validation, vous devez entourer ces messages dans des appels __() comme tout autre contenu.

BakeShell / TemplateTask¶

• Bake ne fait plus partie du code source du core et est remplacé par le Plugin CakePHP Bake

• Les templates de bake ont été déplacés vers src/Template/Bake.

• La syntaxe des templates Bake utilise maintenant des balises de type erb (<% %>) pour désigner le templating.

• La commande bake view a été renommée bake template.

Paramètres Nommés¶

Les paramètres nommés ont été retirés dans 3.0. Les paramètres nommés ont été ajoutés dans 1.2.0 comme un “belle” version des paramètres query strings. Alors que le bénéfice visuel est discutable, les problèmes engendrés par les paramètres nommés ne le sont pas.

Les paramètres nommés nécessitaient une gestion spéciale dans CakePHP ainsi que toute librairie PHP ou JavaScript qui avaient besoin d’interagir avec eux, puisque les paramètres nommés ne sont implémentés ou compris par aucune librairie exceptée CakePHP. La complexité supplémentaire et le code nécessaire pour supporter les paramètres nommés ne justifiaient pas leur existence, et elles ont été retirées. A la place, vous devrez utiliser les paramètres standards de query string, ou les arguments passés. Par défaut Router traitera tous les paramètres supplémentaires de Router::url() comme des arguments de query string.

Puisque beaucoup d’applications auront toujours besoin de parser des URLs entrantes contenant des paramètres nommés, Cake\Routing\Router::parseNamedParams() a été ajoutée pour permettre une rétrocompatibilité avec les URLs existantes.

RequestActionTrait¶

• Cake\Routing\RequestActionTrait::requestAction() a connu quelques changements sur des options supplémentaires:

  • options[url] est maintenant options[query].

  • options[data] est maintenant options[post].

  • Les paramètres nommés ne sont plus supportés.

Router¶

• Les paramètres nommés ont été retirés, regardez ci-dessus pour plus d’informations.

• L’option full_base a été remplacée par l’options _full.

• L’option ext a été remplacée par l’option _ext.

• Les options _scheme, _port, _host, _base, _full et _ext ont été ajoutées.

• Les chaînes URLs ne sont plus modifiées en ajoutant les noms de plugin/controller/prefix.

• La gestion de route fallback par défaut a été retirée. Si aucune route ne correspond à un paramètre défini, / sera retourné.

• Les classes de route sont responsables pour toutes les générations d’URL incluant les paramètres de query string. Cela rend les routes bien plus puissantes et flexibles.

• Les paramètres persistants ont été retirés. Ils ont été remplacés par Cake\Routing\Router::urlFilter() qui est une meilleur façon plus flexible pour changer les URLs étant routées inversement.

• La signature de Cake\Routing\Router::parseExtensions() a changé en parseExtensions(string|array $extensions = null, $merge = true). Elle ne prend plus d’arguments variables pour la spécification des extensions. Aussi, vous ne pouvez plus l’appeler sans paramètre pour parser toutes les extensions (en faisant cela, cela va retourner des extensions existantes qui sont définies). Vous avez besoin de faire une liste blanche des extensions que votre application accepte.

• Router::parseExtensions() doit être appelée avant que les routes ne soient connectées. Il ne modifie plus les routes existantes lors de son appel.

• Router::setExtensions() a été retirée. Utilisez Cake\Routing\Router::parseExtensions() à la place.

• Router::resourceMap() a été retirée.

• L’option [method] a été renommée en _method.

• La capacité pour faire correspondre les en-têtes arbitraires avec les paramètres de style [] a été retirée. Si vous avez besoin de parser/faire correspondre sur les conditions arbitraires, pensez à utiliser les classes de route personnalisées.

• Router::promote() a été retirée.

• Router::parse() va maintenant lancer une exception quand une URL ne peut pas être gérée par aucune route.

• Router::url() va maintenant lancer une exception quand aucune route ne matche un ensemble de paramètres.

• Les scopes de Routing ont été introduits. Les scopes de Routing vous permettent de garder votre fichier de routes DRY et donne au Router des indices sur la façon d’optimiser le parsing et le routing inversé des URLs.

Route¶

• CakeRoute a été renommée en Route.

• La signature de match() a changé en match($url, $context = []) Consultez Cake\Routing\Route::match() pour plus d’informations sur la nouvelle signature.

La Configuration des Filtres de Dispatcher a Changé¶

Les filtres de Dispatcher ne sont plus ajoutés à votre application en utilisant Configure. Vous les ajoutez maintenant avec Cake\Routing\DispatcherFactory. Cela signifie que si votre application utilisait Dispatcher.filters, vous devrez maintenant utiliser Cake\Routing\DispatcherFactory::add().

En plus des changements de configuration, les filtres du dispatcher ont vu leurs conventions mises à jour, et des fonctionnalités ont été ajoutées. Consultez la documentation Filtres du Dispatcher pour plus d’informations.

FilterAssetFilter¶

• Les assets des Plugin & theme gérés par AssetFilter ne sont plus lus via include, à la place ils sont traités comme de simples fichiers texte. Cela règle un certain nombre de problèmes avec les librairies JavaScript comme TinyMCE et les environnements avec short_tags activé.

• Le support pour la configuration de Asset.filter et les hooks ont été retirés. Cette fonctionnalité peut être remplacée par un plugin ou un filtre dispatcher.

Request¶

• CakeRequest a été renommé en Cake\Network\Request.

• Cake\Network\Request::port() a été ajoutée.

• Cake\Network\Request::scheme() a été ajoutée.

• Cake\Network\Request::cookie() a été ajoutée.

• Cake\Network\Request::$trustProxy a été ajoutée. Cela rend la chose plus facile pour mettre les applications CakePHP derrière les load balancers.

• Cake\Network\Request::$data n’est plus fusionnée avec la clé de données préfixés, puisque ce préfixe a été retiré.

• Cake\Network\Request::env() a été ajoutée.

• Cake\Network\Request::acceptLanguage() a été changée d’une méthode static en non static.

• Le détecteur de Request pour « mobile » a été retiré du cœur. A la place le template de app ajoute des détecteurs pour « mobile » et « tablet » en utilisant la lib MobileDetect.

• La méthode onlyAllow() a été renommée en allowMethod() et n’accepte plus « var args ». Tous les noms de méthode doivent être passés en premier argument, soit en chaîne de caractère, soit en tableau de chaînes.

Response¶

• Le mapping du mimetype text/plain en extension csv a été retiré. En conséquence, Cake\Controller\Component\RequestHandlerComponent ne définit pas l’extension en csv si l’en-tête Accept contient le mimetype text/plain ce qui était une nuisance habituelle lors de la réception d’une requête jQuery XHR.

Controller¶

• Les propriétés $helpers, $components sont maintenant fusionnées avec toutes les classes parentes, pas seulement AppController et le app controller du plugin. Les propriétés sont fusionnées de manière différente par rapport à aujourd’hui. Plutôt que d’avoir comme actuellement les configurations de toutes les classes fusionnées, la configuration définie dans la classe enfante sera utilisée. Cela signifie que si vous avez une configuration définie dans votre AppController, et quelques configurations définies dans une sous-classe, seule la configuration de la sous-classe sera utilisée.

• Controller::httpCodes() a été retirée, utilisez Cake\Network\Response::httpCodes() à la place.

• Controller::disableCache() a été retirée, utilisez Cake\Network\Response::disableCache() à la place.

• Controller::flash() a été retirée. Cette méthode était rarement utilisée dans les vraies applications et ne n’avait plus aucun intérêt.

• Controller::validate() et Controller::validationErrors() ont été retirées. Il y avait d’autres méthodes laissées depuis l’époque de 1.x, où les préoccupations des models + controllers étaient bien plus étroitement liées.

• Controller::loadModel() charge maintenant les objets table.

• La propriété Controller::$scaffold a été retirée. Le scaffolding dynamique a été retiré du cœur de CakePHP. Un plugin de scaffolding appelé CRUD se trouve ici: https://github.com/FriendsOfCake/crud

• La propriété Controller::$ext a été retirée. Vous devez maintenant étendre et surcharger la propriété View::$_ext si vous voulez utiliser une extension de fichier de view autre que celle par défaut.

• La propriété Controller::$Components a été retirée et remplacée par _components. Si vous avez besoin de charger les components à la volée, vous devez utiliser $this->loadComponent() dans votre controller.

• La signature de Cake\Controller\Controller::redirect() a été changée en Controller::redirect(string|array $url, int $status = null). Le 3ème argument $exit a été retiré. La méthode ne peut plus envoyer la réponse et sortir du script, à la place elle retourne une instance de Response avec les en-têtes appropriés définis.

• Les propriétés magiques base, webroot, here, data, action et params ont été retirées. Vous pouvez accéder à toutes ces propriétés dans $this->request à la place.

• Les méthodes préfixées avec underscore des controllers comme _someMethod() ne sont plus considérées comme des méthodes privées. Utilisez les bons mots clés de visibilité à la place. Seules les méthodes publiques peuvent être utilisées comme action de controller.

Scaffold retiré¶

Le scaffolding dynamique dans CakePHP a été retiré du cœur de CakePHP. Il était peu fréquemment utilisé, et n’avait jamais pour intention d’être utilisé en mode production. Un plugin de scaffolding appelé CRUD se trouve ici: https://github.com/FriendsOfCake/crud

ComponentCollection remplacée¶

Cette classe a été remplacée en Cake\Controller\ComponentRegistry. Regardez la section sur Objets Registry pour plus d’informations sur les fonctionnalités fournies par cette nouvelle classe. Vous pouvez utiliser cake upgrade rename_collections pour vous aider à mettre à niveau votre code.

Component¶

• La propriété _Collection est maintenant _registry. Elle contient maintenant une instance de Cake\Controller\ComponentRegistry.

• Tous les components doivent maintenant utiliser la méthode config() pour récupérer/définir la configuration.

• La configuration par défaut pour les components doit être définie dans la propriété $_defaultConfig. Cette propriété est automatiquement fusionnée avec toute configuration fournie au constructeur.

• Les options de configuration ne sont plus définies en propriété public.

• La méthode Component::initialize() n’est plus un listener d’event. A la place, c’est un hook post-constructeur comme Table::initialize() et Controller::initialize(). La nouvelle méthode Component::beforeFilter() est liée au même évènement que Component::initialize(). La méthode initialize devrait avoir la signature suivante initialize(array $config).

CookieComponent¶

• Utilise Cake\Network\Request::cookie() pour lire les données de cookie, ceci facilite les tests, et permet de définir les cookies pour ControllerTestCase.

• Les Cookies chiffrés dans les versions précédentes de CakePHP utilisant la méthode cipher() sont maintenant illisible parce que Security::cipher() a été retirée. Vous aurez besoin de re-chiffrer les cookies avec la méthode rijndael() ou aes() avant mise à jour.

• CookieComponent::type() a été retirée et remplacée par la donnée de configuration accessible avec config().

• write() ne prend plus de paramètres encryption ou expires. Ces deux-là sont maintenant gérés avec des données de config. Consultez CookieComponent pour plus d’informations.

• Le chemin pour les cookies sont maintenant par défaut le chemin de l’app plutôt que « / ».

AuthComponent¶

• Default est maintenant le hasher de mot de passe par défaut utilisé par les classes d’authentification. Si vous voulez continuer à utiliser le hashage SHA1 utilisé dans 2.x utilisez 'passwordHasher' => 'Weak' dans votre configuration d’authenticator.

• Un nouveau FallbackPasswordHasher a été ajouté pour aider les utilisateurs à migrer des vieux mots de passe d’un algorithm à un autre. Consultez la documentation d’AuthComponent pour plus d’informations.

• La classe BlowfishAuthenticate a été retirée. Utilisez juste FormAuthenticate.

• La classe BlowfishPasswordHasher a été retirée. Utilisez DefaultPasswordHasher à la place.

• La méthode loggedIn() a été retirée. Utilisez user() à la place.

• Les options de configuration ne sont plus définies en propriété public.

• Les méthodes allow() et deny() n’acceptent plus « var args ». Tous les noms de méthode ont besoin d’être passés en premier argument, soit en chaîne, soit en tableau de chaînes.

• La méthode login() a été retirée et remplacée par setUser(). Pour connecter un utilisateur, vous devez maintenant appeler identify() qui retourne les informations d’utilisateur en cas de succès d’identification et utiliser ensuite setUser() pour sauvegarder les informations de session pour la persistance au cours des différentes requêtes.

• BaseAuthenticate::_password() a été retirée. Utilisez PasswordHasher à la place.

• BaseAuthenticate::logout() a été retirée.

• AuthComponent lance maintenant deux événements``Auth.afterIdentify`` et Auth.logout respectivement après qu’un utilisateur a été identifié et avant qu’un utilisateur ne soit déconnecté. Vous pouvez définir une fonction de callback pour ces événements en retournant un tableau de mapping depuis la méthode implementedEvents() de votre classe d’authentification.

Les classes liées à ACL ont été déplacées dans un plugin séparé. Les hashers de mot de passe, l’Authentification et les fournisseurs d’Authorisation ont été déplacés vers le namespace \Cake\Auth. Vous devez aussi déplacer vos providers et les hashers dans le namespace App\Auth.

RequestHandlerComponent¶

• Les méthodes suivantes ont été retirées du component RequestHandler:: isAjax(), isFlash(), isSSL(), isPut(), isPost(), isGet(), isDelete(). Utilisez la méthode Cake\Network\Request::is() à la place avec l’argument pertinent.

• RequestHandler::setContent() a été retirée, utilisez Cake\Network\Response::type() à la place.

• RequestHandler::getReferer() a été retirée, utilisez Cake\Network\Request::referer() à la place.

• RequestHandler::getClientIP() a été retirée, utilisez Cake\Network\Request::clientIp() à la place.

• RequestHandler::mapType() a été retirée, utilisez Cake\Network\Response::mapType() à la place.

• Les options de configuration ne sont plus définies en propriété public.

SecurityComponent¶

• Les méthodes suivantes et leurs propriétés liées ont été retirées du component Security: requirePost(), requireGet(), requirePut(), requireDelete(). Utilisez Cake\Network\Request::onlyAllow() à la place.

• SecurityComponent::$disabledFields() a été retirée, utilisez SecurityComponent::$unlockedFields().

• Les fonctionnalités liées au CSRF dans SecurityComponent ont été extraites et déplacées dans un CsrfComponent séparé. Ceci vous permet d’utiliser une protection CSRF sans avoir à utiliser la prévention de falsification de formulaire.

• Les options de Configuration ne sont plus définies comme des propriétés publiques.

• Les méthodes requireAuth() et requireSecure() n’acceptent plus « var args ». Tous les noms de méthode ont besoin d’être passés en premier argument, soit en chaîne, soit en tableau de chaînes.

SessionComponent¶

• SessionComponent::setFlash() est déprécié. Vous devez utiliser FlashComponent à la place.

Error¶

Les ExceptionRenderers personnalisées doivent maintenant soit retourner un objet Cake\\Network\\Response, soit une chaîne de caractère lors du rendu des erreurs. Cela signifie que toutes les méthodes gérant des exceptions spécifiques doivent retourner une réponse ou une valeur.

ConnectionManager¶

• ConnectionManager a été déplacée dans le namespace Cake\\Datasource.

• ConnectionManager a eu les méthodes suivantes retirées:

  • sourceList

  • getSourceName

  • loadDataSource

  • enumConnectionObjects

• config() a été ajoutée et est maintenant la seule façon de configurer les connections.

• get() a été ajoutée. Elle remplace getDataSource().

• configured() a été ajoutée. Celle-ci avec config() remplace sourceList() & enumConnectionObjects() avec une API plus standard et cohérente.

• ConnectionManager::create() a été retirée. Il peut être remplacé par config($name, $config) et get($name).

Behaviors¶

• Les méthodes préfixées avec underscore des behaviors comme _someMethod() ne sont plus considérées comme des méthodes privées. Utilisez les bons mots clés à la place.

TreeBehavior¶

TreeBehavior a été complètement réécrit pour utiliser le nouvel ORM. Bien qu’il fonctionne de la même manière que dans 2.x, certaines méthodes ont été renommées ou retirées:

• TreeBehavior::children() est maintenant un finder personnalisé find('children').

• TreeBehavior::generateTreeList() est maintenant un finder personnalisé find('treeList').

• TreeBehavior::getParentNode() a été retirée.

• TreeBehavior::getPath() est maintenant un finder personnalisé find('path').

• TreeBehavior::reorder() a été retirée.

• TreeBehavior::verify() a été retirée.

TestCase¶

• _normalizePath() a été ajoutée pour permettre aux tests de comparaison de chemin de se lancer pour tous les systèmes d’exploitation selon la configuration de leur DS (\ dans Windows vs / dans UNIX, par exemple).

Les méthodes d’assertion suivantes ont été retirées puisque cela faisait longtemps qu’elles étaient dépréciées et remplacées par leurs nouvelles homologues de PHPUnit:

• assertEqual() en faveur de assertEquals()

• assertNotEqual() en faveur de assertNotEquals()

• assertIdentical() en faveur de assertSame()

• assertNotIdentical() en faveur de assertNotSame()

• assertPattern() en faveur de assertRegExp()

• assertNoPattern() en faveur de assertNotRegExp()

• assertReference() if favor of assertSame()

• assertIsA() en faveur de assertInstanceOf()

Notez que l’ordre des paramètres de certaines méthodes a été changé, par ex: assertEqual($is, $expected) devra maintenant être assertEquals($expected, $is).

Les méthodes d’assertion suivantes ont été dépréciées et seront retirées dans le futur:

• assertWithinMargin() en faveur de assertWithinRange()

• assertTags() en faveur de assertHtml()

Les deux méthodes de remplacement changent aussi l’ordre des arguments pour avoir une méthode d’API assert cohérente avec $expected en premier argument.

Les méthodes d’assertion suivantes ont été ajoutées:

• assertNotWithinRange() comme contrepartie de assertWithinRange()

Les Themes sont maintenant purement des Plugins¶

Avoir des themes et des plugins comme façon de créer des composants d’applications modulaires nous semblait limité et cela apportait de la confusion. Dans CakePHP 3.0, les themes ne se trouvent plus dans l’application. A la place, ce sont des plugins autonomes. Cela résout certains problèmes liés aux themes:

• Vous ne pouviez pas mettre les themes dans les plugins.

• Les Themes ne pouvaient pas fournir de helpers, ou de classes de vue personnalisée.

Ces deux problèmes sont résolus en convertissant les themes en plugins.

Les Dossiers de View Renommés¶

Les dossiers contenant les fichiers de vue vont maintenant dans src/Template à la place de src/View. Ceci a été fait pour séparer les fichiers de vue des fichiers contenant des classes php (par ex les classes Helpers et View).

Les dossiers de View suivants ont été renommés pour éviter les collisions avec les noms de controller:

• Layouts est maintenant Layout

• Elements est maintenant Element

• Errors est maintenant Error

• Emails est maintenant Email (idem pour Email dans Layout)

HelperCollection remplacée¶

Cette classe a été renommée en Cake\View\HelperRegistry. Regardez la section sur Objets Registry pour plus d’informations sur les fonctionnalités fournies par la nouvelle classe. Vous pouvez utiliser cake upgrade rename_collections pour vous aider à mettre à niveau votre code.

View Class¶

• La clé plugin a été retirée de l’argument $options de Cake\View\View::element(). Spécifiez le nom de l’element comme SomePlugin.element_name à la place.

• View::getVar() a été retirée, utilisez Cake\View\View::get() à la place.

• View::$ext a été retirée et à la place une propriété protected View::$_ext a été ajoutée.

• View::addScript() a été retirée. Utilisez Utiliser les Blocks de Vues à la place.

• Les propriétés magiques base, webroot, here, data, action et params ont été retirées. Vous pouvez accéder à toutes ces propriétés dans $this->request à la place.

• View::start() n’ajoute plus à un block existant. A la place, il va écraser le contenu du block quand end est appelé. Si vous avez besoin de combiner les contenus de block, vous devrez récupérer le contenu du block lors de l’appel de start une deuxième fois ou utiliser le mode de capture append().

• View::prepend() n’a plus de mode de capture.

• View::startIfEmpty() a été retirée. maintenant que start() écrase toujours startIfEmpty n’a plus d’utilité.

• La propriété View::$Helpers a été retirée et remplacée par _helpers. Si vous avez besoin de charger les helpers à la volée, vous devrez utiliser $this->addHelper() dans vos fichiers de view.

• View lancera des Cake\View\Exception\MissingTemplateException lorsque des templates sont au lieu de MissingViewException.

ViewBlock¶

• ViewBlock::append() a été retirée, utilisez Cake\ViewViewBlock::concat() à la place. Cependant, View::append() existe encore.

JsonView¶

• Par défaut les données JSON vont maintenant avoir des entités HTML encodées. Ceci empêche les problèmes possible de XSS quand le contenu de la view JSON est intégrée dans les fichiers HTML.

• Cake\View\JsonView supporte maintenant la variable de view _jsonOptions. Ceci vous permet de configurer le masque utilisé lors de la génération de JSON.

XmlView¶

• Cake\View\XmlView supporte maintenant la variable de view _xmlOptions. Ceci vous permet de configurer les options utilisées lors de la génération de XML.

Helper¶

Les méthodes suivantes de Helper ont été retirées:

• Helper::setEntity()

• Helper::entity()

• Helper::model()

• Helper::field()

• Helper::value()

• Helper::_name()

• Helper::_initInputField()

• Helper::_selectedArray()

Ces méthodes étaient des parties uniquement utilisées par FormHelper, et faisaient partie des continuelles fonctionnalités des champs qui devenaient problématiques au fil du temps. FormHelper ne s’appuie plus sur ces méthodes et leur complexité n’est plus nécessaire.

Les méthodes suivantes ont été retirées:

• Helper::_parseAttributes()

• Helper::_formatAttribute()

Ces méthodes se trouvent dans la classe StringTemplate que les helpers utilisent fréquemment. Regardez StringTemplateTrait pour intégrer les templates de chaîne dans vos propres helpers.

FormHelper¶

FormHelper a été entièrement réécrite pour 3.0. Il amène quelques grands changements:

• FormHelper fonctionne avec le nouvel ORM. Mais il a un système extensible pour être intégré avec d’autres ORMs ou sources de données.

• FormHelper dispose d’une fonctionnalité de système de widget extensible qui vous permet de créer de nouveaux widgets d’input personnalisés et d’améliorer ceux intégrés.

• Les templates de chaîne sont un élément fondateur du helper. Au lieu de tableaux imbriqués ensemble partout, la plupart du HTML que FormHelper génère peut être personnalisé dans un endroit central en utilisant les ensembles de template.

En plus de ces grands changements, quelques plus petits changements finaux ont été aussi faits. Ces changements devraient aider le streamline HTML que le FormHelper génère et réduire les problèmes que les gens ont eu dans le passé:

• Le prefix data[ a été retiré de tous les inputs générés. Le prefix n’a plus de réelle utilité.

• Les diverses méthodes d’input autonomes comme text(), select() et autres ne génèrent plus d’attributs id.

• L’option inputDefaults a été retirée de create().

• Les options default et onsubmit de create() ont été retirées. A la place, vous devez utiliser le binding d’event Javascript ou définir tout le code js nécessaire pour onsubmit.

• end() ne peut plus faire des boutons. Vous devez créer des buttons avec button() ou submit().

• FormHelper::tagIsInvalid() a été retirée. Utilisez isFieldError() à la place.

• FormHelper::inputDefaults() a été retirée. Vous pouvez utiliser templates() pour définir/améliorer les templates que FormHelper utilise.

• Les options wrap et class ont été retirées de la méthode error().

• L’option showParents a été retirée de select().

• Les options div, before, after, between et errorMessage ont été retirées de input(). Vous pouvez utiliser les templates pour mettre à jour le HTML qui l’entoure. L’option templates vous permet de surcharger les templates chargés pour un input.

• Les options separator, between, et legend ont été retirées de radio(). Vous pouvez maintenant utiliser les templates pour changer le HTML qui l’entoure.

• Le paramètre format24Hours a été retiré de hour(). Il a été remplacé par l’option format.

• Les paramètres minYear et maxYear ont été retirés de year(). Ces deux paramètres peuvent maintenant être fournis en options.

• Les paramètres dateFormat et timeFormat ont été retirés de datetime(). Vous pouvez maintenant utiliser les templates pour définir l’ordre dans lequel les inputs doivent être affichés.

• submit() a eu les options div, before et after retirées. Vous pouvez personnaliser le template submitContainer pour modifier ce contenu.

• La méthode inputs() n’accepte plus legend et fieldset dans le paramètre $fields, vous devez utiliser le paramètre $options. Elle nécessite aussi que le paramètre $fields soit un tableau. Le paramètre $blacklist a été retiré, la fonctionnalité a été remplacée en spécifiant 'field' => false dans le paramètre $fields.

• Le paramètre inline a été retiré de la méthode postLink(). Vous devez utiliser l’option block à la place. Définir block => true va émuler le comportement précédent.

• Le paramètre timeFormat pour hour(), time() et dateTime() est par maintenant par défaut à 24, en accord avec l’ISO 8601.

• L’argument $confirmMessage de Cake\View\Helper\FormHelper::postLink() a été retiré. Vous devez maintenant utiliser la clé confirm dans $options pour spécifier le message.

• Les inputs de type checkbox et boutons radios types sont maintenant générées à l’intérieur de balises label par défaut. Ceci aide à accroître la compatibilité avec les librairies CSS populaires telles que Bootstrap et Foundation.

• Les tags de templates sont maintenant tous écrits en camelBack. Les tags pre-3.0 formstart, formend, hiddenblock et inputsubmit sont maintenant formStart, formEnd, hiddenBlock et inputSubmit. Pensez à bien les changer s’ils sont personnalisés dans votre application.

Il est recommandé que vous regardiez la documentation Form pour plus de détails sur la façon d’utiliser le FormHelper dans 3.0.

HtmlHelper¶

• HtmlHelper::useTag() a été retirée, utilisez tag() à la place.

• HtmlHelper::loadConfig() a été retirée. La personnalisation des tags peut être faîte en utilisant templates() ou la configuration templates.

• Le deuxième paramètre $options pour HtmlHelper::css() doit maintenant toujours être un tableau comme c’est écrit dans la documentation.

• Le premier paramètre $data pour HtmlHelper::style() doit maintenant toujours être un tableau comme c’est écrit dans la documentation.

• Le paramètre inline a été retiré des méthodes meta(), css(), script(), scriptBlock(). Vous devrez utiliser l’option block à la place. Définir block => true va émuler le comportement précédent.

• HtmlHelper::meta() nécessite maintenant que $type soit une chaîne de caractère. Les options supplémentaires peuvent en outre être passées dans $options.

• HtmlHelper::nestedList() nécessite maintenant que $options soit un tableau. Le quatrième argument pour le niveau de tag a été retiré et il a été inclus dans le tableau $options.

• L’argument $confirmMessage de Cake\View\Helper\HtmlHelper::link() a été retiré. Vous devez maintenant utiliser la clé confirm dans $options pour spécifier le message.

PaginatorHelper¶

• link() a été retirée. Il n’était plus utilisé par le helper en interne. Il était peu utilisé dans le monde des utilisateurs de code, et ne correspondait plus aux objectifs du helper.

• next() n’a plus les options “class”, ou “tag”. Il n’a plus d’arguments désactivés. A la place, les templates sont utilisés.

• prev() n’a plus les options “class”, ou “tag”. Il n’a plus d’arguments désactivés. A la place, les templates sont utilisés.

• first() n’a plus les options “after”, “ellipsis”, “separator”, “class”, ou “tag”.

• last() n’a plus les options “after”, “ellipsis”, “separator”, “class”, ou “tag”.

• numbers() n’a plus les options “separator”, “tag”, “currentTag”, “currentClass”, “class”, “tag”, “ellipsis”. Ces options sont maintenant accessibles à travers des templates. Le paramètre $options doit maintenant être un tableau.

• Les placeholders de style %page% ont été retirés de Cake\View\Helper\PaginatorHelper::counter(). Utilisez les placeholders de style {{page}} à la place.

• url() a été renommée en generateUrl() pour éviter des clashes de déclaration de méthode avec Helper::url().

Par défaut, tous les liens et le texte inactif sont entourés d’elements <li>. Ceci aide à écrire plus facilement du CSS, et améliore la compatibilité avec des frameworks populaires.

A la place de ces diverses options dans chaque méthode, vous devez utiliser la fonctionnalité des templates. Regardez les informations de la documentation Templates de PaginatorHelper sur la façon d’utiliser les templates.

TimeHelper¶

• TimeHelper::__set(), TimeHelper::__get(), et TimeHelper::__isset() ont été retirées. Celles-ci étaient des méthodes magiques pour des attributs dépréciés.

• TimeHelper::serverOffset() a été retirée. Elle entraînait de mauvaises utilisations mathématiques de time.

• TimeHelper::niceShort() a été retirée.

NumberHelper¶

• NumberHelper::format() nécessite maintenant que $options soit un tableau.

SessionHelper¶

• SessionHelper est déprécié. Vous pouvez utiliser $this->request->session() directement, et la fonctionnalité de message flash a été déplacée dans Flash à la place.

JsHelper¶

• JsHelper et tous les moteurs associés ont été retirés. il pouvait seulement générer un tout petit nombre de code Javascript pour la librairie sélectionnée et essayer de générer tout le code Javascript en utilisant le helper devenait souvent difficile. Il est maintenant recommandé d’utiliser directement la librairie Javascript de votre choix.

CacheHelper Retiré¶

CacheHelper a été retiré. La fonctionnalité de cache quelle fournissait n’était pas standard, limitée et incompatible avec les mises en page non-HTML et les vues de données. Ces limitations signifiaient qu’une réécriture complète était nécessaire. Edge Side Includes est devenu un moyen standard d’implémenter les fonctionnalités que CacheHelper fournissait. Cependant, implémenter Edge Side Includes en PHP présente un grand nombre de limitations. Au lieu de construire une solution de qualité inférieure, nous recommandons aux développeurs ayant besoin d’un cache global d’utiliser Varnish ou Squid à la place.

Classe Set Retirée¶

La classe Set a été retirée, vous devriez maintenant utiliser la classe Hash à la place.

Folder & File¶

Les classes folder et file ont été renommées:

• Cake\Utility\File renommée Cake\Filesystem\File

• Cake\Utility\Folder renommée Cake\Filesystem\Folder

Inflector¶

• la valeur par défaut pour l’argument $replacement de la méthode Cake\Utility\Inflector::slug() a été modifiée de underscore (_) au tiret (-). utiliser des tirets pour séparer les mots dans les url est le choix le plus courant et également celui recommandé par Google.

• Les translitérations pour Cake\Utility\Inflector::slug() ont changé. Si vous utilisez des translitérations personnalisées, vous devrez mettre à jour votre code. A la place des expressions régulières, les translitérations utilisent le remplacement par chaîne simple. Cela a donné des améliorations de performances significatives:

  // Au lieu de
  Inflector::rules('transliteration', [
      '/ä|æ/' => 'ae',
      '/å/' => 'aa'
  ]);
  
  // Vous devrez utiliser
  Inflector::rules('transliteration', [
      'ä' => 'ae',
      'æ' => 'ae',
      'å' => 'aa'
  ]);
  

• Des ensembles de règles non inflectées et irrégulières séparés pour la pluralization et la singularization ont été retirés. Plutôt que d’avoir une liste commune pour chacun. Quand on utilise Cake\Utility\Inflector::rules() avec un type “singular” et “plural” vous ne pouvez plus utiliser les clés comme “uninflected”, “irregular” dans le tableau d’argument $rules.

  Vous pouvez ajouter / écraser la liste de règles non inflectées et irrégulières en utilisant Cake\Utility\Inflector::rules() en utilisant les valeurs “non inflectées” et “irrégulières” pour un argument $type.

Sanitize¶

• La classe Sanitize a été retirée.

Security¶

• Security::cipher() a été retirée. Elle est peu sûre et favorise de mauvaises pratiques en cryptographie. Vous devrez utiliser Security::encrypt() à la place.

• La valeur de configuration Security.cipherSeed n’est plus nécessaire. Avec le retrait de Security::cipher() elle n’est plus utilisée.

• La rétrocompatibilité de Cake\Utility\Security::rijndael() pour les valeurs cryptées avant CakePHP 2.3.1 a été retirée. Vous devrez rechiffrer les valeurs en utilisant Security::encrypt() et une version plus récente de CakePHP 2.x avant migration.

• La capacité de générer blowfish a été retirée. Vous ne pouvez plus utiliser le type « blowfish » pour Security::hash(). Vous devrez utiliser uniquement le password_hash() de PHP et password_verify() pour générer et vérifier les hashs de blowfish. La librairie compatible ircmaxell/password-compat qui est installée avec CakePHP fournit ces fonctions pour PHP < 5.5.

• OpenSSL est maintenant utilisé à la place de mcrypt pour le chiffrement/déchiffrement des données. Ce changement fournit de meilleurs performances et une avancée dans la supression du support de mcrypt.

• Security::rijndael() est dépréciée et elle est seulement disponible quand vous utilisez mcrypt.

Time¶

• CakeTime a été renommée en Cake\I18n\Time.

• Time::__set() et - Time::__get() ont été retirées. Celles-ci étaient des méthodes magiques setter/getter pour une rétrocompatibilité.

• CakeTime::serverOffset() a été retirée. Il incitait à des pratiques de correspondance de time incorrects.

• CakeTime::niceShort() a été retirée.

• CakeTime::convert() a été retirée.

• CakeTime::convertSpecifiers() a été retirée.

• CakeTime::dayAsSql() a été retirée.

• CakeTime::daysAsSql() a été retirée.

• CakeTime::fromString() a été retirée.

• CakeTime::gmt() a été retirée.

• CakeTime::toATOM() a été renommée en toAtomString.

• CakeTime::toRSS() a été renommée en toRssString.

• CakeTime::toUnix() a été renommée en toUnixString.

• CakeTime::wasYesterday() a été renommée en isYesterday pour correspondre aux autres noms de méthode.

• CakeTime::format() N’utilise plus les chaînes de format sprintf`, vous pouvez utiliser ``i18nFormat à la place.

• Time::timeAgoInWords() a maintenant besoin que $options soit un tableau.

Time n’est plus une collection de méthodes statiques, il étend DateTime pour hériter de ses méthodes et ajoute la localisation des fonctions de formatage avec l’aide de l’extension intl.

En général, les expressions ressemblent à ceci:

CakeTime::aMethod($date);

Peut être migré en réécrivant ceci en:

(new Time($date))->aMethod();

Number¶

Number a été réécrite pour utiliser en interne la classe NumberFormatter.

• CakeNumber a été renommée en Cake\I18n\Number.

• Number::format() nécessite maintenant que $options soit un tableau.

• Number::addFormat() a été retirée.

• Number::fromReadableSize() a été déplacée vers Cake\Utility\Text:parseFileSize().

Validation¶

• Le range pour Validation::range() maintenant inclusif si $lower et $upper sont fournies.

• Validation::ssn() a été retirée.

Xml¶

• Xml::build() a maintenant besoin que $options soit un tableau.

• Xml::build() n’accepte plus d’URL. Si vous avez besoin de créer un document XML à partir d’une URL, utilisez Http\Client.