(PHP 4, PHP 5, PHP 7, PHP 8)
fileperms — 获取文件权限
$filename
): int|false
获取指定文件权限。
filename
文件的路径。
以数字模式返回文件权限。此模式的低位与 chmod()
期望权限相同,然而在大多数平台上,返回值还将会包含指定 filename
的文件类型信息。下面的示例示范了如何在 POSIX 系统上测试特定权限和文件类型的返回值。
对于本地文件,特定的返回值是通过 C 库的 stat() 函数返回结构中的
st_mode
成员的值。Exactly which bits are set
can vary from platform to platform, and looking up your specific platform's
documentation is recommended if parsing the non-permission bits of the
return value is required.
失败时返回 false
。
失败时抛出 E_WARNING
警告。
示例 #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');
switch ($perms & 0xF000) {
case 0xC000: // 套接字
$info = 's';
break;
case 0xA000: // 符号链接
$info = 'l';
break;
case 0x8000: // regular
$info = 'r';
break;
case 0x6000: // 块设备
$info = 'b';
break;
case 0x4000: // 目录
$info = 'd';
break;
case 0x2000: // 字符设备
$info = 'c';
break;
case 0x1000: // FIFO 管道
$info = 'p';
break;
default: // 位置
$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--
注意: 此函数的结果会被缓存。参见 clearstatcache() 以获得更多细节。
自 PHP 5.0.0 起, 此函数也用于某些 URL 包装器。请参见 支持的协议和封装协议以获得支持 stat() 系列函数功能的包装器列表。