fileperms

(PHP 4, PHP 5, PHP 7, PHP 8)

filepermsLee los permisos de un fichero

Descripción

fileperms(string $filename): int|false

Lee los permisos del fichero dado.

Parámetros

filename

Ruta de acceso al fichero.

Valores devueltos

Devuelve los permisos del fichero en formato numérico. Los bits de menor peso son los mismos que los de los permisos en chmod(), sin embargo algunas plataformas incluyen en el retorno información sobre el tipo de fichero dado en filename. Los ejemplos siguientes muestran cómo probar el valor de retorno en cuanto a los permisos y el tipo de fichero en sistemas POSIX como Linux o macOS.

Para ficheros locales, se utiliza el valor específico st_mode de la estructura C devuelta por la función stat(). Los bits afectados pueden cambiar según la plataforma y se debe investigar al respecto si se deben analizar los bits que no concernen a la permisión.

Devuelve false en caso de error.

Errores/Excepciones

En caso de fallo, se emite un E_WARNING.

Ejemplos

Ejemplo #1 Mostrar los permisos en 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 Mostrar todos los permisos

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

switch (
$perms & 0xF000) {
case
0xC000: // Socket
$info = 's';
break;
case
0xA000: // Enlace simbólico
$info = 'l';
break;
case
0x8000: // Regular
$info = 'r';
break;
case
0x6000: // Especial de bloque
$info = 'b';
break;
case
0x4000: // Directorio
$info = 'd';
break;
case
0x2000: // Especial de carácter
$info = 'c';
break;
case
0x1000: // Pipe FIFO
$info = 'p';
break;
default:
// Desconocido
$info = 'u';
}

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

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

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

echo
$info;
?>

El resultado del ejemplo sería:

-rw-r--r--

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 del fichero
  • is_readable() - Indica si un fichero existe y es accesible en lectura
  • stat() - Proporciona información sobre un fichero