PHP | pclose( ) Function

The pclose() closes a pipe opened by the popen() function. The file pointer initiated by the popen() function must be closed with pclose(). The pipe specified by popen() function is sent as a parameter to the pclose() function and it returns the termination status of the process that was run, or -1 in case of an error. Syntax:

pclose(pipe)

Parameters Used: The pclose() function in PHP accepts only one parameter.

• pipe : It is a mandatory parameter which specifies the pipe opened by the popen() function.

Return Value: It returns the termination status of the process that was run, or -1 in case of an error. Errors And Exceptions:

1. To obtain the real exit status code the pcntl_wexitstatus() function should be used.
2. pclose() returns 0 on every platform in case popen() could not execute the specified command.

Examples:

Input : $my_file = popen("/bin/ls", "r");
        pclose($my_file);
Output : 1

Input : $my_file = popen('/executable/gfg.exe', 'r');
        echo "'my_file'; " . get_class($my_file) . "\n";
        $file_read = fread($my_file, 4192);
        echo $file_read;
        pclose($my_file);

Output : 1

Below programs illustrate the pclose() function. Program 1 php

<?php
// opening a pipe 
$my_file = popen("/bin/ls", "r");

// closing the my_file
pclose($my_file);
?>

Output:

1

Program 2 php

<?php 
// opening a pipe
$my_file = popen('/executable/gfg.exe', 'r');

// returning name of class of an object using get_class()
echo "'$my_file'; " . get_class($my_file) . "\n";

// reading file using fread()
$filereader = fread($my_file, 4192);
echo $filereader;

// closing the pipe
pclose($my_file);
?>

Output:

1

Reference: https://www.php.net/manual/en/function.pclose.php