fileperms

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

    fileperms — 获取文件权限

    描述

    fileperms(string $filename): int|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() 函数族。

    另请参阅

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 9 个注释

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

    如果您想比较权限
    <?php
    0755     === (fileperms($file) & 0777);
    ?>
    6
    admin at torntech dot com
    12 年前
    这可能不会立即对某些人显而易见，但您可以使用 octdec( $octal_value ) 来匹配 file perms 获取的权限

    <?php

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

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

    ?>
    3
    MartinAngermeier at gmx dot net
    15 年前
    一种计算 fileperms 到 chmod 的简单方法是

    substr(decoct(fileperms("test.html")),3);

    显示 666 或 777（取决于设置的 chmod）。

    substr(decoct(fileperms("test.html")),2);

    显示 0666 或 0777 并直接引用使用 chmod(); 设置的数字。
    4
    paul2712 at gmail dot com
    17 年前
    不要忘记：clearstatcache();
    ==============================

    无论何时您进行

    mkdir($dstdir, 0770 ))

    或

    chmod($dstdir, 0774 );

    您必须调用

    clearstatcache();

    在您可以调用之前

    fileperms($dstdir);
    1
    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（但它没有提供很多详细信息）
    -1
    sviscaino123 at hotmail dot fr
    14 年前
    这里有一个我创建的小函数： http://pastebin.com/iKky8Vtu
    我无聊了，我觉得它可能有用。

    mixed mkperms( string $perms [, bool return_as_string = false [, string $filename ] ] )
    根据文字格式的字符串和文件名返回权限。
    如果省略文件名，则该函数将返回的权限基于 000-权限。
    如果将 return_as_string 设置为 true，则结果将作为 644 格式字符串输出。否则，它将返回转换为 base-10 的字符串以进行 chmod。

    示例

    <?php
    echo mkperms('u+r', true), "\n"; // 400
    echo mkperms('u+rwx,g+rw,o+x', true), "\n"; // 761

    touch('myfile.txt'); // 创建一个具有任何权限的文件
    chmod('myfile.txt', mkperms('u=rwx,g=x,o=rw')); // myfile.txt 现在在 -rwx--xrw-

    // 创建一个文件并赋予其完全权限
    touch('somefile.txt');
    chmod('somefile.txt', 0777);
    echo     mkperms('g-w,o-rw', true, 'somefile.txt'); // 751
    echo mkperms('u=rwx,g-r,o=-', true, 'somefile.txt'); // 730
    // 这样就可以将权限应用于文件
    chmod('somefile.txt', mkperms('u=rwx,g-r,o=-', false, 'somefile.txt')); // somefile.txt 现在在 -rwx-wx---
    ?>

    PS：抱歉，我不得不将其放在 pastebin 上，否则注释就会太长了。
    -4
    Dominic
    10 年前
    一个用于最后 3 位数字（777/755 等）的小函数

    <?php
    function getFilePermission($file) {
    $length = strlen(decoct(fileperms($file)))-3;
    return     substr(decoct(fileperms($file)),$length);
    }
    ?>
    -5
    jchris dot fillionr at kitware dot com
    15 年前
    由于 decoct( fileperms('.') ) 的输出形式为：40644

    之前的示例似乎是错误的，相反您应该理解

    要获得格式为 "644" 的权限
    <?php
    echo substr(decoct( fileperms('.') ), 2);
    ?>

    要获得格式为 "0644" 的权限
    <?php
    echo substr(decoct( fileperms('.') ), 1);
    ?>
    -10
    chinello at gmail dot com
    17 年前
    在 Linux 上（未在 Windows 上测试），如果您想要类似 chmod 的权限，您可以使用此函数

    <?php
    function file_perms($file, $octal = false)
    {
    if(!    file_exists($file)) return false;

    $perms = fileperms($file);

    $cut = $octal ? 2 : 3;

    return     substr(decoct($perms), $cut);
    }
    ?>

    使用它

    $ touch foo.bar
    $ chmod 0754 foo.bar
    <?php
    echo file_perms('foo.bar'); // 打印：754
    echo file_perms('foo.bar', true); // 打印 0754
    ?>
    ＋添加注释
    To Top