The Server Pages
:: TSP Menu
- Home
- Authors
- Glossary
- RSS Feed

:: Servers
- CPanel
- Hosting
- Linux
- Windows

:: Webmaster
- Databases
- Design
- Search Engines

:: Scripts
- Scripts

:: Documentation
- PHP Manual

:: Other
- Errors & Solutions
- TechPunt
- Wojjie

search for in the

chmod> <basename
[edit] Last updated: Sat, 12 May 2012

view this page in


(PHP 4, PHP 5)

chgrpChanges file group


bool chgrp ( string $filename , mixed $group )

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.



Path to the file.


A group name or number.

Return Values

Returns TRUE on success or FALSE on failure.


Example #1 Changing a file's group

$format "%s's Group ID @ %s: %d\n";
printf($format$filenamedate('r'), filegroup($filename));
clearstatcache(); // do not cache filegroup() results
printf($format$filenamedate('r'), filegroup($filename));


Note: This function will not work on remote files as the file to be examined must be accessible via the server's filesystem.

Note: When safe mode is enabled, PHP checks whether the files or directories being operated upon have the same UID (owner) as the script that is being executed.

See Also

add a note add a note User Contributed Notes chgrp
Dan Dascalescu 03-Dec-2007 05:12
If you call chgrp and pass a non-existent group, you'll get the warning "Warning: chgrp(): Unable to find gid for nogroup in".

To check beforehand if the group exists, use posix_getgrid() or posix_getgrnam().

show source | credits | sitemap | contact | advertising | mirror sites