Symfony Console -- injecting additional top-level options/arguments at the program level

symfony-console-program-options-arguments.php

/**
 * php job-queue.php --environment=local [command|namespace:command]
 * php job-queue.php --environment=local job:monitor
 *
 * NOTE:
 *      looks like you can actually put the option anywhere...the folllowing works just fine
 *      > php job-queue.php job:monitor --environment=local 
 */

// inject custom required argument (execution halts if program is called without this argument)
$this->definition->addArguments(array(
    new InputArgument('environment', InputArgument::REQUIRED, 'application environment'),
));

// inject custom required option (option actually seems to be optional even though it is defined as required)
// From a command, you can now do:
// $input->getOption('environment')
$this->definition->addOptions(array(
    new InputOption('--environment', '-e', InputOption::VALUE_REQUIRED, 'application environment'),
));