add proc_close special case, see #424

Author: shish

generator/config/specialCasesFunctions.php

@@ -17,4 +17,5 @@
     'posix_getpgid',
     'fputcsv',
     'fgetcsv',  // This function need to return false when iterating on an end of file.
+    'proc_close',  // returns -1 on error
 ];

lib/special_cases.php

@@ -8,6 +8,7 @@
 
 namespace Safe;
 
+use Safe\Exceptions\ExecException;
 use Safe\Exceptions\MiscException;
 use Safe\Exceptions\PosixException;
 use Safe\Exceptions\SocketsException;
@@ -420,3 +421,31 @@ function fgetcsv($stream, ?int $length = null, string $separator = ",", string $
     }
     return $safeResult;
 }
+
+
+/**
+ * proc_close is similar to pclose
+ * except that it only works on processes opened by
+ * proc_open.
+ * proc_close waits for the process to terminate, and
+ * returns its exit code.  Open pipes to that process are closed
+ * when this function is called, in
+ * order to avoid a deadlock - the child process may not be able to exit
+ * while the pipes are open.
+ *
+ * @param resource $process The proc_open resource that will
+ * be closed.
+ * @return int Returns the termination status of the process that was run. In case of
+ * an error then -1 is returned.
+ * @throws ExecException
+ *
+ */
+function proc_close($process): int
+{
+    error_clear_last();
+    $safeResult = \proc_close($process);
+    if ($safeResult === -1) {
+        throw ExecException::createFromPhpError();
+    }
+    return $safeResult;
+}

tests/SpecialCasesTest.php

@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use PHPUnit\Framework\TestCase;
+use Safe\Exceptions\ExecException;
 use Safe\Exceptions\FilesystemException;
 use Safe\Exceptions\PcreException;
 
@@ -52,4 +53,10 @@ public function testFgetcsvReturnFalseonEndOfFile(): void
             echo var_export($data, true);
         }
     }*/
+
+	public function testProcClose(): void
+	{
+		$resource = fopen('php://temp', 'r+');
+		proc_close($resource); // how to test this failing??
+	}
 }