[李景山php]每天TP5-20170124|thinkphp5-Process.php-6

/**
* 返回导致子进程终止其执行的数。
* @return int
*/
public function getTermSignal()
{// 返回 子进程 终止其执行的数
$this->requireProcessIsTerminated(__FUNCTION__);// 确认 进程 函数 已经终止，否则 抛出异常

if ($this->isSigchildEnabled()) {// 确认是否 子进程
throw new \RuntimeException('This PHP has been compiled with --enable-sigchild. Term signal can not be retrieved.');
}

$this->updateStatus(false);// 阻塞 非阻塞 连接池 连接等待

return $this->processInformation['termsig'];// 返回 终止 异常数据
}

/**
* 检查子进程信号是否已停止
* @return bool
*/
public function hasBeenStopped()
{
$this->requireProcessIsTerminated(__FUNCTION__);// 如果停止通过

$this->updateStatus(false);// 状态 检查 通过

return $this->processInformation['stopped'];// 进程停止信息
}

/**
* 返回导致子进程停止其执行的数。
* @return int
*/
public function getStopSignal()
{
$this->requireProcessIsTerminated(__FUNCTION__);

$this->updateStatus(false);

return $this->processInformation['stopsig'];
}// 停止的 情况

/**
* 检查是否正在运行
* @return bool
*/
public function isRunning()
{
if (self::STATUS_STARTED !== $this->status) {
return false;
}// 是否跑起来了

$this->updateStatus(false);// 检测是否是关闭状态

return $this->processInformation['running'];// 返回提示语句
}

/**
* 检查是否已开始
* @return bool
*/
public function isStarted()
{
return $this->status != self::STATUS_READY;// 直接根据 启动标志位进行 返回检测
}

/**
* 检查是否已终止
* @return bool
*/
public function isTerminated()
{
$this->updateStatus(false);// 如果没有关闭

return $this->status == self::STATUS_TERMINATED;// 进行 终止 检测
}

/**
* 获取当前的状态
* @return string
*/
public function getStatus()
{
$this->updateStatus(false);// 获取当前状态

return $this->status;// 返回当前状态信息
}

/**
* 终止进程
*/
public function stop()
{// 终止进程
if ($this->isRunning()) {// 是否运行
if ('\\' === DS && !$this->isSigchildEnabled()) {
exec(sprintf('taskkill /F /T /PID %d 2>&1', $this->getPid()), $output, $exitCode);// 返回 linux 命令
if ($exitCode > 0) {// 如果执行状态
throw new \RuntimeException('Unable to kill the process');// 异常情况
}
} else {
$pids = preg_split('/\s+/', `ps -o pid --no-heading --ppid {$this->getPid()}`);// 产看 pid 信息
foreach ($pids as $pid) {// 循环遍历
if (is_numeric($pid)) {// 数字进程
posix_kill($pid, 9); // 杀死进程
}
}
}
}

$this->updateStatus(false);// 更新状态
if ($this->processInformation['running']) {// 如果还在运行中
$this->close();// 关闭
}

return $this->exitcode;// 返回退出代码
}

/**
* 添加一行输出
* @param string $line
*/
public function addOutput($line)
{
$this->lastOutputTime = microtime(true);
$this->stdout .= $line;
}// 添加输出信息 并且 更新最后的输出时间

/**
* 添加一行错误输出
* @param string $line
*/
public function addErrorOutput($line)
{
$this->lastOutputTime = microtime(true);
$this->stderr .= $line;// 行信息
}// 添加一行错误输出

/**
* 获取被执行的指令
* @return string
*/
public function getCommandLine()
{
return $this->commandline;
}// 获取执行的指令

/**
* 设置指令
* @param string $commandline
* @return self
*/
public function setCommandLine($commandline)
{
$this->commandline = $commandline;

return $this;
}// 设置指令

/**
* 获取超时时间
* @return float|null
*/
public function getTimeout()
{
return $this->timeout;
}// 获取超时 时间

/**
* 获取idle超时时间
* @return float|null
*/
public function getIdleTimeout()
{
return $this->idleTimeout;
}// 获取 idle 超时时间

/**
* 设置超时时间
* @param int|float|null $timeout
* @return self
*/
public function setTimeout($timeout)
{
$this->timeout = $this->validateTimeout($timeout);

return $this;
}// 设置 超时 时间

/**
* 设置idle超时时间
* @param int|float|null $timeout
* @return self
*/
public function setIdleTimeout($timeout)
{
if (null !== $timeout && $this->outputDisabled) {
throw new \LogicException('Idle timeout can not be set while the output is disabled.');
}

$this->idleTimeout = $this->validateTimeout($timeout);

return $this;
}// 设置 idle 超时 时间

/**
* 设置TTY
* @param bool $tty
* @return self
*/
public function setTty($tty)
{
if ('\\' === DS && $tty) {// 如果是 \\ 并且 需要设置 tty 这样的话，证明在 window平台下
throw new \RuntimeException('TTY mode is not supported on Windows platform.');
}
if ($tty && (!file_exists('/dev/tty') || !is_readable('/dev/tty'))) {// tty 必须可以读取
throw new \RuntimeException('TTY mode requires /dev/tty to be readable.');
}

$this->tty = (bool)$tty;// 把当前的 tty 进行 数据类型强制转化

return $this;// 返回当前类
}

/**
* 检查是否是tty模式
* @return bool
*/
public function isTty()// 是否 tty 模式
{
return $this->tty;
}

/**
* 设置pty模式
* @param bool $bool
* @return self
*/
public function setPty($bool)// 设置 pty 模式
{
$this->pty = (bool)$bool;

return $this;
}

/**
* 是否是pty模式
* @return bool
*/
public function isPty()// 是否 pty 模式
{
return $this->pty;
}

/**
* 获取工作目录
* @return string|null
*/
public function getWorkingDirectory()// 获取当前工作目录， 让我想起来了 linux pwd 命令
{
if (null === $this->cwd) {
return getcwd() ?: null;
}

return $this->cwd;
}

/**
* 设置工作目录
* @param string $cwd
* @return self
*/
public function setWorkingDirectory($cwd)// 设置目录
{
$this->cwd = $cwd;

return $this;
}

/**
* 获取环境变量
* @return array
*/
public function getEnv()// 获取环境变量
{
return $this->env;
}

/**
* 设置环境变量
* @param array $env
* @return self
*/
public function setEnv(array $env)// 设置环境变量
{
$env = array_filter($env, function ($value) {
return !is_array($value);
});

$this->env = [];
foreach ($env as $key => $value) {
$this->env[(binary)$key] = (binary)$value;
}

return $this;
}// 过滤参数 并且 设置 数据