README

这个Laravel 4包是一个简单包装器类的另一个分支，用于shell命令（exec）。它允许你添加exec()命令到你的应用程序中，而不会失去编写单元测试的能力。该包附带了一个外观（Facade），因此使用Mockery进行测试变得轻而易举。

此包在Windows系统上无法工作。

新增功能

这个分支仅仅添加了runBackground()方法。请谨慎使用，这可能不适合你。

安装

只需使用composer

$ php composer.phar require iyank4/l4shell:1.2.2

或者手动将需求添加到composer.json文件中

"require": {
     "iyank4/l4shell": "1.2.2"
}

在包成功加载后，你必须将其添加到服务提供者数组中

// app/config/app.php
'providers' => array(
	...
	'Netson\L4shell\L4shellServiceProvider',
);

服务提供者会自动注册别名，但如果你想知道，这是它的样子

'L4shell' => 'Netson\L4shell\Facades\Command'

用法

此包会转义整个命令（使用escapeshellcmd()）和每个单独的参数（使用escapdeshellarg()）。几乎所有方法都允许对象链，便于设置。

初始化一个新的命令

这可以通过在服务提供者中注册的快捷方式来完成

$command = L4shell::get();

或者通过手动创建一个新对象

$command = new \Netson\L4shell\Command("command", array("arg1", "arg2"));

使用get()方法将初始化一个空的命令对象，并要求你在执行命令之前使用setCommand()和setArguments()方法（可选）。

示例命令：无参数

$command = L4shell::get();
$result = $command->setCommand('hostname')->execute();

如果命令执行成功，将返回命令的输出。如果命令无法执行，将抛出异常，包括命令的错误消息（除使用sendToDevNull()方法外；见下文）。

示例命令：带参数

在添加参数时，请确保添加正确数量的占位符（sprintf格式），否则将抛出异常。

$command = L4shell::get();
$result = $command->setCommand('hostname %s')->setArguments(array("-s"))->execute();

默认情况下，当你调用setArguments()方法时，任何现有的参数都会被替换，以避免在一系列连续的命令中堆叠参数。但是，如果你希望分几个步骤添加它们，可以通过向方法传递第二个（可选）布尔参数来实现。

$command = L4shell::get();
$command->setCommand('ls %s %s')->setArguments(array("-a"));
// do something else ...
$command->setArguments(array("-l"), true); // add the optional second argument to keep existing arguments
$result = $command->execute();

如果你想手动清除任何现有的参数，请使用以下方法

$command = L4shell::get();
$command->clearArguments();

示例命令：将输出发送到/dev/null

此包有一个简单的方法可以将命令的输出发送到/dev/null，因为经常你可能只对退出状态感兴趣，而不是输出文本。将输出发送到/dev/null将使任何输出消息变得无用，但当然，退出代码仍然可用，当发生错误时将抛出异常。

$command = L4shell::get();
$result = $command->setCommand("hostname")->sendToDevNull()->execute(); // will return exit code (0), but no output message

示例命令：启用所有命令的日志记录

L4shell允许你轻松地将所有对shell命令的调用记录到默认的Laravel日志。默认情况下，记录是启用的。记录使用默认的Laravel 4日志包（Monolog）。

对于每个成功的命令，将出现3或4行日志，具体取决于是否设置了参数

设置命令 ...
设置参数 ...（可选）
执行命令 ...
命令成功执行

要禁用日志记录，发布包配置文件

$ php artisan config:publish iyank4/l4shell

然后更改 enable_logging 选项，位置在 app/config/packages/iyank4/l4shell/config.php 文件中。

或者，您可以在运行时更改日志设置

$command = L4shell::get();
$result = $command->setLogging(true)->setCommand("hostname")->execute();

设置和取消执行路径

如果您希望在特定目录中执行命令，可以使用以下方法

$command = L4shell::get();
$result = $command->setExecutionPath("/path/to/your/folder")->setCommand("ls")->execute();

执行路径是一个静态变量，这意味着如果只设置一次，将会影响之后所有执行的所有命令。

注意： 在执行命令之前更改执行路径，命令执行后立即恢复到原始设置。这样您不需要记住恢复工作目录，也不会干扰后续运行的脚本。

如果您想取消执行路径，只需调用该方法不传递任何参数

$command = L4shell::get();
$result = $command->setExecutionPath()->setCommand("ls")->execute();

设置和取消可执行路径

如果包含您的可执行文件的文件夹不在执行命令的用户路径中，您可以使用以下方法

$command = L4shell::get();
$result = $command->setExecutablePath("/usr/bin")->setCommand("ls")->execute();

这将有效地将您的命令从简单的 $ ls 变为 $ /usr/bin/ls。这也是一个静态变量，意味着设置将在多个命令之间持续。

如果您想取消可执行路径（例如从本地目录运行命令），只需调用该方法不传递任何参数

$command = L4shell::get();
$result = $command->setExecutablePath()->setCommand("ls")->execute();

防止某些字符被转义

当您有一个特定的shell命令需要使用会被 escapeshellcmd() 或 escapeshellarg() 函数转义的字符时，可以使用 setAllowedCharacters() 方法。此方法接受一个数组，其中的字符将不会被 L4shell 转义

$command = L4shell::setCommand('find ./ -maxdepth 1 -name %s')->setArguments(array("*.txt"))->setAllowedCharacters(array("*"));
// returned with allowed characters: find ./ -maxdepth 1 -name '*.txt'
// returned without allowed characters: find ./ -maxdepth 1 -name '\*.txt'

由于此方法完全绕过了潜在危险字符的转义，请务必谨慎使用此方法！！

单元测试

使用 L4shell 时，对模块/包进行单元测试很简单。只需在测试中使用 Mockery 风格的调用即可

public function testSomething ()
{
    L4shell::shouldReceive('get')->once();
    L4shell::shouldReceive('execute')->once()->andReturn("your message");
}
public function tearDown ()
{
    \Mockery::close();
}

有关使用 Laravel 4 进行单元测试的更多信息，请参阅以下文档

mertyildiran / l5shell

维护者

详细信息