Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/duncan3dc/console
Create command line php applications using symfony/console
https://github.com/duncan3dc/console
cli php symfony
Last synced: 1 day ago
JSON representation
Create command line php applications using symfony/console
- Host: GitHub
- URL: https://github.com/duncan3dc/console
- Owner: duncan3dc
- License: apache-2.0
- Created: 2014-11-22T20:20:37.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2024-07-29T13:28:52.000Z (3 months ago)
- Last Synced: 2024-09-29T16:15:56.287Z (about 1 month ago)
- Topics: cli, php, symfony
- Language: PHP
- Size: 106 KB
- Stars: 15
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
console
=======
Create command line php applications using symfony/console.
This is basically a fork of symfony/console which does things a little differently and adds some extra features.
Most of the features are useful when running commands in a background context (such as via crontab).
[](https://packagist.org/packages/duncan3dc/console)
[](https://github.com/duncan3dc/console/actions?query=branch%3Amaster+workflow%3A.github%2Fworkflows%2Fbuildcheck.yml)
[](https://codecov.io/gh/duncan3dc/console)
Loading Commands
----------------
Commands can be automatically created from classes (meaning you don't need to call setName() inside your command class) using the following criteria:
* Files/classes must be named using CamelCase and must end in "Command" (with files having the .php extension)
* Each uppercase character will be converted to lowercase and preceded by a hyphen
* Directories will represent namespaces and each separater will be replaced with a colon
Using the example below, the file src/commands/Category/Topic/RunCommand.php will create a command called category:topic:run
```php
$application->loadCommands("src/commands");
```
_Of course, they can still be added the [symfony way](http://symfony.com/doc/current/components/console/introduction.html)_
Output
------
We use [league/climate](http://climate.thephpleague.com/) for terminal output, whilst also maintaining support for the [symfony way](http://symfony.com/doc/current/components/console/introduction.html#coloring-the-output).
So all of the following is possible:
```php
$output->blue()->out("Blue? Wow!");
$output->dump($complexArrayForCLImate);
$output->writeln("I am a symfony/console error");
$output->error("I am a league/climate error");
```
Time Limit Commands
-------------------
Commands can limit how long they are run for, and end in a controlled way when the limit is reached.
Inside your command's class you can call the timeout() method and pass the number of seconds your command should run for.
```php
class LimitedCommand extends \duncan3dc\Console\Command
{
protected function execute(InputInterface $input, OutputInterface $output)
{
while (true) {
# If the command has been running for more than 10 minutes then end now
if ($this->timeout(60 * 10)) {
break;
}
}
{
}
```
_This behaviour can be overridden by passing the ```--no-time-limit``` when running the application, this will cause the timeout() method to always return false_
Calling An Existing Command
---------------------------
The [symfony way](http://symfony.com/doc/current/components/console/introduction.html#calling-an-existing-command) of calling an existing command can be a little long-winded, with steps that seem unnecessary (eg, specifying the command name twice).
The runCommand() method provides a simplified way of doing this (using the example from the symfony docs):
```php
$returnCode = $this->getApplication()->runCommand("demo:greet", [
"name" => "Fabien",
"--yell" => true,
], $input, $output);
```
_This also ensures any command event listeners that have been registered are called, which symfony does not do_
Command Locking
---------------
All commands are automatically locked to prevent the same command being run simultaneously on the same host.
You can prevent particular commands from locking using the doNotLock() method:
```php
protected function configure()
{
$this
->doNotLock()
->setDescription("This command can run as many times as it likes, whether the previous run has finished or not");
}
```
_When a command cannot run it will exit with status 201, represented by the class constant Application::STATUS_LOCKED_
Tab Completion
--------------
Tab completion is provided by [stecman/symfony-console-completion](https://github.com/stecman/symfony-console-completion) and instructions on setting it up for your application can be found in the README.md of that repository.
Namespace Listing
-----------------
When you are entering commands in completion mode, it can often be useful to view the list of available commands in the namespace.
For example you might type `cat` then press tab which would complete the namespace, and the namespace separator:
```sh
:~$ console category:
```
But when you press tab again, you might be presented with a list of commands (or sub-namespaces) you don't entirely recognise. At this point the symfony way would be to delete the colon, run your cursor back to before your namespace, and type `list`:
```sh
:~$ console list category
```
Then having identified the command you need from the listing you would then need to type what you had earlier, before entering the command you require:
```sh
:~$ console category:
```
To make this use case easier, we have made running a command with a trailing colon, an alias for the list command shown above, so you can actually run:
```sh
:~$ console category:
```
Which will list all your available commands, then you can press the up arrow to retrieve that same command from your shell's history and carry on entering the command name, much quicker
## duncan3dc/console for enterprise
Available as part of the Tidelift Subscription
The maintainers of duncan3dc/console and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/packagist-duncan3dc-console?utm_source=packagist-duncan3dc-console&utm_medium=referral&utm_campaign=readme)