chown

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

chown — ファイルの所有者を変更する

説明

chown(string $filename, string|int $user): bool

ファイルfilenameの所有者を(名前または番号で指定した) ユーザーuserに変更しようと試みます。スーパーユーザーのみがファイルの所有者を変更できます。

パラメータ

filename: ファイルへのパス。
user: ユーザー名あるいはユーザー番号。

戻り値

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

例

例1 シンプルな chown() の例

<?php

// 使用するファイル名とユーザー名
$file_name= "foo.php";
$path = "/home/sites/php.net/public_html/sandbox/" . $file_name ;
$user_name = "root";

// ユーザーを設定します
chown($path, $user_name);

// 結果を確認します
$stat = stat($path);
print_r(posix_getpwuid($stat['uid']));

?>

上の例の出力は、たとえば以下のようになります。

Array
(
    [name] => root
    [passwd] => x
    [uid] => 0
    [gid] => 0
    [gecos] => root
    [dir] => /root
    [shell] => /bin/bash
)

注意

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

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

参考

chmod() - ファイルのモードを変更する
chgrp() - ファイルのグループを変更する