Home/ Manual/ filesystem / functions/ chgrp

chgrp

PHP function Edit on GitHub ✎

(PHP 4, PHP 5, PHP 7, PHP 8)

Changes file group

Description

chgrp(string $filename, string|int $group): bool

Attempts to change the group of the file filename to group.

Only the superuser may change the group of a file arbitrarily; other users may change the group of a file to any group of which that user is a member.

Parameters

filename: Path to the file.
group: A group name or number.

Return Values

Success

Examples

Changing a file's group

php

<?php
$filename = 'shared_file.txt';
$format = "%s's Group ID @ %s: %d\n";
printf($format, $filename, date('r'), filegroup($filename));
chgrp($filename, 8);
clearstatcache(); // do not cache filegroup() results
printf($format, $filename, date('r'), filegroup($filename));
?>

Notes No-remote

Note

On Windows, this function fails silently when applied on a regular file.