1 pièce(s) jointe(s)
Les arguments nommés vont débarquer dans PHP 8 et promettent d'apporter de nombreux avantages
Les arguments nommés vont débarquer dans PHP 8 et promettent d'apporter de nombreux avantages,
d'écraser directement uniquement les valeurs par défaut que vous souhaitez modifier
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:
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:
array_fill(value: 50, num: 100, start_index: 0);
Il est possible de combiner des arguments nommés avec des arguments positionnels normaux et il est également possible de ne spécifier que certains des arguments optionnels d'une fonction, quel que soit leur ordre:
Code:
1
2
3
| htmlspecialchars($string, double_encode: false);
//Revient à la même chose que
htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false); |
Cette fonctionnalité a fait l'objet de vives discussions et des contre-arguments ont été avancés pour ne pas l'implémenter.
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:
public function toMediaCollection(string $collection, string $disk = null);
Les paramètres nommés permettraient d'appeler cette fonction comme ceci:
Code:
1
2
| $pendingMedia
->toMediaCollection(collection: 'downloads', disk: 's3'); |
Si, pour une raison quelconque, le mainteneur souhaite changer le nom de la variable $collection ou $disk, il devra taguer une version majeure, car des arguments nommés en feraient un changement radical.
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:
1
2
3
4
| setcookie(
name: 'test',
expires: time() + 60 * 60 * 2,
); |
Sa signature de méthode est en fait la suivante:
Code:
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 |
Dans cet exemple, nous n'avions pas besoin de définir $value d'un cookie, mais nous devions définir une heure d'expiration. Les arguments nommés ont rendu cet appel de méthode un peu plus concis. Ci-dessous setcookie sans les arguments nommés puis avec les arguments nommés:
Code:
1
2
3
4
5
| setcookie(
'test',
'',
time() + 60 * 60 * 2,
); |
Code:
1
2
3
4
| setcookie(
name: 'test',
expires: time() + 60 * 60 * 2,
); |
Code auto-documenté
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:
1
2
3
| array_slice($array, $offset, $length, true);
// et
array_slice($array, $offset, $length, preserve_keys: true); |
Si cet exemple n'était pas écrit en ce moment, un développeur n'aurait pas su ce que fait le quatrième paramètre de array_slice (ou même qu'il existe en premier lieu).
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:
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);
}
} |
Les constructeurs en particulier ont souvent un nombre plus grand que la moyenne de paramètres dont l'ordre n'a pas de signification particulière, et qui sont généralement par défaut. Bien que la promotion du constructeur simplifie la déclaration de classe, elle n'aide pas l'instanciation d'objet réelle.
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:
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! |
L'avantage des arguments nommés pour l'initialisation des objets est en surface le même que pour les autres fonctions, cela a juste tendance à avoir plus d'importance dans la pratique ici.
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:
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]); |
Bien que cela fonctionne, et soit déjà possible aujourd'hui, cela présente de nombreux inconvénients:
- 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:
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) { ... } |
L'introduction d'arguments nommés dans la même version que les attributs permettrait de conserver exactement la même structure qu'auparavant:
Code:
1
2
| <<Route("/api/posts/{id}", methods: ["GET", "HEAD"])>>
public function show(int $id) { ... } |
Certaines modifications seraient encore nécessaires en raison du manque de prise en charge des annotations imbriquées, mais cela rendrait la migration un peu plus fluide.
Source : PHP
Et vous ?
:fleche: Que pensez-vous des arguments nommés ?
Voir aussi :
:fleche: Les nouveautés de PHP 8
:fleche: 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
simplification de la gestion des paramètres des fonctions en PHP
