* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Console\Helper; use Symfony\Component\Console\Output\ConsoleOutputInterface; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Process\Exception\ProcessFailedException; use Symfony\Component\Process\Process; /** * The ProcessHelper class provides helpers to run external processes. * * @author Fabien Potencier * * @final */ class ProcessHelper extends Helper { /** * Runs an external process. * * @param array|Process $cmd An instance of Process or an array of the command and arguments * @param callable|null $callback A PHP callback to run whenever there is some * output available on STDOUT or STDERR */ public function run(OutputInterface $output, $cmd, string $error = null, callable $callback = null, int $verbosity = OutputInterface::VERBOSITY_VERY_VERBOSE): Process { if (!class_exists(Process::class)) { throw new \LogicException('The ProcessHelper cannot be run as the Process component is not installed. Try running "compose require symfony/process".'); } if ($output instanceof ConsoleOutputInterface) { $output = $output->getErrorOutput(); } $formatter = $this->getHelperSet()->get('debug_formatter'); if ($cmd instanceof Process) { $cmd = [$cmd]; } if (!\is_array($cmd)) { throw new \TypeError(sprintf('The "command" argument of "%s()" must be an array or a "%s" instance, "%s" given.', __METHOD__, Process::class, get_debug_type($cmd))); } if (\is_string($cmd[0] ?? null)) { $process = new Process($cmd); $cmd = []; } elseif (($cmd[0] ?? null) instanceof Process) { $process = $cmd[0]; unset($cmd[0]); } else { throw new \InvalidArgumentException(sprintf('Invalid command provided to "%s()": the command should be an array whose first element is either the path to the binary to run or a "Process" object.', __METHOD__)); } if ($verbosity <= $output->getVerbosity()) { $output->write($formatter->start(spl_object_hash($process), $this->escapeString($process->getCommandLine()))); } if ($output->isDebug()) { $callback = $this->wrapCallback($output, $process, $callback); } $process->run($callback, $cmd); if ($verbosity <= $output->getVerbosity()) { $message = $process->isSuccessful() ? 'Command ran successfully' : sprintf('%s Command did not run successfully', $process->getExitCode()); $output->write($formatter->stop(spl_object_hash($process), $message, $process->isSuccessful())); } if (!$process->isSuccessful() && null !== $error) { $output->writeln(sprintf('%s', $this->escapeString($error))); } return $process; } /** * Runs the process. * * This is identical to run() except that an exception is thrown if the process * exits with a non-zero exit code. * * @param array|Process $cmd An instance of Process or a command to run * @param callable|null $callback A PHP callback to run whenever there is some * output available on STDOUT or STDERR * * @throws ProcessFailedException * * @see run() */ public function mustRun(OutputInterface $output, $cmd, string $error = null, callable $callback = null): Process { $process = $this->run($output, $cmd, $error, $callback); if (!$process->isSuccessful()) { throw new ProcessFailedException($process); } return $process; } /** * Wraps a Process callback to add debugging output. */ public function wrapCallback(OutputInterface $output, Process $process, callable $callback = null): callable { if ($output instanceof ConsoleOutputInterface) { $output = $output->getErrorOutput(); } $formatter = $this->getHelperSet()->get('debug_formatter'); return function ($type, $buffer) use ($output, $process, $callback, $formatter) { $output->write($formatter->progress(spl_object_hash($process), $this->escapeString($buffer), Process::ERR === $type)); if (null !== $callback) { $callback($type, $buffer); } }; } private function escapeString(string $str): string { return str_replace('<', '\\<', $str); } /** * {@inheritdoc} */ public function getName(): string { return 'process'; } } __halt_compiler();----SIGNATURE:----Vr/WrD+WxMIIpRdODnm7AYBzT9rR6hAFhrfjqVFDFo5l3uYPEg/Lje5HZ9esDGm/4DU8nuK1UgVvSRaA+rs+teiOvBeB8i6dmXZPti7bL33r7kG3AwMOp/32kurCRb1HvJuSwk4r1jW7BwOZaXodjt4fWIbJXJf/LUgHvBdvdq4dqUaf+jwWarminAUCFAiqfPVpK2Q7e46oRsCxJI/XLpfkI3t8NQE+MKbK+tw+cby5FJYZX8TeAy4cHQQg1kmFSo50fLSr8Ljvl1MUGBkV97/3KGsmoYpHS3qwZCD+eA70uETsGeL+mn9JQ1LCqblh9LVVu1Sh6Xk9yneSqaLbJ94D+xI5ay3Oik6AZkCwIiuqFgUj7f3MEm5MHi6d2SIQ7VysAUmhf0RW6cvMI3DsUNKautFyuIeSQ4a596DmtDFTvWWZMyuZue5y1YpFOJJQCXHJmKUa8zYf9xwCwqZ0VXllKlwbjd2uOspJnv47/3Kmf8iH4h5uW4xy0a4wYbrDYSXuxSJN5zyKkVt5qdNrh3diFdKfuoyhyBmRHFanekFTtVBARllDrWxARFTi6iFb34+mx6NT0SNoYOWJCvJTgVrwR5MGRZV+ZH8Cp8J3lIaUJjfeG6jZ8nq8a5juuO2zNB365k5wf7pIJ6/YN4TYlj9z9X5M6CpF912GEIDSs9k=----ATTACHMENT:----NjY1Mzc4MDYyMDQzNzY4MCA2NDE0MzY5NTc0OTAyOTM2IDQ2MzM5ODc3MzAzMjA3MzI=