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
// opening a pipe
$my_file = popen("/bin/ls", "r");

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

Output:

1

Program 2

<?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:
http://php.net/manual/en/function.pclose.php

My Personal Notes arrow_drop_up

Save