merge the php-utils to the lib

Author: inhere

.php_cs

@@ -0,0 +1,43 @@
+<?php
+
+$header = <<<'EOF'
+This file is part of toolkit/sys-utils.
+
+@author   https://github.com/inhere
+@link     https://github.com/php-toolkit/sys-utils
+@license  MIT
+EOF;
+
+return PhpCsFixer\Config::create()
+    ->setRiskyAllowed(true)
+    ->setRules([
+        '@PSR2' => true,
+        'array_syntax' => [
+            'syntax' => 'short'
+        ],
+        'list_syntax' => [
+            'syntax' => 'short'
+        ],
+        'class_attributes_separation' => true,
+        'declare_strict_types' => true,
+        'global_namespace_import' => [
+            'import_constants' => true,
+            'import_functions' => true,
+        ],
+        'header_comment' => [
+            'comment_type' => 'PHPDoc',
+            'header'    => $header,
+            'separate'  => 'bottom'
+        ],
+        'no_unused_imports' => true,
+        'single_quote' => true,
+        'standardize_not_equals' => true,
+    ])
+    ->setFinder(
+        PhpCsFixer\Finder::create()
+            // ->exclude('test')
+            ->exclude('runtime')
+            ->exclude('vendor')
+            ->in(__DIR__)
+    )
+    ->setUsingCache(false);

composer.json

@@ -17,7 +17,8 @@
     }
   ],
   "require": {
-    "php": ">7.1.0"
+    "php": ">7.1.0",
+    "toolkit/stdlib": "^1.0"
   },
   "autoload": {
     "psr-4": {

example/proc-editor.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/sys-utils.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/sys-utils
+ * @license  MIT
+ */
+
+require dirname(__DIR__) . '/test/bootstrap.php';
+
+$editor = 'vim';
+\Toolkit\Sys\Proc\ProcWrapper::runEditor($editor, 'test.txt');

example/proc0.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/sys-utils.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/sys-utils
+ * @license  MIT
+ */
+
+require dirname(__DIR__) . '/test/bootstrap.php';

example/property_exists.php

@@ -0,0 +1,39 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/sys-utils.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/sys-utils
+ * @license  MIT
+ */
+
+class Some
+{
+    public $prop0;
+
+    private $prop1;
+
+    protected $prop2;
+
+    /**
+     * @return mixed
+     */
+    public function getProp1()
+    {
+        return $this->prop1;
+    }
+}
+
+
+echo "use class:\n";
+
+echo 'public: ' . (property_exists(Some::class, 'prop0') ? 'Y' : 'N') . PHP_EOL;
+echo 'private: ' . (property_exists(Some::class, 'prop1') ? 'Y' : 'N') . PHP_EOL;
+echo 'protected: ' . (property_exists(Some::class, 'prop2') ? 'Y' : 'N') . PHP_EOL;
+echo "use object:\n";
+
+$object = new Some();
+
+echo 'public: ' . (property_exists($object, 'prop0') ? 'Y' : 'N') . PHP_EOL;
+echo 'private: ' . (property_exists($object, 'prop1') ? 'Y' : 'N') . PHP_EOL;
+echo 'protected: ' . (property_exists($object, 'prop2') ? 'Y' : 'N') . PHP_EOL;

src/Exec.php

@@ -0,0 +1,119 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/sys-utils.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/sys-utils
+ * @license  MIT
+ */
+
+namespace Toolkit\Sys;
+
+use RuntimeException;
+use Toolkit\Sys\Proc\ProcWrapper;
+use function chdir;
+use function implode;
+use function ob_get_clean;
+use function ob_start;
+use function pclose;
+use function popen;
+use function system;
+use function exec;
+
+/**
+ * Class Exec
+ *
+ * @package Toolkit\Sys
+ */
+class Exec
+{
+    /**
+     * @param string $command
+     * @param string $workDir
+     * @param bool   $outAsString
+     *
+     * @return array
+     */
+    public static function exec(string $command, string $workDir = '', bool $outAsString = true): array
+    {
+        if ($workDir) {
+            chdir($workDir);
+        }
+
+        exec($command, $output, $status);
+
+        return [$status, $outAsString ? implode("\n", $output) : $output];
+    }
+
+    /**
+     * @param string $command
+     * @param string $workDir
+     *
+     * @return array
+     */
+    public static function system(string $command, string $workDir = ''): array
+    {
+        if ($workDir) {
+            chdir($workDir);
+        }
+
+        ob_start();
+        system($command, $status);
+        $output = ob_get_clean();
+
+        return [$status, $output];
+    }
+
+    /**
+     * @param string $command
+     * @param string $workDir
+     *
+     * @return string|null
+     */
+    public static function shellExec(string $command, string $workDir = ''): ?string
+    {
+        if ($workDir) {
+            chdir($workDir);
+        }
+
+        return shell_exec($command);
+    }
+
+    /**
+     * run a command in background
+     *
+     * @param string $cmd
+     */
+    public static function bgExec(string $cmd): void
+    {
+        self::inBackground($cmd);
+    }
+
+    /**
+     * run a command in background
+     *
+     * @param string $cmd
+     */
+    public static function inBackground(string $cmd): void
+    {
+        if (SysEnv::isWindows()) {
+            pclose(popen('start /B ' . $cmd, 'r'));
+        } else {
+            exec($cmd . ' > /dev/null &');
+        }
+    }
+
+    /**
+     * run a command. it is support windows
+     *
+     * @param string $command
+     * @param string $cwd
+     *
+     * @return array [$code, $output, $error]
+     * @throws RuntimeException
+     */
+    public static function run(string $command, string $cwd = ''): array
+    {
+        return ProcWrapper::runCmd($command, $cwd);
+    }
+}

src/PhpEnv.php

@@ -0,0 +1,23 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/sys-utils.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/sys-utils
+ * @license  MIT
+ */
+
+namespace Toolkit\Sys;
+
+use Toolkit\Sys\Traits\PhpEnvTrait;
+use Toolkit\Stdlib\Helper\PhpHelper;
+
+/**
+ * Class Php - alias of the class PhpHelper
+ *
+ * @package Toolkit\Sys
+ */
+class PhpEnv
+{
+    use PhpEnvTrait;
+}

src/Proc/ProcFunc.php

@@ -0,0 +1,91 @@
+<?php declare(strict_types=1);
+/**
+ * This file is part of toolkit/sys-utils.
+ *
+ * @author   https://github.com/inhere
+ * @link     https://github.com/php-toolkit/sys-utils
+ * @license  MIT
+ */
+
+namespace Toolkit\Sys\Proc;
+
+use RuntimeException;
+use function proc_close;
+use function proc_get_status;
+use function proc_open;
+use function proc_terminate;
+
+/**
+ * Class ProcFunc
+ *
+ * @package Toolkit\Sys\Proc
+ */
+class ProcFunc
+{
+    /**
+     * @param string $cmd
+     * @param array  $descriptorSpec
+     * @param array  $pipes
+     * @param string $workDir
+     * @param array  $env
+     * @param array  $otherOptions
+     *
+     * @return resource
+     * @see https://www.php.net/manual/en/function.proc-open.php
+     */
+    public static function open(
+        string $cmd,
+        array $descriptorSpec,
+        array &$pipes,
+        string $workDir = '',
+        array $env = [],
+        array $otherOptions = []
+    ) {
+        $process = proc_open($cmd, $descriptorSpec, $pipes, $workDir, $env, $otherOptions);
+
+        if (!is_resource($process)) {
+            throw new RuntimeException("Can't open resource with proc_open.");
+        }
+
+        return $process;
+    }
+
+    /**
+     * Get information about a process opened by `proc_open`
+     *
+     * @param resource $process
+     *
+     * @return array
+     * @see https://www.php.net/manual/en/function.proc-get-status.php
+     */
+    public static function getStatus($process): array
+    {
+        return (array)proc_get_status($process);
+    }
+
+    /**
+     * Close a process opened by `proc_open` and return the exit code of that process
+     *
+     * @param resource $process
+     *
+     * @return int
+     * @see https://www.php.net/manual/en/function.proc-close.php
+     */
+    public static function close($process): int
+    {
+        return proc_close($process);
+    }
+
+    /**
+     * Kills a process opened by `proc_open`
+     *
+     * @param resource $process
+     *
+     * @return bool
+     * @see https://www.php.net/manual/en/function.proc-terminate.php
+     */
+    public static function terminate($process): bool
+    {
+        return proc_terminate($process);
+    }
+}