* * 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:----TW8Gx9bN3aW3Runs/4PDVWA94PP11mlQyg8CStgMS1YZezVYdsacdqWc7XnjNAEyHtLooQrr6i4jRmkQX5fIVM0qG50fiiLsZBsmV54yEJ/xBOExQCCXllcOMnRWTfJM0GpeuiH9vaqxZFguECQZJ0M4Khk3KGxsSXP/f7zZ/OQ02PhOXjN2Otpsx20TV0cMgnaYr+6OGc2Y+sHN9JhL6707e/rKUPawlcEehAN3+ydLepZrGvMvxprJBjNd3eNPgKz8aIKYyZRQSj5lCuXMmu+szYF7to7UZcI5J9/dgHtXlOeQmxfZ8d63tblv8MXKb3UjFXWLYVDJJ7+tE0oygdRkRlyrghkSaByUt//q9rBwHZ7S1uf3J5S0Av6ITzGqN/ehFt0JdTThyaSFGWRQ2fu8m3rRaxWDj9PNWxZzPMd3MdHt5eXEH2uWdw0H5wfG7ZiRhebWnkp6oSfc9eX0+aYIkRUOWqPS4j+u0i2pBamh4fVQK/GfDTYPggUnDZyFXJJ+7t20JH5288ZPsht2v6RDlhwkNWMePZiUMlswNuni7YJZAWvmPBxS9rlVXM7UBqsdUapc38J+hkz2X5TaH+UFx6VFskWctfZAoSNSRifZBOgB8BHRG+UAxI60J1VXbrrQFnK537uy6qh8QAIMa8pyfY5JVBMjwhpDr6kIzF0=----ATTACHMENT:----MTA5OTc5MDY1ODUzMjE4OCA3MTIyOTU3NzgyMTczNjg0IDc4ODk4NjAxNzI4MDgxNDk=