fileperms

fileperms(string $filename): int
```php

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 emitirá una advertencia de tipo `E_WARNING`.

## Ejemplos

Mostrar los permisos en valor octal

El ejemplo anterior mostrará:

    1777
    0644

Mostrar todos los permisos

-rw-r--r--