fileperms

(PHP 4, PHP 5, PHP 7)

filepermsObtiene los permisos de un fichero

Descripción

fileperms ( string $filename ) : int

Obtiene los permisos de un fichero dado.

Parámetros

filename

Ruta del fichero.

Valores devueltos

Devuelve los permisos de un fichero 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 macOS.

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

switch (
$perms 0xF000) {
    case 
0xC000// Socket
        
$info 's';
        break;
    case 
0xA000// Enlace simbólico
        
$info 'l';
        break;
    case 
0x8000// Normal
        
$info 'r';
        break;
    case 
0x6000// Bloque especial
        
$info 'b';
        break;
    case 
0x4000// Directorio
        
$info 'd';
        break;
    case 
0x2000// Carácter especial
        
$info 'c';
        break;
    case 
0x1000// Tubería FIFO pipe
        
$info 'p';
        break;
    default: 
// 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