◐ Shell
reader mode source ↗

    fileowner

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

    fileowner — Gets file owner

    Description

    function fileowner(string $filename): int|false

    Gets the file owner.

    Parameters

    filename

    Path to the file.

    Return Values

    Returns the user ID of the owner of the file, or false on failure. The user ID is returned in numerical format, use posix_getpwuid() to resolve it to a username.

    Errors/Exceptions

    Upon failure, an E_WARNING is emitted.

    Examples

    Example #1 Finding the owner of a file

    <?php
$filename = 'index.php';
print_r(posix_getpwuid(fileowner($filename)));
?>

    Notes

    Note: The results of this function are cached. See clearstatcache() for more details.

    Tip

    As of PHP 5.0.0, this function can also be used with some URL wrappers. Refer to Supported Protocols and Wrappers to determine which wrappers support stat() family of functionality.

    See Also

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    10
    dazoe
    16 years ago
    Remember to use if(fileowner(...) === FALSE) instead of if(!fileowner()) or if(fileowner() == FLASE) because if the owner was "root" it would return 0.
    up
    9
    Anonymous
    20 years ago
    Small note: the function resolves symbolic links. That is, if the link is created by user 999 and maps to a file owned by user 666, this function returns 666 :(
    up
    7
    chris at ocproducts dot com
    6 years ago
    This function will always return 0 on Windows, because Windows does not support numeric user IDs.
    ＋add a note
    To Top