lstat
(PHP 4, PHP 5, PHP 7, PHP 8)
lstat — Sammelt Informationen über eine Datei oder einen symbolischen Link
Beschreibung
$filename
): array|false
Sammelt Statistiken über die Datei oder den symbolischen Link, die bzw.
der in filename
angegeben ist.
Parameter-Liste
-
filename
-
Pfad zur Datei oder zum symbolischen Link.
Rückgabewerte
Bitte lesen Sie die Handbuchseite zu stat() für
Informationen über die Struktur des Arrays, das lstat()
zurückgibt. Diese Funktion ist identisch zur
stat()-Funktion, mit dem Unterschied, dass, falls
filename
ein symbolischer Link ist, dessen
Statistik zurückgegeben wird und nicht der Status der Datei, auf die
der symbolische Link zeigt.
Bei einem Fehler wird false
zurückgegeben.
Fehler/Exceptions
Im Fehlerfall wird eine E_WARNING
ausgegeben.
Beispiele
Beispiel #1 Vergleich von stat() und lstat()
<?php
symlink('uploads.php', 'uploads');
// Vergleiche die Informationen von uploads.php und uploads
array_diff(stat('uploads'), lstat('uploads'));
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Unterschiede in den Informationen beider Dateien.
Array ( [ino] => 97236376 [mode] => 33188 [size] => 34 [atime] => 1223580003 [mtime] => 1223581848 [ctime] => 1223581848 [blocks] => 8 )
Anmerkungen
Hinweis: Die Ergebnisse dieser Funktion werden zwischengespeichert. Weitere Details sind bei clearstatcache() zu finden.
Seit PHP 5.0.0 kann diese Funktion mit einigen URL-Wrappern benutzt werden. Schauen Sie in der Liste unter Unterstützte Protokolle und Wrapper nach, welcher Wrapper die Funktionalität von stat() unterstützt.