fileperms
(PHP 4, PHP 5)
fileperms — ファイルのパーミッションを取得する
説明
int fileperms
( string $filename
)
指定したファイルのパーミッションを取得します。
パラメータ
- filename
-
ファイルへのパス。
返り値
ファイルのパーミッションを、 chmod() に渡すのと同じ形式の数値モードで返します。 失敗した場合に FALSE を返します。
例
例1 八進形式でのパーミッションの表示
<?php
echo substr(sprintf('%o', fileperms('/tmp')), -4);
echo substr(sprintf('%o', fileperms('/etc/passwd')), -4);
?>
上の例の出力は以下となります。
1777 0644
例2 完全なパーミッションの表示
<?php
$perms = fileperms('/etc/passwd');
if (($perms & 0xC000) == 0xC000) {
// ソケット
$info = 's';
} elseif (($perms & 0xA000) == 0xA000) {
// シンボリックリンク
$info = 'l';
} elseif (($perms & 0x8000) == 0x8000) {
// 通常のファイル
$info = '-';
} elseif (($perms & 0x6000) == 0x6000) {
// ブロックスペシャルファイル
$info = 'b';
} elseif (($perms & 0x4000) == 0x4000) {
// ディレクトリ
$info = 'd';
} elseif (($perms & 0x2000) == 0x2000) {
// キャラクタスペシャルファイル
$info = 'c';
} elseif (($perms & 0x1000) == 0x1000) {
// FIFO パイプ
$info = 'p';
} else {
// 不明
$info = 'u';
}
// 所有者
$info .= (($perms & 0x0100) ? 'r' : '-');
$info .= (($perms & 0x0080) ? 'w' : '-');
$info .= (($perms & 0x0040) ?
(($perms & 0x0800) ? 's' : 'x' ) :
(($perms & 0x0800) ? 'S' : '-'));
// グループ
$info .= (($perms & 0x0020) ? 'r' : '-');
$info .= (($perms & 0x0010) ? 'w' : '-');
$info .= (($perms & 0x0008) ?
(($perms & 0x0400) ? 's' : 'x' ) :
(($perms & 0x0400) ? 'S' : '-'));
// 全体
$info .= (($perms & 0x0004) ? 'r' : '-');
$info .= (($perms & 0x0002) ? 'w' : '-');
$info .= (($perms & 0x0001) ?
(($perms & 0x0200) ? 't' : 'x' ) :
(($perms & 0x0200) ? 'T' : '-'));
echo $info;
?>
上の例の出力は以下となります。
-rw-r--r--
エラー / 例外
失敗したときは E_WARNING が発生します。
注意
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。
ヒント
PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているかを調べるには サポートするプロトコル/ラッパー を参照してください。
