fileperms
(PHP 4, PHP 5)
fileperms — Obtiene los permisos de un archivo
Descripción
$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().
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