PHP: Hypertext Preprocessor (original) (raw)

chgrp

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

chgrp — Changes file group

Description

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

Returns [true](reserved.constants.php#constant.true) on success or [false](reserved.constants.php#constant.false) on failure.

Examples

Example #1 Changing a file's group

<?php $filename = 'shared_file.txt'; $format = "%s's Group ID @ %s: %d\n"; printf($format, <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>f</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo separator="true">,</mo><mi>d</mi><mi>a</mi><mi>t</mi><mi>e</mi><msup><mo stretchy="false">(</mo><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><msup><mi>r</mi><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><mo stretchy="false">)</mo><mo separator="true">,</mo><mi>f</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi>g</mi><mi>r</mi><mi>o</mi><mi>u</mi><mi>p</mi><mo stretchy="false">(</mo></mrow><annotation encoding="application/x-tex">filename, date('r'), filegroup(</annotation></semantics></math>filename,date(′r′),filegroup(filename)); chgrp($filename, 8); clearstatcache(); // do not cache filegroup() results printf($format, <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mi>f</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi>n</mi><mi>a</mi><mi>m</mi><mi>e</mi><mo separator="true">,</mo><mi>d</mi><mi>a</mi><mi>t</mi><mi>e</mi><msup><mo stretchy="false">(</mo><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><msup><mi>r</mi><mo mathvariant="normal" lspace="0em" rspace="0em">′</mo></msup><mo stretchy="false">)</mo><mo separator="true">,</mo><mi>f</mi><mi>i</mi><mi>l</mi><mi>e</mi><mi>g</mi><mi>r</mi><mi>o</mi><mi>u</mi><mi>p</mi><mo stretchy="false">(</mo></mrow><annotation encoding="application/x-tex">filename, date('r'), filegroup(</annotation></semantics></math>filename,date(′r′),filegroup(filename)); ?>

Notes

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

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

Found A Problem?

There are no user contributed notes for this page.