PHP chgrp( ) Function

Last Updated : 26 Jun, 2023

The chgrp() function in PHP is an inbuilt function that is used to change the user group of the specified file. It returns true on success and false on failure. Only the superuser has the right to change the group of a file arbitrarily.

Syntax:

bool chgrp ( $filename, $group )

Parameters: The chgrp() function in PHP accepts two parameters which are filename and user.

$filename: It specifies the file whose user group you want to change.
$group: It specifies the new user group. It can be a group name or a number.

Return Value: The chgrp() function returns true on success and false on failure.
Errors And Exception:

The chgrp() function in PHP doesn’t works for remote files.It only works on files which are accessible by the server’s filesystem.
PHP checks whether the files or directories which are being operated have the same owner as the script that is being executed or not when safe mode is enabled.

Examples:

Input : chgrp("gfg.txt", "administrator")
Output :true

Input : $filename = "/user/Desktop/geeksforgeeks/gfg.txt";
        chgrp( $filename, "guest" );
Output :true

Below programs illustrate the chgrp() function:
Program 1:

<?php 
  
// changes the file group to administrator 
chgrp("gfg.txt", "administrator") 
  
?> 

Output:

true

Program 2:

<?php 
  
// Changes the file group to guest 
$filename = "/user/Desktop/geeksforgeeks/gfg.txt"; 
  
chgrp ( $filename, "guest" ); 
  
chown($path, $user_name);  
  
?> 