(PHP 4, PHP 5, PHP 7)
fileperms — Obtiene los permisos de un fichero
$filename
) : intObtiene los permisos de un fichero dado.
filename
Ruta del fichero.
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.
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--
En caso de fallo, se emite un E_WARNING
.
Nota: Los resultados de esta función son guardados en caché. Para más información ver clearstatcache().
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().