traineratwot/php-cli

2.0.1 2022-10-23 10:19 UTC

This package is auto-updated.

Last update: 2024-09-30 01:30:24 UTC


README

PHP-CLI 是一个简单的库,可以帮助创建外观优美的命令行脚本。它负责:

  • 选项解析
  • 帮助页面生成
  • 自动宽度调整
  • 彩色输出
  • 提示
  • PSR-4 兼容性
  • 支持 PHP 版本 >= 8.1
  • 支持 Enum

使用 composer: php composer.phar require traineratwot/php-cli

用法和示例

最小示例

<?php
	namespace index;
	require dirname(__DIR__) . '/vendor/autoload.php';

	use Traineratwot\PhpCli\CLI;
	use Traineratwot\PhpCli\Cmd;
	use Traineratwot\PhpCli\commands\Help;
	use Traineratwot\PhpCli\Console;
	use Traineratwot\PhpCli\types\TEnum;
	use Traineratwot\PhpCli\types\TFloat;
	use Traineratwot\PhpCli\types\TInt;

	enum TestEnum
	{
		case test;
		case test1;
		case test2;
		case test3;
		case test4;
	}

	class Test2Enum extends TEnum
	{

		public function enums()
		{
			return scandir(__DIR__);
		}
	}

	class Test extends Cmd
	{

		public function help()
		{
			return "Description for auto help";
		}

		public function setup()
		{
			$this->registerParameter('param1', 1, TInt::class, "Description for param1");                            // value after action
			$this->registerOption('option1', 'o', 0, TFloat::class, "Description for option1");                      //--option1=value,--option1 value,-o=value,-o value
			$this->registerOption('option2', 'f', 0, [TestEnum::class, Test2Enum::class], "Description for option1");//--option1=value,--option1 value,-o=value,-o value
		}

		public function run()
		{
			var_dump($this->getArgs());
			var_dump($this->getArg('param1'));
			var_dump($this->getArg('option1'));
			var_dump($this->getArg('option2'));
		}
	}

	(new CLI())
		->registerDefaultCmd(new Help()) 
		->registerCmd('test', new Test()) //Create command from Class
		->registerCmd('test2', function ($options, $params) {
			var_dump($options);
			var_dump($params);
			Console::success("ok");
		})                        //Create command from Class callback, not support Auto Help
		->run()
	;