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

filter_none

edit
close

play_arrow

link
brightness_4
code

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

chevron_right






                        filter_none










Output: 


1


Program 2













                                    filter_none




                                    edit

                                    close




                                    play_arrow




                                    link

                                    brightness_4

                                    code
                                




















<?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); 


?> 



















                        chevron_right







                        filter_none










Output: 


1


Reference:

http://php.net/manual/en/function.pclose.php



          
          
          
          

            

    

        My Personal Notes
        arrow_drop_up
    

    

        
        

            
            
        

    


Recommended Posts:
Image
Shubrodeep Banerjee
I am a technology enthusiast who has a keen interest in programming I am pursuing Engineering in Computer Science from GEU, Dehradun I like to unwind by watching movies and English sitcomsI have a keen interest in music
If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please Improve this article if you find anything incorrect by clicking on  the "Improve Article" button below.