【PHP8.x】fileowner関数の使い方
作成日: 更新日:
fileowner関数は、指定されたファイルの所有者を取得する処理を実行する関数です。この関数は、引数にファイルへのパスを文字列で指定します。処理が成功すると、ファイルの所有者のユーザーID(UID)を整数値で返します。ユーザーIDとは、オペレーティングシステムが各ユーザーを一意に識別するために割り当てる数値のことで、ファイルのパーミッション管理などで誰がそのファイルを所有しているかを確認する際に使用されます。指定されたファイルが存在しない、あるいは読み取り権限がないなどの理由で所有者情報を取得できなかった場合は、false
を返します。注意点として、この関数にシンボリックリンクのパスを指定した場合、リンクそのものではなく、リンクが指している先のファイルの所有者IDが返されます。シンボリックリンク自体の所有者IDを取得したい場合は、代わりにlowner()
関数を使用する必要があります。また、PHPはパフォーマンス向上のため、この関数の結果を含むファイルのステータス情報をキャッシュします。最新の情報を確実に取得したい場合は、事前にclearstatcache()
関数を呼び出してキャッシュをクリアしてください。
基本的な使い方
構文(syntax)
<?php
$filePath = '/path/to/your/file.txt';
$ownerId = fileowner($filePath);
?>
引数(parameters)
string $filename
- string $filename: ファイルの所有者IDを取得したいファイルの名前を指定する文字列
戻り値(return)
int|false
指定されたファイルオーナーのユーザーID(数値)または、エラー発生時に false を返します。