2024 年 PHP 开发者大会日本站

fileperms

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

fileperms获取文件权限

描述

fileperms(字符串 $filename): 整数|false

获取给定文件的权限。

参数

filename

文件路径。

返回值

返回文件的权限作为数值模式。此模式的低位与chmod() 期望的权限相同,但是在大多平台上,返回值还将包含作为 filename 给出的文件类型信息。下面的示例演示了如何在 POSIX 系统(包括 Linux 和 macOS)上测试返回值以获取特定权限和文件类型。

对于本地文件,特定的返回值是 C 库的 stat() 函数返回的结构的 st_mode 成员的返回值。哪些位被设置可能因平台而异,如果需要解析返回值的非权限位,建议查找特定平台的文档。

失败时返回 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: // 普通文件
$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() 系列功能。

参见

添加备注

用户贡献备注 4 条备注

coolmic at example dot com
11 年前
不要使用 substr,使用位运算符
<?php
decoct
(fileperms($file) & 0777); // 例如返回 "755"
?>

如果要比较权限
<?php
0755
=== (fileperms($file) & 0777);
?>
admin at torntech dot com
12 年前
有些人可能没有立即意识到这一点,但是可以使用 octdec( $octal_value ) 来匹配 fileperms 获取的权限

<?php

// 假设文件具有 2770 权限
$perm= fileperms( __FILE__ );
$bit = "102770";

printf( "%s\n", octdec( $bit ) );
printf( "%s\n", $perm);

?>
paul2712 at gmail dot com
17 年前
不要忘记:clearstatcache();
==============================

每当你执行

mkdir($dstdir, 0770 ))

或者

chmod($dstdir, 0774 );

你必须调用

clearstatcache();

然后才能调用

fileperms($dstdir);
chris at ocproducts dot com
4 年前
Windows 的文件权限模型与 Unix 大相径庭,并且仅在最小程度上集成它们。

以下是 Windows 如何计算位掩码……

u+w/g+w/o+w 基于文件是否具有只读标志来设置。

u+r/g+w/o+w 始终设置。

u+x/g+x/o+x 基于 $filename 是否是固有的可执行文件(例如 bat)或目录来设置。

Windows根本没有集成其 ACL。

所有这些的来源:https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/stat-functions?view=vs-2019(但它没有提供很多细节)
To Top