ConFoo: Call for paper is now Open

fileperms

(PHP 4, PHP 5)

filepermsObtiene los permisos de un archivo

Descripción

int fileperms ( string $filename )

Obtiene los permisos de un archivo dado.

Parámetros

filename

Ruta del archivo.

Valores devueltos

Devuelve los permisos de un archivo como un modo numérico del mismo formato en el que se espera por chmod(), sin embargo en la mayoría de plataformas el valor de retorno también incluirá información sobre el tipo de fichero dado como filename. Los siguientes ejemplos muestran como poner a prueba el valor de retorno para los permisos específicos y tipos de ficheros en sistemas POSIX, incluyendo Linux y Mac OS X.

Para los ficheros locales, el valor de retorno específico es el del miembro st_mode de la estructura devuelta por la función stat() de la biblioteca de C. Exactamente lo que los bits que están establecidos pueden variar de una plataforma a otra, y mirando la documentación de su plataforma específica se recomienda si el análisis de los bits sin permiso del valor de retorno es necesario.

Ejemplos

Ejemplo #1 Muestra los permisos como un valor octal

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

El resultado del ejemplo sería:

1777
0644

Ejemplo #2 Muestra los permisos completos

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

if ((
$permisos 0xC000) == 0xC000) {
    
// Socket
    
$info 's';
} elseif ((
$permisos 0xA000) == 0xA000) {
    
// Enlace Simbólico
    
$info 'l';
} elseif ((
$permisos 0x8000) == 0x8000) {
    
// Regular
    
$info '-';
} elseif ((
$permisos 0x6000) == 0x6000) {
    
// Especial Bloque
    
$info 'b';
} elseif ((
$permisos 0x4000) == 0x4000) {
    
// Directorio
    
$info 'd';
} elseif ((
$permisos 0x2000) == 0x2000) {
    
// Especial Carácter
    
$info 'c';
} elseif ((
$permisos 0x1000) == 0x1000) {
    
// Tubería FIFO
    
$info 'p';
} else {
    
// Desconocido
    
$info 'u';
}

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

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

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

echo 
$info;
?>

El resultado del ejemplo sería:

-rw-r--r--

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

Notas

Nota: Los resultados de esta función son guardados en caché. Para más información ver clearstatcache().

Sugerencia

Desde PHP 5.0.0, esta función también puede usarse con algunos URL wrappers. Consultar Protocolos y Envolturas soportados para deter4minar qué envolturas soportan la familia de funcionalidad de stat().

Ver también

  • chmod() - Cambia el modo de un fichero
  • is_readable() - Indica si un fichero existe y es legible
  • stat() - Da información acerca de un fichero

add a note add a note

User Contributed Notes 8 notes

up
5
admin at torntech dot com
2 years ago
This may not be immediately apparent to some, but you can use octdec( $octal_value ) to match the permissions retrieved by file perms

<?php

//assumes file has 2770 permissions
$perm= fileperms( __FILE__ );
$bit = "102770";

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

?>
up
3
coolmic at example dot com
1 year ago
Don't use substr, use bit operator
<?php
decoct
(fileperms($file) & 0777); // return "755" for example
?>

If you want to compare permission
<?php
0755
=== (fileperms($file) & 0777);
?>
up
3
MartinAngermeier at gmx dot net
5 years ago
An easy way to calculate fileperms to chmod is this:

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

Displays 666 or 777 (depends on chmod set).

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

Displays 0666 or 0777 and refers immediately to the number set with chmod();
up
1
chinello at gmail dot com
7 years ago
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
?>
up
1
Dominic
6 months ago
A small function for the last 3 digits (777/755 ect.)

<?php
function getFilePermission($file) {
       
$length = strlen(decoct(fileperms($file)))-3;
        return
substr(decoct(fileperms($file)),$length);
}
?>
up
0
jchris dot fillionr at kitware dot com
5 years ago
Since the output of decoct( fileperms('.') ) is of the form: 40644

It seems the previous example is wrong, instead you should understand:

To get permissions formatted as "644":
<?php
echo substr(decoct( fileperms('.') ), 2);
?>

To get permissions formatted  as "0644":
<?php
echo substr(decoct( fileperms('.') ), 1);
?>
up
0
paul2712 at gmail dot com
7 years ago
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);
up
-1
sviscaino123 at hotmail dot fr
4 years ago
Here is a small function I made : http://pastebin.com/iKky8Vtu
I was bored and I thought it could be useful.

mixed mkperms( string $perms [, bool return_as_string = false [, string $filename ] ] )
Returns permissions given a string in literal format and a filename.
If the file name is omitted, the permissions that the function will return are based on 000-permissions.
If return_as_string is set to true, the result will be output as a 644 format string. Otherwise it will return a string converted to base-10 for chmod.

Examples:

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

touch('myfile.txt'); // Create a file with any permissions
chmod('myfile.txt', mkperms('u=rwx,g=x,o=rw')); // myfile.txt is now at -rwx--xrw-

// Make a file and give it full permissions
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
// This way you can apply permissions to files
chmod('somefile.txt', mkperms('u=rwx,g-r,o=-', false, 'somefile.txt')); // somefile.txt is now at -rwx-wx---
?>

PS : sorry I had to put it on pastebin, or else it just made the note way too long.
To Top