Open In App

PHP | pclose( ) Function

Improve
Improve
Improve
Like Article
Like
Save Article
Save
Share
Report issue
Report

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


Last Updated : 01 Jun, 2018
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads