哈希空间 Ctrl + F 进行搜索
首页 php手册中文版 CSS中文手册 哈希文档 Markdown在线工具

fileperms

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

fileperms获取文件权限

说明

fileperms(string $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() 系列函数功能的包装器列表。

参见

打开 哈希空间 微信小程序中查看更佳