La source de PHP 8.0 est prévue pour la fin de cette année avec un ambitieux programme, notamment :- de nouvelles fonctionnalités :
- un compilateur JIT ;
- les « union types » ;
- les attributs ;
- une nouvelle classe WeakMap ;
- les simplifications de code apportées par les nouveaux constructeurs ;
- de nouvelles fonctions ;
- des changements qui auront un impact sur le code existant (Breaking changes) :
- la gestion de l’incrémentation d’index négatifs dans les tableaux ;
- des modifications sur la gestion des erreurs ;
- des modifications sur les valeurs par défaut des directives d’initialisation de PHP ;
- des fonctions supprimées.
Il y a quelques jours, la communauté PHP a adopté les named arguments (arguments nommés), aussi appelé named parameters (paramètres nommés).
Les arguments nommés permettent de passer des arguments à une fonction en fonction du nom du paramètre, plutôt que de la position du paramètre. Cela rend la signification de l'argument autodocumentée, rend les arguments indépendants de l'ordre et permet de sauter arbitrairement les valeurs par défaut.
Pour donner un exemple simple:
| Code PHP : | Sélectionner tout |
1 2 3 4 5 | //en utilisant des arguments de position: array_fill(0, 100, 50); //en utilisant des arguments nommés: array_fill(start_index: 0, num: 100, value: 50); |
L'ordre dans lequel les arguments nommés sont passés n'a pas d'importance. L'exemple ci-dessus les passe dans le même ordre qu'ils sont déclarés dans la signature de la fonction, mais tout autre ordre est également possible:
| Code PHP : | Sélectionner tout |
array_fill(value: 50, num: 100, start_index: 0);
| Code PHP : | Sélectionner tout |
1 2 3 | htmlspecialchars($string, double_encode: false); //Revient à la même chose que htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false); |
L'un des arguments contre les paramètres nommés est qu'ils rendraient difficile la maintenance d'un logiciel open source : changer le nom d'un argument deviendrait un changement radical. Voici ce que cela signifie. Imaginez un package open source qui a cette fonction dans le cadre de son API publique:
| Code PHP : | Sélectionner tout |
public function toMediaCollection(string $collection, string $disk = null);
| Code PHP : | Sélectionner tout |
1 2 | $pendingMedia ->toMediaCollection(collection: 'downloads', disk: 's3'); |
Quels sont les avantages des arguments nommés ?
Ignorer les valeurs par défaut
Cependant, pour plusieurs développeurs, les avantages l'emportent de loin sur la peur des problèmes de compatibilité ascendante ou des API gonflées. Certains pensent même qu'ils permettront d'écrire un code plus propre et plus flexible. D'une part, les arguments nommés vous permettent d'ignorer les valeurs par défaut. Les arguments nommés vous permettent d'écraser directement uniquement les valeurs par défaut que vous souhaitez modifier. Prenons cet exemple :
| Code PHP : | Sélectionner tout |
1 2 3 4 | setcookie( name: 'test', expires: time() + 60 * 60 * 2, ); |
| Code PHP : | Sélectionner tout |
1 2 3 4 5 6 7 8 9 | setcookie ( string $name, string $value = "", int $expires = 0, string $path = "", string $domain = "", bool $secure = false, bool $httponly = false, ) : bool |
| Code PHP : | Sélectionner tout |
1 2 3 4 5 | setcookie( 'test', '', time() + 60 * 60 * 2, ); |
| Code PHP : | Sélectionner tout |
1 2 3 4 | setcookie( name: 'test', expires: time() + 60 * 60 * 2, ); |
L'avantage de l'autodocumentation du code s'applique même lorsque vous n'ignorez pas les arguments facultatifs. Par exemple, comparez les deux lignes suivantes:
| Code PHP : | Sélectionner tout |
1 2 3 | array_slice($array, $offset, $length, true); // et array_slice($array, $offset, $length, preserve_keys: true); |
Initialisation d'objet
La RFC de promotion des propriétés du constructeur simplifie considérablement la déclaration des classes d'objets de valeur. Pour choisir l'un des exemples de cette RFC:
| Code PHP : | Sélectionner tout |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | // Partie de la représentation PHP AST class ParamNode extends Node { public function __construct( public string $name, public ExprNode $default = null, public TypeNode $type = null, public bool $byRef = false, public bool $variadic = false, Location $startLoc = null, Location $endLoc = null, ) { parent::__construct($startLoc, $endLoc); } } |
Il y a eu plusieurs tentatives pour rendre la construction d'objet plus ergonomique, comme le RFC Object Initializer et le RFC COPA. Cependant, toutes ces tentatives ont été refusées, car elles ne s'intègrent pas bien dans le langage, en raison d'une interaction défavorable avec des constructeurs ou des propriétés non publiques.
Les arguments nommés résolvent le problème d'initialisation des objets comme un effet secondaire, d'une manière qui s'intègre bien à la sémantique du langage existant.
| Code PHP : | Sélectionner tout |
1 2 3 4 5 6 7 8 9 10 11 12 | new ParamNode("test", null, null, false, true); // devient: new ParamNode("test", variadic: true); new ParamNode($name, null, null, $isVariadic, $passByRef); // ou était-ce ? new ParamNode($name, null, null, $passByRef, $isVariadic); // qui devient new ParamNode($name, variadic: $isVariadic, byRef: $passByRef); // ou new ParamNode($name, byRef: $passByRef, variadic: $isVariadic); // et cela n'a plus d'importance! |
Options sécurisées et documentées
L'une des solutions de contournement courantes pour le manque d'arguments nommés est l'utilisation d'un tableau d'options. L'exemple précédent pourrait être réécrit pour utiliser un tableau d'options comme suit:
| Code PHP : | Sélectionner tout |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 | class ParamNode extends Node { public string $name; public ExprNode $default; public TypeNode $type; public bool $byRef; public bool $variadic; public function __construct(string $name, array $options = []) { $this->name = $name; $this->default = $options['default'] ?? null; $this->type = $options['type'] ?? null; $this->byRef = $options['byRef'] ?? false; $this->variadic = $options['variadic'] ?? false; parent::__construct( $options['startLoc'] ?? null, $options['endLoc'] ?? null ); } } // Usage: new ParamNode($name, ['variadic' => true]); new ParamNode($name, ['variadic' => $isVariadic, 'byRef' => $passByRef]); |
- Pour les constructeurs en particulier, cela exclut l'utilisation de la promotion de constructeur.
- Les options disponibles ne sont pas documentées dans la signature. Vous devez regarder l'implémentation ou phpdoc pour savoir ce qui est pris en charge et quels types il nécessite. Phpdoc ne fournit pas non plus de moyen universellement reconnu de documenter cela.
- Le type des valeurs d'option n'est pas validé sauf s'il est implémenté manuellement. Dans l'exemple ci-dessus, les types seront en fait validés en raison de l'utilisation de types de propriétés, mais cela ne suivra pas la sémantique PHP habituelle (par exemple, si la déclaration de classe utilise strict_types, les options seront également validées selon strict_types).
- À moins que vous ne fassiez tout votre possible pour vous protéger, le passage d'options inconnues sera validé silencieusement.
- L'utilisation d'un tableau d'options nécessite une décision spécifique au moment de l'introduction de l'API. Si vous commencez sans en utiliser un, mais ajoutez ensuite des paramètres facultatifs supplémentaires et réalisez que l'utilisation d'un tableau d'options serait plus propre, vous ne pouvez pas effectuer le changement sans interrompre les utilisateurs d'API existants.
Les paramètres nommés fournissent les mêmes fonctionnalités que les tableaux d'options, sans aucun des inconvénients
Les attributs
L'utilisation d'arguments nommés dans les annotations phpdoc est déjà largement répandue dans l'écosystème. Bien que la RFC Attributes remplace les annotations phpdoc par une fonctionnalité de langage de première classe, elle ne prend pas en charge les arguments nommés. Cela signifie que les annotations existantes devront introduire des changements structurels importants pour migrer vers le système d'attributs.
Par exemple, l'annotation Symfony Route accepte un certain nombre d'options facultatives telles que des méthodes. Actuellement, une migration vers des attributs peut ressembler à ceci:
| Code PHP : | Sélectionner tout |
1 2 3 4 5 6 7 8 9 | /** * @Route("/api/posts/{id}", methods={"GET","HEAD"}) */ public function show(int $id) { ... } // Might become: <<Route("/api/posts/{id}", ["methods" => ["GET", "HEAD"]])>> public function show(int $id) { ... } |
| Code PHP : | Sélectionner tout |
1 2 | <<Route("/api/posts/{id}", methods: ["GET", "HEAD"])>> public function show(int $id) { ... } |
Source : PHP
Et vous ?
Que pensez-vous des arguments nommés ?Voir aussi :
Les nouveautés de PHP 8 Microsoft annonce qu'il ne va plus offrir de support à PHP sur Windows dès la version 8.0 dont la sortie est prévue pour novembre
Vous avez lu gratuitement 3 243 articles depuis plus d'un an.
Soutenez le club developpez.com en souscrivant un abonnement pour que nous puissions continuer à vous proposer des publications.
Soutenez le club developpez.com en souscrivant un abonnement pour que nous puissions continuer à vous proposer des publications.
Envoyé par NoPr0n
