Outils de Console, Shells, & Tasks¶

La console de CakePHP¶

Cette section est une introduction sur la ligne de commande dans CakePHP. Les outils de la Console sont idéals pour l’utilisation de tâches cron, ou pour les utilitaires basés sur les lignes de commandes qui n’ont pas besoin d’être accessibles par un navigateur.

PHP fournit un puissant client CLI qui rend l’interfaçage avec votre système de fichier et vos applications plus facile. La Console CakePHP fournit un framework de création de scripts shell. La console utilise un ensemble de répartiteur de types pour charger un shell ou une tâche, et lui passer des paramètres.

Avant d’entrer dans les spécificités, assurons-nous que vous pouvez exécuter la console CakePHP. Tout d’abord, vous devrez ouvrir un shell système. Les exemples présentés dans cette section seront en bash, mais la console CakePHP est également compatible avec Windows. Exécutons le programme Console depuis le bash. Cet exemple suppose que l’utilisateur est actuellement connecté dans l’invité bash et qu’il est en root sur une installation CakePHP.

Une application CakePHP contient les répertoires src/Shell et src/Shell/Task qui contiennent tous ses shells et tasks. Il est aussi livré avec un exécutable dans le répertoire bin:

$ cd /path/to/app
$ bin/cake

Quand vous lancez la Console sans argument, cela affiche ce message d’aide:

Welcome to CakePHP v3.6.0 Console
---------------------------------------------------------------
App : App
Path: /Users/markstory/Sites/cakephp-app/src/
---------------------------------------------------------------
Current Paths:

 -app: src
 -root: /Users/markstory/Sites/cakephp-app
 -core: /Users/markstory/Sites/cakephp-app/vendor/cakephp/cakephp

Changing Paths:

Your working path should be the same as your application path. To change your path use the '-app' param.
Example: -app relative/path/to/myapp or -app /absolute/path/to/myapp

Available Shells:

- version
- help
- cache
- completion
- i18n
- schema_cache
- plugin
- routes
- server
- bug
- console
- event
- orm
- bake
- bake.bake
- migrations
- migrations.migrations

To run a command, type `cake shell_name [args|options]`
To get help on a specific command, type `cake shell_name --help`

La première information affichée est en rapport avec les chemins. Ceci est particulièrement pratique si vous exécutez la Console depuis différents endroits de votre système de fichier.

Vous pouvez lancer n’importe quel shell listé en utilisant son nom:

# lance le shell server
bin/cake server

# lance le shell migrations
bin/cake migrations -h

# lance le shell bake (avec le préfixe plugin)
bin/cake bake.bake -h

Les shells de plugins peuvent être invoqués sans le préfixe du plugin si le nom du shell n’entre pas en collision avec un shell de l’application ou du framework. Dans le cas où deux plugins fournissent un shell du même nom, c’est le premier chargé qui récupérera l’alias court. Vous pouvez toujours utiliser le format plugin.shell pour référencer un shell sans ambiguïté.

class Cake\Console\Shell¶

Créer un Shell¶

Créons un shell pour l’utilisation dans la Console. Pour cet exemple, nous créerons un simple shell Hello world. Dans le répertoire src/Shell de votre application, créez HelloShell.php. Mettez le code suivant dedans:

namespace App\Shell;

use Cake\Console\Shell;

class HelloShell extends Shell
{
    public function main()
    {
        $this->out('Hello world.');
    }
}

Les conventions pour les classes de shell sont que les noms de classe doivent correspondre au nom du fichier, avec Shell en suffixe. Dans notre shell, nous avons créé une méthode main(). Cette méthode est appelée quand un shell est appelé avec aucune commande supplémentaire. Nous allons ajouter quelques commandes en plus dans un moment, mais pour l’instant lançons juste notre shell. Depuis le répertoire de votre application, lancez:

bin/cake hello

Vous devriez voir la sortie suivante:

Hello world.

Comme mentionné précédemment, la méthode main() dans les shells est une méthode spéciale appelée tant qu’il n’y a pas d’autres commandes ou arguments donnés au shell. Comme notre méthode principale n’était pas très intéressante, ajoutons une autre commande qui fait quelque chose:

namespace App\Shell;

use Cake\Console\Shell;

class HelloShell extends Shell
{
    public function main()
    {
        $this->out('Hello world.');
    }

    public function heyThere($name = 'Anonymous')
    {
        $this->out('Hey there ' . $name);
    }
}

Après avoir enregistré ce fichier, vous devriez pouvoir lancer la commande suivante et voir votre nom affiché:

bin/cake hello hey_there your-name

Toute méthode publique non préfixée par un _ peut être appelée d’une ligne de commande. Comme vous pouvez le voir, les méthodes appelées avec la ligne de commande sont transformées d’un argument en underscore du shell en un bon nom de méthode en camel-case de la classe.

Dans notre méthode heyThere(), nous pouvons voir que les arguments de position sont envoyés à notre fonction heyThere(). Les arguments de position sont aussi disponible dans la propriété args. Vous pouvez accéder switches ou aux options des applications du shell, qui sont disponibles dans $this->params, mais nous étudierons ce point plus tard.

Lorsque vous utilisez la méthode main(), vous ne pouvez pas utiliser les arguments de position ou les paramètres. Cela parce que le premier argument de position ou l’option est interprété en tant que nom de commande. Si vous voulez utiliser des arguments et des options, vous devriez utiliser un autre nom de méthode que main.

Les Tâches Shell¶

Il y aura des fois où quand vous construirez des applications plus poussées via la console, vous voudrez composer des fonctionnalités dans des classes réutilisables qui peuvent être partagées à travers plusieurs shells. Les tâches vous permettent d’extraire des commandes dans des classes. Par exemple, la commande bake est fait entièrement de tâches. Vous définissez les tâches d’un shell en utilisant la propriété $tasks:

class UserShell extends Shell
{
    public $tasks = ['Template'];
}

Vous pouvez utiliser les tâches à partir de plugins en utilisant la syntaxe de plugin standard. Les tâches sont stockées dans src/Shell/Task/ dans les fichiers nommées d’après leur classe. Ainsi si vous étiez sur le point de créer une nouvelle tâche “FileGenerator”, vous pourriez créer src/Shell/Task/FileGeneratorTask.php.

Chaque tâche doit au moins intégrer une méthode main(). Le ShellDispatcher appellera cette méthode quand la tâche est invoquée. Une classe de tâche ressemble à cela:

namespace App\Shell\Task;

use Cake\Console\Shell;

class FileGeneratorTask extends Shell
{
    public function main()
    {

    }
}

Un shell peut aussi accéder à ses tâches en tant que propriétés, ce qui rend les tâches meilleures pour la réutilisation de fonctions identiques à Components (Composants):

// Dans src/Console/Command/SeaShell.php
class SeaShell extends Shell
{
    // Se trouve dans src/Shell/Task/SoundTask.php
    public $tasks = ['Sound'];

    public function main()
    {
        $this->Sound->main();
    }
}

Vous pouvez aussi accéder aux tâches directement à partir de la ligne de commande:

$ cake sea sound

De plus, le nom de la task doit être ajouté en tout que sous commande dans l’OptionParser du Shell:

public function getOptionParser()
{
    $parser = parent::getOptionParser();
    $parser->addSubcommand('sound', [
        // Fournit un texte d'aide pour la liste des commandes
        'help' => 'Execute The Sound Task.',
        // Lie les parsers d'option.
        'parser' => $this->Sound->getOptionParser(),
    ]);
    return $parser;
}

$project = $this->Tasks->load('Project');

$progressBar = $this->Tasks->load('ProgressBar.ProgressBar');

namespace App\Shell;

use Cake\Console\Shell;

class UserShell extends Shell
{

    public function initialize()
    {
        parent::initialize();
        $this->loadModel('Users');
    }

    public function show()
    {
        if (empty($this->args[0])) {
            // Utilisez error() avant CakePHP 3.2
            return $this->abort("Merci de rentrer un nom d'utilisateur.");
        }
        $user = $this->Users->findByUsername($this->args[0])->first();
        $this->out(print_r($user, true));
    }
}

Shell Helpers¶

Si vous avez une logique complexe de génération de sortie, vous pouvez utiliser les Shell Helpers pour encapsuler cette logique d’une manière réutilisable.

Appeler d’autres Shells à partir de votre Shell¶

Il y a effectivement beaucoup de cas où vous voulez appeler un shell à partir d’un autre. Shell::dispatchShell() vous donne la possibilité d’appeler d’autres shells en fournissant le argv pour le shell sub. Vous pouvez fournir des arguments et des options soit en variables args ou en chaînes de caractères:

// En chaînes de caractère
$this->dispatchShell('schema create Blog --plugin Blog');

// En tableau
$this->dispatchShell('schema', 'create',  'Blog', '--plugin',  'Blog');

Ce qui est au-dessus montre comment vous pouvez appeler le shell schema pour un plugin à partir du shell de votre plugin.

// En passant la commande via une chaîne
$this->dispatchShell([
   'command' => 'schema create Blog --plugin Blog',
   'extra' => [
        'foo' => 'bar'
    ]
]);

// En passant la commande via un tableau
$this->dispatchShell([
   'command' => ['schema', 'create', 'Blog', '--plugin', 'Blog'],
   'extra' => [
        'foo' => 'bar'
    ]
]);

Récupérer les Entrées de l’Utilisateur¶

Cake\Console\Shell::in($question, $choices = null, $default = null)¶

Quand vous construisez des applications pour console, vous avez besoin des entrées de l’utilisateur. CakePHP a un moyen facile de le faire:

// Récupère un texte arbitraire de l'utilisateur.
$color = $this->in('What color do you like?');

// Récupère un choix de l'utilisateur.
$selection = $this->in('Red or Green?', ['R', 'G'], 'R');

La validation de la sélection est sensible à la casse.

Créer des Fichiers¶

Cake\Console\Shell::createFile($path, $contents)¶

Beaucoup d’applications Shell aident à automatiser les tâches de développement et de déploiement. Créer des fichiers est souvent important dans ces cas d’utilisation. CakePHP fournit un moyen facile pour créer un fichier pour un chemin donné:

$this->createFile('bower.json', $stuff);

Si le Shell est interactif, un avertissement sera généré, et il sera demandé à l’utilisateur s’il veut écraser le fichier s’il existe déjà. Si la propriété interactive du shell est à false, aucune question ne sera posée et le fichier sera simplement écrasé.

Sortie de la Console¶

La classe Shell fournit quelques méthodes pour afficher le contenu:

// Ecrire avec stdout
$this->out('Message Normal');

// Ecrire avec stderr
$this->err('Message d\'erreur');

// Ecrire avec stderr et lancer une exception
$this->abort('Fatal error');

// Avant CakePHP 3.2. Ecrire avec stderr et exit()
$this->error('Erreur Fatale');

Elle fournit aussi deux méthodes pratiques en ce qui concerne le niveau de sortie:

// Apparaîtrait seulement quand la sortie verbeuse est activée (-v)
$this->verbose('Message verbeux');

// Apparaîtrait à tous les niveaux.
$this->quiet('Message silencieux');

Le Shell a aussi quelques méthodes pour nettoyer la sortie, créer des lignes blanches, ou dessiner une ligne de tirets:

// Affiche 2 newlines
$this->out($this->nl(2));

// Nettoie l'écran de l'utilisateur
$this->clear();

// Dessine une ligne horizontale
$this->hr();

Enfin, vous pouvez mettre à jour la ligne courante du texte sur l’écran en utilisant _io->overwrite():

$this->out('Counting down');
$this->out('10', 0);
for ($i = 9; $i > 0; $i--) {
    sleep(1);
    $this->_io->overwrite($i, 0, 2);
}

Il est important de se rappeler que vous ne pouvez pas écraser le texte une fois qu’une nouvelle ligne a été affichée.

Niveaux de sortie de la Console¶

Les Shells ont souvent besoin de différents niveaux de verbosité. Quand vous lancez une tâche cron, la plupart des sorties ne sont pas nécessaires. Et il y a des fois où vous n’êtes pas intéressés dans tout ce qu’un shell a à dire. Vous pouvez utiliser des niveaux de sortie pour signaler la sortie de façon appropriée. L’utilisateur du shell peut ensuite décider pour quel niveau de détail ils sont intéressés en configurant le bon flag quand on appelle le shell. Cake\Console\Shell::out() supporte 3 types de sortie par défaut.

• QUIET - Seulement des informations importantes doivent être marquées pour une paisible.

• NORMAL - Le niveau par défaut, et un usage normal.

• VERBOSE - Les messages marqués qui peuvent être trop ennuyeux pour une utilisation quotidienne, mais aide au debugging en VERBOSE.

Vous pouvez marquer la sortie comme suit:

// apparaitra à tous les niveaux.
$this->out('Quiet message', 1, Shell::QUIET);
$this->quiet('Quiet message');

// n'apparaitra pas quand une sortie quiet est togglé
$this->out('message normal', 1, Shell::NORMAL);
$this->out('message loud', 1, Shell::VERBOSE);
$this->verbose('Verbose output');

// would only appear when verbose output is enabled.
$this->out('extra message', 1, Shell::VERBOSE);
$this->verbose('Verbose output');

Vous pouvez contrôler le niveau de sortie des shells, en utilisant les options --quiet et --verbose. Ces options sont ajoutées par défaut, et vous autorise à contrôler la cohérence du niveau de sortie à l’intérieur de vos shells CakePHP.

Les options de console --quiet et --verbose contrôlent également les données sont loguées sont envoyées à stdout/stderr. Normalement, info et les message de log de plus haut niveau sont envoyés vers stdout/stderr. Lorsque --verbose est utilisé, les logs de debug seront envoyés à stdout. Lorsque --quiet est utilisé, seulement les warning et messages plus haut seront envoyés à stderr.

Style de sortie¶

La Style de sortie est fait en incluant les tags - juste comme le HTML - dans votre sortie.

ConsoleOutput remplacera ces tags avec la bonne séquence de code ansi, ou supprimera les tags si vous êtes sur une console qui ne supporte pas les codes ansi. Il y a plusieurs styles intégrés, et vous pouvez en créer plus. Ceux intégrés sont:

• success Message de succès. Texte vert.

• error Messages d’Erreur. Texte rouge.

• warning Messages d’avertissement. Texte jaune.

• info Messages d’informations. Texte cyan.

• comment Texte supplémentaire. Texte bleu.

• question Texte qui est une question, ajouté automatiquement par shell.

Vous pouvez créer des styles supplémentaires en utilisant $this->stdout->styles(). Pour déclarer un nouveau style de sortie, vous pouvez faire:

$this->_io->styles('flashy', ['text' => 'magenta', 'blink' => true]);

Cela vous permettra d’utiliser un tag <flashy> dans la sortie de votre shell, et si les couleurs ansi sont activées, ce qui suit sera rendu en texte magenta clignotant $this->out('<flashy>Whoooa</flashy> Quelque chose a posé problème');. Quand vous définissez les styles, vous pouvez utiliser les couleurs suivantes pour les attributs text et background:

• black

• blue

• cyan

• green

• magenta

• red

• white

• yellow

Vous pouvez aussi utiliser les options suivantes en commutateurs booléens, en les définissant à une valeur true qui les active.

• blink

• bold

• reverse

• underline

Ajouter un style le rend aussi disponible pour toutes les instances de ConsoleOutput, donc vous n’avez pas à re-déclarer les styles pour les deux objets stdout et stderr.

$this->_io->outputAs(ConsoleOutput::RAW);

Arrêter l’Exécution d’un Shell¶

Lorsque vos commandes shell ont atteint une condition où vous souhaitez que l’exécution s’arrête, vous pouvez utiliser abort() pour lancer une StopException qui arrêtera le process:

$user = $this->Users->get($this->args[0]);
if (!$user) {
    // Arrête avec un message et un code d'erreur.
    $this->abort('Utilisateur non trouvé', 128);
}

namespace App\Shell\Task;

use Cake\Console\Shell;

class ErroneousShell extends Shell
{
    public function main()
    {
        return true;
    }

    public function itFails()
    {
        return false;
    }

    public function itFailsSpecifically()
    {
        throw new StopException("", 2);
    }
}

$ bin/cake erroneousshell ; echo $?
0
$ bin/cake erroneousshell itFails ; echo $?
1
$ bin/cake erroneousshell itFailsSpecifically ; echo $?
2

Méthodes Hook¶

Cake\Console\Shell::initialize()¶

Initialize le constructeur du shell pour les sous-classes et permet la configuration de tâches avant l’exécution du shell.

Cake\Console\Shell::startup()¶

Démarre le Shell et affiche le message d’accueil. Permet de vérifier et de configurer avant de faire la commande ou l’exécution principale.

Configurer les options et générer de l’aide¶

class Cake\Console\ConsoleOptionParser¶

ConsoleOptionParser helps provide a more familiar command line option and argument parser.

OptionParsers vous permet d’accomplir deux buts en même temps. Premièrement, il vous permet de définir les options et arguments, séparant la validation basique des entrées et votre code. Deuxièmement, il vous permet de fournir de la documentation, qui est utilisée pour bien générer le fichier d’aide formaté.

La console du framework récupère votre parser d’option du shell en appelant $this->getOptionParser(). Surcharger cette méthode vous permet de configurer l’OptionParser pour faire correspondre les entrées attendues de votre shell. Vous pouvez aussi configurer les parsers d’option des sous-commandes, ce qui vous permet d’avoir des parsers d’option différents pour les sous-commandes et les tâches. ConsoleOptionParser implémente une interface courant et inclut les méthodes pour configurer les multiple options/arguments en une fois:

public function getOptionParser()
{
    $parser = parent::getOptionParser();
    //configure parser
    return $parser;
}

public function getOptionParser()
{
    $parser = parent::getOptionParser();
    $parser->addArgument('type', [
        'help' => 'Either a full path or type of class.'
    ])->addArgument('className', [
        'help' => 'A CakePHP core class name (e.g: Component, HtmlHelper).'
    ])->addOption('method', [
        'short' => 'm',
        'help' => __('The specific method you want help on.')
    ])->setDescription(__('Lookup doc block comments for classes in CakePHP.'));
    return $parser;
}

// Définit plusieurs lignes en une fois
$parser->setDescription(['line one', 'line two']);
// Avant 3.4
$parser->description(['line one', 'line two']);

// Lit la valeur actuelle
$parser->getDescription()

/**
 * Display help for this console.
 *
 * @return ConsoleOptionParser
 */
public function getOptionParser()
{
    $parser = new ConsoleOptionParser('console');
    $parser->setDescription(
        'This shell provides a REPL that you can use to interact ' .
        'with your application in an interactive fashion. You can use ' .
        'it to run adhoc queries with your models, or experiment ' .
        'and explore the features of CakePHP and your application.' .
        "\n\n" .
        'You will need to have psysh installed for this Shell to work.'
    );
    return $parser;
}

$ bin/cake console --help

Welcome to CakePHP v3.0.13 Console
---------------------------------------------------------------
App : src
Path: /home/user/cakeblog/src/
---------------------------------------------------------------
This shell provides a REPL that you can use to interact with your
application in an interactive fashion. You can use it to run adhoc
queries with your models, or experiment and explore the features of
CakePHP and your application.

You will need to have psysh installed for this Shell to work.

Usage:
cake console [-h] [-v] [-q]

Options:

--help, -h     Display this help.
--verbose, -v  Enable verbose output.
--quiet, -q    Enable quiet output.

$parser->setHelpAlias('my-shell');

Usage:
my-shell console [-h] [-v] [-q]

// Définit plusieurs lignes en une fois
$parser->setEpilog(['line one', 'line two']);
// Avant 3.4
$parser->epilog(['line one', 'line two']);

// Lit la valeur actuelle
$parser->getEpilog()

/**
 * Display help for this console.
 *
 * @return ConsoleOptionParser
 */
public function getOptionParser()
{
    $parser = new ConsoleOptionParser('console');
    $parser->setDescription(
        'This shell provides a REPL that you can use to interact ' .
        'with your application in an interactive fashion. You can use ' .
        'it to run adhoc queries with your models, or experiment ' .
        'and explore the features of CakePHP and your application.' .
        "\n\n" .
        'You will need to have psysh installed for this Shell to work.'
    );
    $parser->setEpilog('Thank you for baking with CakePHP!');
    return $parser;
}

$ bin/cake console --help

Welcome to CakePHP v3.0.13 Console
---------------------------------------------------------------
App : src
Path: /home/user/cakeblog/src/
---------------------------------------------------------------
This shell provides a REPL that you can use to interact with your
application in an interactive fashion. You can use it to run adhoc
queries with your models, or experiment and explore the features of
CakePHP and your application.

You will need to have psysh installed for this Shell to work.

Usage:
cake console [-h] [-v] [-q]

Options:

--help, -h     Display this help.
--verbose, -v  Enable verbose output.
--quiet, -q    Enable quiet output.

Thank you for baking with CakePHP!

$parser->addArgument('model', ['help' => 'The model to bake']);

$parser->addArguments([
    'node', ['help' => 'The node to create', 'required' => true],
    'parent' => ['help' => 'The parent node', 'required' => true]
]);

$parser->addArgument('type', [
    'help' => 'Le type de nœud avec lequel interagir.',
    'required' => true,
    'choices' => ['aro', 'aco']
]);

$parser->addOption('connection', [
    'short' => 'c'
    'help' => 'connection',
    'default' => 'default'
]);

$parser->addOption('no-commit', ['boolean' => true]);

$parser->addOptions([
    'node', ['short' => 'n', 'help' => 'The node to create'],
    'parent' => ['short' => 'p', 'help' => 'The parent node']
]);

$parser->addOption('accept', [
    'help' => 'What version to accept.',
    'choices' => ['working', 'theirs', 'mine']
]);

$parser->addOption('verbose', [
    'help' => 'Enable verbose output.',
    'boolean' => true
]);

if ($this->params['verbose']) {
    // faire quelque chose
}

$parser->addSubcommand('model', [
    'help' => 'Bake a model',
    'parser' => $this->Model->getOptionParser()
]);

$parser->addSubcommand('check', [
    'help' => __('Check the permissions between an ACO and ARO.'),
    'parser' => [
        'description' => [
            __("Use this command to grant ACL permissions. Once executed, the "),
            __("ARO specified (and its children, if any) will have ALLOW access "),
            __("to the specified ACO action (and the ACO's children, if any).")
        ],
        'arguments' => [
            'aro' => ['help' => __('ARO to check.'), 'required' => true],
            'aco' => ['help' => __('ACO to check.'), 'required' => true],
            'action' => ['help' => __('Action to check')]
        ]
    ]
]);

public function getOptionParser()
{
    return ConsoleOptionParser::buildFromArray([
        'description' => [
            __("Use this command to grant ACL permissions. Once executed, the "),
            __("ARO specified (and its children, if any) will have ALLOW access "),
            __("to the specified ACO action (and the ACO's children, if any).")
        ],
        'arguments' => [
            'aro' => ['help' => __('ARO to check.'), 'required' => true],
            'aco' => ['help' => __('ACO to check.'), 'required' => true],
            'action' => ['help' => __('Action to check')]
        ]
    ]);
}

$parser->merge($anotherParser);

cake bake --help
cake bake -h

cake bake model --help
cake bake model -h

cake bake --help xml
cake bake -h xml

<?xml version="1.0"?>
<shell>
    <command>bake fixture</command>
    <description>Generate fixtures for use with the test suite. You can use
        `bake fixture all` to bake all fixtures.</description>
    <epilog>
        Omitting all arguments and options will enter into an interactive
        mode.
    </epilog>
    <subcommands/>
    <options>
        <option name="--help" short="-h" boolean="1">
            <default/>
            <choices/>
        </option>
        <option name="--verbose" short="-v" boolean="1">
            <default/>
            <choices/>
        </option>
        <option name="--quiet" short="-q" boolean="1">
            <default/>
            <choices/>
        </option>
        <option name="--count" short="-n" boolean="">
            <default>10</default>
            <choices/>
        </option>
        <option name="--connection" short="-c" boolean="">
            <default>default</default>
            <choices/>
        </option>
        <option name="--plugin" short="-p" boolean="">
            <default/>
            <choices/>
        </option>
        <option name="--records" short="-r" boolean="1">
            <default/>
            <choices/>
        </option>
    </options>
    <arguments>
        <argument name="name" help="Name of the fixture to bake.
            Can use Plugin.name to bake plugin fixtures." required="">
            <choices/>
        </argument>
    </arguments>
</shell>

Renommer des Commandes¶

Par défaut, CakePHP va automatiquement chercher et mettre à disposition toutes les commandes dans votre application et ses plugins. Il est possible que vous souhaitiez réduire le nombre de commandes exposées lorsque vous construisez une application console indépendante. Pour cela, vous pouvez utiliser le hook console() de votre Application pour limiter le nombre de commandes qui sont exposées:

namespace App;

use App\Shell\UserShell;
use App\Shell\VersionShell;
use Cake\Http\BaseApplication;

class Application extends BaseApplication
{
    public function console($commands)
    {
        // Ajout par nom de de classe
        $commands->add('user', UserShell::class);

        // Ajout par une instance
        $commands->add('version', new VersionShell());

        return $commands;
    }
}

Dans l’exemple ci-dessus, les seules commandes qui seront disponibles seront help, version and user.

Routing dans shells / CLI¶

Dans l’interface en ligne de commande (CLI), spécialement dans vos shells et tasks, env('HTTP_HOST') et les autres variables d’environnement spécifiques à votre navigateur ne sont pas définies.

Si vous générez des rapports ou envoyez des emails qui utilisent Router::url(), ceux-ci vont contenir l’hôte par défaut http://localhost/ et cela va entrainer des URLs invalides. Dans ce cas, vous devrez spécifier le domaine manuellement. Vous pouvez faire cela en utilisant la valeur de Configure App.fullBaseUrl de votre bootstrap ou config, par exemple.

Pour envoyer des emails, vous devrez fournir à la classe Email l’hôte avec lequel vous souhaitez envoyer l’email en faisant:

use Cake\Mailer\Email;

$email = new Email();
// Avant 3.4 utilisez domain()
$email->setDomain('www.example.org');

Cela suppose que les ID du message généré sont valides et correspondent au domaine duquel les emails sont envoyés.

Commandes¶

Plus de sujets¶