Dans de nombreux languages, demander à l’utilisateur, pendant l’execution du programme de saisir des informations est chose aisée. Le PHP étant un langage de script initialement développer exclusivement pour un usage Web, il n’est pas prévu de commande permettant de mettre en pause le programme le temps que l’utilisateur fournisse l’information qui nous manques.
Heureusement, si cette fonction n’existe pas, PHP fournis tous les outils pour le faire.
La première chose à savoir c’est que PHP fourni des “ressources” correspondant aux entrées et sorties du système linux :
php://stdincorrespondant à l’entré2017-12-20-grafana-docker-compose.markdowne standardphp://stdoutcorrespondant à la sortie standardphp://stderrcorrespondant à la sortie d’erreur
Ces ressources peuvent être utilisées via de nombreuses commandes PHP comme s’il s’agissait de fichiers.
Ainsi, on peut écrire sur la sortie d’erreur avec le code suivant :
$stderr = fopen("php://stderr", "w");
fwrite("An error occured\n", $stderr);
fclose($stderr);
Par conséquent, on peut donc lire sur l’entrée standard de la même manière.
Pour rappel, l’entrée standard se comporte ici comme un fichier, il nous faut donc quand même rajouter un moyen pour que le programme ne lise pas l’entrée indéfiniment pour pouvoir reprendre sa course.
La fonction fgets permet de lire « une ligne » dans un fichier, c’est-à-dire qu’il va retourner tous les caractères jusqu’au premier saut de ligne. Ce qui est idéal pour nous puisque l’utilisateur va pouvoir ainsi valider sa saisie avec la toucher [ENTER] de son clavier.
function readUserEntry(): string {
$stdin = fopen("php://stdin","r");
$input = fgets($stdin);
fclose ($stdin);
return $input;
}
Voilà qui est pas mal pour une première version.
Pour nous faciliter le travail, PHP a ajouté des constantes permettant d’accéder directement aux flux d’entrée sortie, plus besoin de les ouvrir et de les fermer, ce sont des ressources toujours accessible.
Ainsi, le même code se résume maintenant à une ligne :
function readUserEntry(): string {
return fgets(STDIN);
}
On va maintenant rendre notre fonction un peu plus sexy et plus propre en ajoutant une invite et en nettoyant la réponse reçue :
function readUserEntry(?string $invite = null): string {
if (! empty($invite)) {
printf($invite);
}
return trim(fgets(STDIN));
}