Points de base
Cet article a été mis à jour le 24 mai 2017 et fournit une introduction plus complète à cet outil moderne important.
"Le composant de la console simplifie le processus de création d'une interface de ligne de commande belle et testable." Ceci est le message de bienvenue que nous voyons lorsque nous visitons la page des outils de composants de la console Symfony.
En tant que développeurs de logiciels, nous devons souvent utiliser des outils de ligne de commande. Ces outils sont utiles lorsque nous devons effectuer une sorte de tâches répétitives (telles que la migration des données, l'exécution des importations ou la création de travaux CRON).
L'outil de composant Console Symfony nous fournit un framework simple pour créer nos propres outils de ligne de commande.
Contrairement à de nombreux composants de Symfony, il s'agit d'un package autonome qui est utilisé par l'artisan de Laravel et de nombreux autres packages PHP célèbres.
Pour en savoir plus sur les alternatives à la console Symfony, voir notre article de comparaison: Battle of PHP Console!
Installation
composer require symfony/console
Créer une nouvelle commande
Pour créer une nouvelle commande, nous devons nous assurer que notre fichier est exécutable. Pour ce faire, créons un fichier de console dans le répertoire racine du projet. Ce fichier sera notre gestionnaire de commandement.
Maintenant, assurez-vous que le fichier est exécutable.
touch console
Ensuite, assurons qu'il y a Shebang au début de notre fichier. Shebang est une séquence de personnages (marque de pouce suivi de la marque d'exclamation) qui apparaît au début du script. Lorsque Shebang existe, EXEC () passera au fichier exécutable spécifié après l'exécution de Shebang. Dans notre exemple, il s'exécutera en tant que script PHP.
chmod 755 console
, définissons notre application de console. La première itération de notre gestionnaire de commande ressemblera à ceci:
Regardons de plus près. Tout d'abord, nous chargeons automatiquement toutes les dépendances, puis importons le package d'application à partir du composant de la console. Après cela, nous créons une nouvelle instance d'application et l'exécutons.
#!/usr/bin/env php <?php require_once __DIR__ . '/vendor/autoload.php'; use Symfony\Component\Console\Application; $app = new Application(); $app->run();
Si nous utilisons ./console
pour exécuter le script, nous devons obtenir le message d'aide suivant:
C'est parce que nous n'avons pas encore enregistré de commandes, nous venons de construire leur cadre de base.
Créons notre script et inscrivons-le dans notre gestionnaire de commandes nouvellement créé.
Pour cet exemple spécifique, nous implémenterons deux commandes simples: l'une pour les chaînes de hachage et l'autre pour confirmer que le hachage appartient à la chaîne donnée.
Nous placerons le dossier /src
de notre classe Hash.php, avec le contenu suivant:
composer require symfony/console
Il est temps de créer nos commandes. Créons un nouveau fichier PHP appelé hashcommand.php.
Cette classe étendra la classe de commande de Symfony et implémentera les méthodes de configuration et d'exécution. Ces méthodes sont cruciales pour nos commandes car elles indiquent aux commandes à quoi elles ressemblent et se comportent.
La commande terminée parest la suivante:
touch console
Dans la section de configuration, la méthode setName est la façon dont nous appelons la commande, SetDescription est la description de la commande, et AddArgument est l'instruction que nous déclarons que la commande acceptera un paramètre nommé mot de passe, et il est nécessaire.
Dans la section Execute, nous accédons aux paramètres via la fonction GetArgument, puis les hachiez en utilisant notre classe de hachage. Enfin, nous utilisons la méthode WriteEln de OutputInterface pour imprimer le résultat à l'écran.
Si nous exécutons notre commande comme celle-ci, nous ne verrons rien qui se passe. C'est parce que nous manquons toujours une étape très importante. Nous devons encore enregistrer nos commandes dans la console.
chmod 755 console
Après avoir enregistré la commande dans la console, exécutons-la.
Si nous exécutons à nouveau la commande ./console
, nous pouvons voir que nous avons maintenant enregistré une nouvelle commande.
Exécutez-le:
#!/usr/bin/env php <?php require_once __DIR__ . '/vendor/autoload.php'; use Symfony\Component\Console\Application; $app = new Application(); $app->run();
Nous voyons le résultat final:
Hash est le résultat de l'application de la méthode PHP Hash () à une chaîne SitePoint.
Pour la fonction de confirmation de hachage, nous utiliserons la même méthode, mais nous aurons deux paramètres au lieu d'un. L'un sera la chaîne qui doit être confirmée, et l'autre sera la valeur de hachage que nous voulons vérifier.
Nous créerons un nouveau fichier de commande, juste à côté du fichier HashCommand. Appelons cela ConfirmCommand.
<?php namespace Hash; class Hash { /** * 接收一个字符串密码并对其进行哈希处理。 * * @param string $password * @return string $hash */ public static function hash($password) { return password_hash($password, PASSWORD_DEFAULT); } /** * 验证哈希是否与给定的密码相对应 * * @param string $password * @param string $hash * @return boolean 如果哈希是从密码生成的 */ public static function checkHash($string, $hash) { if (password_verify($string, $hash)) { return true; } return false; } }
Ensuite, enregistrez la commande dans la console.
<?php namespace Hash; use Symfony\Component\Console\Command\Command; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Formatter\OutputFormatterStyle; use Hash\Hash; class HashCommand extends Command { protected function configure() { $this->setName("Hash:Hash") ->setDescription("使用Bcrypt对给定字符串进行哈希处理。") ->addArgument('Password', InputArgument::REQUIRED, '你想要哈希什么?'); } protected function execute(InputInterface $input, OutputInterface $output) { $hash = new Hash(); $input = $input->getArgument('Password'); $result = $hash->hash($input); $output->writeln('你的密码哈希值:' . $result); } }
Tester
En termes de tests, Symfony nous fournit quelques outils pratiques. Le plus utile est la classe CommandSter, car elle fournit des classes d'entrée et de sortie spéciales pour tester nos commandes sans la ligne de commande.
Utilisons la classe CommandTester pour implémenter un test pour notre commande hash: hash.
Tout d'abord, créons un dossier /src
au même niveau que le nôtre. /tests
composer require symfony/console
La méthode
getDisplay () enregistre le résultat de notre exécution de commande, tout comme nous le voyons sur la ligne de commande.
Conclusion
Nous venons de créer deux commandes différentes à l'aide du composant Console Symfony. Nous voyons également un bon moyen de tester ces commandes. Je vous suggère de regarder les différentes options et fonctionnalités des composants et nous donner quelques commentaires sur votre expérience dans la section des commentaires ci-dessous.Voulez-vous voir des tutoriels plus avancés sur la console Symfony sur SitePoint? S'il vous plaît dites-nous!
Tout le code que nous avons écrit dans cet article peut être trouvé sur GitHub.
Symfony Console FAQ. Cette commande téléchargera et installera le composant de la console Symfony dans votre projet. composer require symfony/console
Comment créer une nouvelle commande dans Symfony Console?
Comment exécuter les commandes dans Symfony Console?
suivi du nom de la commande. Par exemple, si vous avez une commande appelée bin/console
, vous pouvez l'exécuter avec la commande suivante: app:my-command
. bin/console app:my-command
Les paramètres et options de commande peuvent être définis dans la méthode de configuration de la classe de commande. Vous pouvez utiliser les méthodes GetArgument et GetOption pour récupérer les valeurs de ces paramètres et options dans la méthode d'exécution.
Symfony Console fournit plusieurs façons d'afficher la sortie. Vous pouvez utiliser la méthode WriteEln pour afficher une ligne de texte, utiliser la méthode d'écriture pour afficher le texte (aucune ligne se casse à la fin) et utiliser la méthode de la table pour afficher la table.
Les erreurs peuvent être gérées en lançant des exceptions. Symfony Console attrapera ces exceptions et affichera un message d'erreur. Vous pouvez également utiliser la méthode de sortie pour arrêter l'exécution de la commande et renvoyer le code de sortie.
Symfony Console fournit une classe CommandTester qui peut être utilisée pour tester les commandes. Vous pouvez utiliser cette classe pour exécuter des commandes avec des paramètres et des options spécifiques et affirmer le code de sortie et de sortie.
Dans le projet Symfony, vous pouvez utiliser le script bin/console
pour exécuter les commandes. Vous pouvez également créer vos propres commandes en créant une nouvelle classe étendant la classe SymfonyComponentConsoleCommand dans le répertoire src/Command
.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!