utopia-php / cli
A simple CLI library to manage command line applications
Installs: 166 636
Dependents: 10
Suggesters: 0
Security: 0
Stars: 39
Watchers: 9
Forks: 16
Open Issues: 9
Requires
- php: >=7.4
- utopia-php/di: 0.1.*
- utopia-php/framework: 1.0.*
Requires (Dev)
- laravel/pint: 1.2.*
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^9.3
- squizlabs/php_codesniffer: ^3.6
- swoole/ide-helper: 4.8.8
- dev-master
- 0.20.0
- 0.19.0
- 0.18.0
- 0.17.0
- 0.16.0
- 0.15.x-dev
- 0.15.1
- 0.15.0
- 0.14.0
- 0.13.0
- 0.12.0
- 0.11.0
- 0.10.0
- 0.9.0
- 0.8
- 0.7.3
- 0.7.2
- 0.7.1
- 0.7.0
- 0.6.2
- 0.6.1
- 0.6.0
- 0.5.0
- 0.4.0
- 0.3.0
- 0.2.0
- 0.1.x-dev
- v0.1.0
- dev-feat-upgrade-http
- dev-feat-framework-upgrade
- dev-feat-framework-v2
- dev-feat-logs-combine
- dev-feat-log-streaming
- dev-feat-trait-example
- dev-feat-loop-delay-and-accuracy
- dev-fix-linter
- dev-feat-console-mode
- dev-feat-allow-adding-task
- dev-fix-cli-readme
- dev-fix-exit-codes
- dev-feat-exception-handler
This package is auto-updated.
Last update: 2024-12-04 14:24:26 UTC
README
Utopia framework CLI library is simple and lite library for extending Utopia PHP Framework to be able to code command line applications. This library is aiming to be as simple and easy to learn and use. This library is maintained by the Appwrite team.
Although this library is part of the Utopia Framework project it is dependency free and can be used as standalone with any other PHP project or framework.
Getting Started
Install using composer:
composer require utopia-php/cli
script.php
<?php require_once './vendor/autoload.php'; use Utopia\CLI\CLI; use Utopia\CLI\Console; use Utopia\CLI\Adapters\Generic; use Utopia\Http\Validator\Wildcard; $cli = new CLI(new Generic()); $cli ->task('command-name') ->param('email', null, new Wildcard()) ->action(function ($email) { Console::success($email); }); $cli->run();
And than, run from command line:
php script.php command-name --email=me@example.com
Hooks
There are three types of hooks, init hooks, shutdown hooks and error hooks. Init hooks are executed before the task is executed. Shutdown hook is executed after task is executed before application shuts down. Finally error hooks are executed whenever there's an error in the application lifecycle. You can provide multiple hooks for each stage.
require_once __DIR__ . '/../../vendor/autoload.php'; use Utopia\CLI\CLI; use Utopia\CLI\Console; use Utopia\Http\Validator\Wildcard; CLI::setResource('res1', function() { return 'resource 1'; }) CLI::init() inject('res1') ->action(function($res1) { Console::info($res1); }); CLI::error() ->inject('error') ->action(function($error) { Console::error('Error occurred ' . $error); }); $cli = new CLI(); $cli ->task('command-name') ->param('email', null, new Wildcard()) ->action(function ($email) { Console::success($email); }); $cli->run();
Log Messages
Console::log('Plain Log'); // stdout
Console::success('Green log message'); // stdout
Console::info('Blue log message'); // stdout
Console::warning('Yellow log message'); // stderr
Console::error('Red log message'); // stderr
Execute Commands
Function returns exit code (0 - OK, >0 - error) and writes stdout, stderr to reference variables. The timeout variable allows you to limit the number of seconds the command can run.
$stdout = ''; $stderr = ''; $stdin = ''; $timeout = 3; // seconds $code = Console::execute('>&1 echo "success"', $stdin, $stdout, $stderr, $timeout); echo $code; // 0 echo $stdout; // 'success' echo $stderr; // ''
$stdout = ''; $stderr = ''; $stdin = ''; $timeout = 3; // seconds $code = Console::execute('>&2 echo "error"', $stdin, $stdout, $stderr, $timeout); echo $code; // 0 echo $stdout; // '' echo $stderr; // 'error'
Create a Daemon
You can use the Console::loop
command to create your PHP daemon. The loop
method already handles CPU consumption using a configurable sleep function and calls the PHP garbage collector every 5 minutes.
<?php use Utopia\CLI\Console; include './vendor/autoload.php'; Console::loop(function() { echo "Hello World\n"; }, 1 /* 1 second */);
System Requirements
Utopia Framework requires PHP 7.4 or later. We recommend using the latest PHP version whenever possible.
Copyright and license
The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php