stat în PHP

Returnează toate informațiile despre un fișier: dimensiune, date, permisiuni, proprietar.

Sintaxă
stat(string $filename): array|false

Ce face stat

stat returnează dintr-un singur apel ce dau separat filesize, filemtime, fileperms, fileowner și celelalte. Tabloul are atât chei numerice (0-12), cât și chei cu nume: size, mtime, atime, ctime, mode, uid, gid, ino, nlink și altele.

Pentru o legătură simbolică, stat dă informațiile fișierului spre care indică. Pentru legătura însăși folosește lstat.

Parametri

Parametru Descriere
$filename Calea fișierului.

Ce returnează

Un tablou cu informații sau false (cu avertisment) dacă fișierul nu există.

Exemple

Exemplul 1: Câteva informații dintr-un singur apel

<?php
date_default_timezone_set("Europe/Bucharest");
file_put_contents("raport.txt", "Vânzări octombrie");
touch("raport.txt", mktime(9, 0, 0, 10, 19, 2026));
chmod("raport.txt", 0640);

$info = stat("raport.txt");
echo "Dimensiune: " . $info["size"] . " octeți\n";
echo "Modificat: " . date("d.m.Y H:i", $info["mtime"]) . "\n";
printf("Permisiuni: %o\n", $info["mode"] & 0777);
echo "Legături: " . $info["nlink"];

Rezultat

Dimensiune: 19 octeți
Modificat: 19.10.2026 09:00
Permisiuni: 640
Legături: 1

Greșeli frecvente

  • Apelezi stat pe un fișier inexistent și primești Warning: stat(): stat failed. Verifică întâi cu file_exists.

Comenzi înrudite

  • lstat: Ca stat, dar pentru o legătură simbolică dă informațiile legăturii, nu ale fișierului țintă.
  • fstat: Returnează informații despre un fișier deschis: dimensiune, date de modificare, permisiuni.
  • filesize: Returnează dimensiunea unui fișier, în octeți.
  • filemtime: Returnează momentul ultimei modificări a unui fișier, ca timestamp.