fix: passthru on PHP 8.1 (#691)

Co-authored-by: Oskar Stark <[email protected]>

Author: silasjoisten

generated/8.1/functionsList.php

@@ -8,6 +8,7 @@
 
 namespace Safe;
 
+use Safe\Exceptions\ExecException;
 use Safe\Exceptions\MiscException;
 use Safe\Exceptions\PosixException;
 use Safe\Exceptions\SocketsException;
@@ -399,3 +400,32 @@ function fgetcsv($stream, ?int $length = null, string $separator = ",", string $
     }
     return $safeResult;
 }
+
+/**
+ * The passthru function is similar to the
+ * exec function in that it executes a
+ * command. This function
+ * should be used in place of exec or
+ * system when the output from the Unix command
+ * is binary data which needs to be passed directly back to the
+ * browser.  A common use for this is to execute something like the
+ * pbmplus utilities that can output an image stream directly.  By
+ * setting the Content-type to image/gif and
+ * then calling a pbmplus program to output a gif, you can create
+ * PHP scripts that output images directly.
+ *
+ * @param string $command The command that will be executed.
+ * @param int|null $result_code If the result_code argument is present, the
+ * return status of the Unix command will be placed here.
+ * @throws ExecException
+ *
+ */
+function passthru(string $command, ?int &$result_code = null): void
+{
+    error_clear_last();
+
+    $safeResult = \passthru($command, $result_code);
+    if ($safeResult === false) {
+        throw ExecException::createFromPhpError();
+    }
+}

generated/8.1/rector-migrate.php

@@ -11,4 +11,9 @@ parameters:
     # The level 9 is the highest level (with check for mixed type)
     level: 8
     ignoreErrors:
-        # A lot of functions are in extensions so it is ok not to find those
+        # This must be ignored because there is no way of fixing it.
+        -
+            message: '#^Function Safe\\passthru\(\) never assigns null to &\$result_code so it can be removed from the by\-ref type\.$#'
+            identifier: parameterByRef.unusedType
+            count: 1
+            path: lib/special_cases.php