Aller au contenu

Points d'extension

phil/console-bundle

Le paquet est en 0.x : ses points d'extension ne sont stables qu'à partir de sa version 1.0. D'ici là, une version mineure peut les modifier, et son CHANGELOG indique comment.

Ports écrits par l'application ou un autre paquet

DebugSwitch

Phil\ConsoleBundle\Application\Contract\DebugSwitch — ce que --debug-phil active. Remplacez le service phil_console.debug_switch pour afficher les enregistrements d'un autre journaliseur ou pour relever le niveau d'une autre bibliothèque de journalisation ; donnez-lui l'étiquette kernel.reset s'il conserve ce qu'il a activé.

MéthodeContrat
channels(): list<string>Les canaux qu'il connaît, dans l'ordre
enable(list<string> $channels, OutputInterface $output): voidÉcrit les enregistrements de ces canaux dans la sortie ; ignore les canaux inconnus
disable(): voidAnnule enable() ; ne fait rien si rien n'est activé
services:
    phil_console.debug_switch:
        class: App\Console\AuditLogSwitch
        tags: [kernel.reset]

MemoryGauge

Phil\ConsoleBundle\Application\Contract\MemoryGauge — la mémoire du sommaire. Remplacez le service phil_console.memory_gauge.

MéthodeContrat
usage(): intLes octets utilisés maintenant
peak(): intLe maximum d'octets utilisés

Services

ServiceRôle
phil_console.clockLe Psr\Clock\ClockInterface des horodatages et du sommaire ; remplacez-le par l'horloge de l'application
Phil\ConsoleBundle\Infrastructure\Console\CommandGuardReaderLes gardes d'une commande, pour un outil de l'application
Phil\ConsoleBundle\Application\EnvironmentGuardSoumet une commande à ses gardes dans l'environnement du noyau
services:
    phil_console.clock: '@clock'

Événements

Le bundle ne répartit aucun événement qui lui soit propre. Un refus est une exception EnvironmentRefused, que la console répartit avec console.error ; un écouteur de cet événement peut la journaliser ou lancer une alerte.

Exceptions

ExceptionQuand
Phil\ConsoleBundle\Domain\Exception\EnvironmentRefusedUne commande interdite, non confirmée ou non interactive là où une confirmation est nécessaire ; code 77
Phil\ConsoleBundle\Domain\Exception\InvalidGuardUn attribut sans l'environnement qu'il exige, ou avec un nom vide

Les deux implémentent Phil\ConsoleBundle\Domain\Exception\ConsoleException.