« basename
chmod »

chgrp

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

chgrp — ファイルのグループを変更する

説明

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

(名前または番号で指定した)ファイル filename のグループを group に変更しようと試みます。

スーパーユーザーのみがファイルのグループを任意に変更できます。 その他のユーザーは、ファイルのグループをそのユーザーがメンバーとして 属しているグループに変更できます。

パラメータ

filename

ファイルへのパス。

group

グループ名あるいはグループ番号。

戻り値

成功した場合に true を、失敗した場合に false を返します。

例

例1 ファイルのグループの変更

<?php
$filename = 'shared_file.txt';
$format = "%s's Group ID @ %s: %d\n";
printf($format, $filename, date('r'), filegroup($filename));
chgrp($filename, 8);
clearstatcache(); // filegroup() の結果はキャッシュしない
printf($format, $filename, date('r'), filegroup($filename));
?>

注意

注意:

この関数では、 リモートファイル を 使用することはできません。これは、処理されるファイルがサーバーの ファイルシステムによりアクセスできる必要があるためです。

注意:

Windows で通常ファイルに対してこの関数を実行すると、静かに失敗します。

参考

  • chown() - ファイルの所有者を変更する
  • chmod() - ファイルのモードを変更する

関連キーワード:
グループ   filename   chgrp   group   format   filegroup   chmod   ファイルシステム   番号   printf   date   basename   スーパー   任意   メンバー   成功   shared   Group   clearstatcache   キャッシュ   リモート   サーバー   Windows   通常   参考
関連する関数・ページ:
function.filegroup   function.lchgrp   function.posix-getgrgid   function.eio-grp-add   function.eio-grp   ref.posix