7288b93500
Add neutral diagnostic framework for future reporting modules: - DiagnosticReporterInterface, Registry, Manager, PayloadSanitizer - Laravel exception hook in bootstrap/app.php - Module permission declarations (requires_permissions in module.json) - Core diagnostic report points (module boot/install/update failures) - Module documentation update (moduldoku.md) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
120 lines
2.6 KiB
PHP
120 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace Safe;
|
|
|
|
use Safe\Exceptions\ExecException;
|
|
|
|
/**
|
|
* @param string $command
|
|
* @param array|null $output
|
|
* @param int|null $result_code
|
|
* @return string
|
|
* @throws ExecException
|
|
*
|
|
*/
|
|
function exec(string $command, ?array &$output = null, ?int &$result_code = null): string
|
|
{
|
|
error_clear_last();
|
|
$safeResult = \exec($command, $output, $result_code);
|
|
if ($safeResult === false) {
|
|
throw ExecException::createFromPhpError();
|
|
}
|
|
return $safeResult;
|
|
}
|
|
|
|
|
|
/**
|
|
* @param resource $process
|
|
* @return int
|
|
* @throws ExecException
|
|
*
|
|
*/
|
|
function proc_close($process): int
|
|
{
|
|
error_clear_last();
|
|
$safeResult = \proc_close($process);
|
|
if ($safeResult === -1) {
|
|
throw ExecException::createFromPhpError();
|
|
}
|
|
return $safeResult;
|
|
}
|
|
|
|
|
|
/**
|
|
* @param int $priority
|
|
* @throws ExecException
|
|
*
|
|
*/
|
|
function proc_nice(int $priority): void
|
|
{
|
|
error_clear_last();
|
|
$safeResult = \proc_nice($priority);
|
|
if ($safeResult === false) {
|
|
throw ExecException::createFromPhpError();
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* @param string $cmd
|
|
* @param array $descriptorspec
|
|
* @param null|resource[] $pipes
|
|
* @param null|string $cwd
|
|
* @param array|null $env
|
|
* @param array|null $other_options
|
|
* @return resource
|
|
* @throws ExecException
|
|
*
|
|
*/
|
|
function proc_open(string $cmd, array $descriptorspec, ?array &$pipes, ?string $cwd = null, ?array $env = null, ?array $other_options = null)
|
|
{
|
|
error_clear_last();
|
|
if ($other_options !== null) {
|
|
$safeResult = \proc_open($cmd, $descriptorspec, $pipes, $cwd, $env, $other_options);
|
|
} elseif ($env !== null) {
|
|
$safeResult = \proc_open($cmd, $descriptorspec, $pipes, $cwd, $env);
|
|
} elseif ($cwd !== null) {
|
|
$safeResult = \proc_open($cmd, $descriptorspec, $pipes, $cwd);
|
|
} else {
|
|
$safeResult = \proc_open($cmd, $descriptorspec, $pipes);
|
|
}
|
|
if ($safeResult === false) {
|
|
throw ExecException::createFromPhpError();
|
|
}
|
|
return $safeResult;
|
|
}
|
|
|
|
|
|
/**
|
|
* @param string $command
|
|
* @return null|string
|
|
* @throws ExecException
|
|
*
|
|
*/
|
|
function shell_exec(string $command): ?string
|
|
{
|
|
error_clear_last();
|
|
$safeResult = \shell_exec($command);
|
|
if ($safeResult === false) {
|
|
throw ExecException::createFromPhpError();
|
|
}
|
|
return $safeResult;
|
|
}
|
|
|
|
|
|
/**
|
|
* @param string $command
|
|
* @param int|null $result_code
|
|
* @return string
|
|
* @throws ExecException
|
|
*
|
|
*/
|
|
function system(string $command, ?int &$result_code = null): string
|
|
{
|
|
error_clear_last();
|
|
$safeResult = \system($command, $result_code);
|
|
if ($safeResult === false) {
|
|
throw ExecException::createFromPhpError();
|
|
}
|
|
return $safeResult;
|
|
}
|