PHP 5.4.31 Released

is_readable

(PHP 4, PHP 5)

is_readableIndique si un fichier existe et est accessible en lecture

Description

bool is_readable ( string $filename )

Indique si un fichier existe et est accessible en lecture.

Liste de paramètres

filename

Chemin vers le fichier.

Valeurs de retour

Retourne TRUE si le fichier ou le dossier spécifié par filename existe et est accessible en lecture, FALSE sinon.

Exemples

Exemple #1 Exemple avec is_readable()

<?php
$filename 
'test.txt';
if (
is_readable($filename)) {
    echo 
'Le fichier est accessible en lecture';
} else {
    echo 
'Le fichier n\'est pas accessible en lecture !';
}
?>

Erreurs / Exceptions

En cas d'échec, une alerte de type E_WARNING sera émise.

Notes

N'oubliez pas que PHP accède aux fichiers avec les mêmes autorisations que l'utilisateur qui fait tourner le serveur web (souvent, c'est 'nobody', personne). Les limitations du safe mode ne sont prises en compte qu'à partir de PHP 5.1.5.

Note: Les résultats de cette fonction sont mis en cache. Voyez la fonction clearstatcache() pour plus de détails.

Astuce

Depuis PHP 5.0.0, cette fonction peut aussi être utilisée avec quelques protocoles url. Lisez Liste des protocoles et des gestionnaires supportés pour connaître les protocoles supportant la famille de fonctionnalités de stat().

Note:

La vérification est effectuée en utilisant l'UID/GID réel au lieu de l'effectif.

Cette fonction peut retourner TRUE pour les dossiers. Utilisez la fonction is_dir() pour distinguer les fichiers et les dossiers.

Voir aussi

  • is_writable() - Indique si un fichier est accessible en écriture
  • file_exists() - Vérifie si un fichier ou un dossier existe
  • fgets() - Récupère la ligne courante sur laquelle se trouve le pointeur du fichier

add a note add a note

User Contributed Notes 3 notes

up
2
jo at durchholz dot org
8 years ago
DrTebi at yahoo dot com is wrong. is_readable() checks whether you can do file_get_contents() or similar calls, no more, no less. If the location given returns a 500 or 403 error, you can still read() that (you'll simply get the error page), but it's still read()able. Using is_readable to check the validity of a URL is simply the wrong function.
up
0
pgl at yoyo dot org
4 years ago
Note that is_readable() will return false for streams, eg, php://stdin.
up
-1
Anonymous
8 years ago
Sometimes in situations where file_exists fails (returns false even though the file does exist) stat will work.
To Top