fileperms

(PHP 4, PHP 5)

fileperms — Gets file permissions

Descrierea

int fileperms ( string $filename )

Gets permissions for the given file.

Parametri

filename: Path to the file.

Valorile întroarse

Returns the permissions on the file, or FALSE in case of an error.

Exemple

Example #1 Display permissions as an octal value


<?php
echo substr(sprintf('%o', fileperms('/tmp')), -4);
echo substr(sprintf('%o', fileperms('/etc/passwd')), -4);
?>

Exemplul de mai sus va afişa:

1777
0644

Example #2 Display full permissions


<?php
$perms = fileperms('/etc/passwd');

if (($perms & 0xC000) == 0xC000) {
    // Socket
    $info = 's';
} elseif (($perms & 0xA000) == 0xA000) {
    // Symbolic Link
    $info = 'l';
} elseif (($perms & 0x8000) == 0x8000) {
    // Regular
    $info = '-';
} elseif (($perms & 0x6000) == 0x6000) {
    // Block special
    $info = 'b';
} elseif (($perms & 0x4000) == 0x4000) {
    // Directory
    $info = 'd';
} elseif (($perms & 0x2000) == 0x2000) {
    // Character special
    $info = 'c';
} elseif (($perms & 0x1000) == 0x1000) {
    // FIFO pipe
    $info = 'p';
} else {
    // Unknown
    $info = 'u';
}

// Owner
$info .= (($perms & 0x0100) ? 'r' : '-');
$info .= (($perms & 0x0080) ? 'w' : '-');
$info .= (($perms & 0x0040) ?
            (($perms & 0x0800) ? 's' : 'x' ) :
            (($perms & 0x0800) ? 'S' : '-'));

// Group
$info .= (($perms & 0x0020) ? 'r' : '-');
$info .= (($perms & 0x0010) ? 'w' : '-');
$info .= (($perms & 0x0008) ?
            (($perms & 0x0400) ? 's' : 'x' ) :
            (($perms & 0x0400) ? 'S' : '-'));

// World
$info .= (($perms & 0x0004) ? 'r' : '-');
$info .= (($perms & 0x0002) ? 'w' : '-');
$info .= (($perms & 0x0001) ?
            (($perms & 0x0200) ? 't' : 'x' ) :
            (($perms & 0x0200) ? 'T' : '-'));

echo $info;
?>

Exemplul de mai sus va afişa:

-rw-r--r--

Note

Notă: Rezultatele acestei funcţii sunt stocate în cache. Accesaţi clearstatcache() pentru mai multe detalii.

Sfat

Începând cu PHP 5.0.0 această funcţie poate fi utilizată de asemenea cu unele învelişuri URL. Referiţi-vă la List of Supported Protocols/Wrappers pentru lista învelişurilor care susţin familia de funcţionalitate stat().

Vedeţi de asemenea

filesize

fileowner

Last updated: Fri, 01 Aug 2008

add a note User Contributed Notes
fileperms

Newba
12-Mar-2008 04:15


Congratulations! looks like php.net stole your example LOL

AsakuraStar
23-Sep-2007 08:49


If you need a function to return perms in format like (rwx etc)

You can you use this code:



function GetFilePerms($file) {

    $perms = fileperms($file);

    if (($perms & 0xC000) == 0xC000) {$info = 's'; } // Socket

    elseif (($perms & 0xA000) == 0xA000) {$info = 'l'; } // Symbolic Link

    elseif (($perms & 0x8000) == 0x8000) {$info = '-'; } // Regular

    elseif (($perms & 0x6000) == 0x6000) {$info = 'b'; } // Block special

    elseif (($perms & 0x4000) == 0x4000) {$info = 'd'; } // Directory

    elseif (($perms & 0x2000) == 0x2000) {$info = 'c'; } // Character special

    elseif (($perms & 0x1000) == 0x1000) {$info = 'p'; } // FIFO pipe

    else {$info = '?';} // Unknown

    // Owner

    $info .= (($perms & 0x0100) ? 'r' : '-');

    $info .= (($perms & 0x0080) ? 'w' : '-');

    $info .= (($perms & 0x0040) ?

       (($perms & 0x0800) ? 's' : 'x' ) :

       (($perms & 0x0800) ? 'S' : '-'));

    // Group

    $info .= (($perms & 0x0020) ? 'r' : '-');

    $info .= (($perms & 0x0010) ? 'w' : '-');

    $info .= (($perms & 0x0008) ?

          (($perms & 0x0400) ? 's' : 'x' ) :

          (($perms & 0x0400) ? 'S' : '-'));

    // World

    $info .= (($perms & 0x0004) ? 'r' : '-');

    $info .= (($perms & 0x0002) ? 'w' : '-');

    $info .= (($perms & 0x0001) ?

       (($perms & 0x0200) ? 't' : 'x' ) :

       (($perms & 0x0200) ? 'T' : '-'));

  return $info;

}



//Usage mode:

//echo GetFilePerms("path/to/your/file");

eelco
10-Jul-2007 05:21


If you only want the permissions (lowest three octal numbers) you can use a bitwise AND to mask the bits:



<?php

fileperms($file) & 511; 

?>

paul2712 at gmail dot com
03-Jun-2007 12:08


Do not forget: clearstatcache();

==============================

 

When ever you make a:



mkdir($dstdir, 0770 ))



or a:



chmod($dstdir, 0774 ); 



You have to call:



clearstatcache();



before you can call:



fileperms($dstdir);

chinello at gmail dot com
25-Apr-2007 12:43


On Linux (not tested on Windows), if you want a chmod-like permissions, you can use this function:



<?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);

}

?>



Using it:



$ touch foo.bar

$ chmod 0754 foo.bar

<?php

echo file_perms('foo.bar'); // prints: 754

echo file_perms('foo.bar', true); // prints 0754

?>

add a note

filesize

fileowner

Last updated: Fri, 01 Aug 2008