stat
(PHP 4, PHP 5, PHP 7)
stat — Gives information about a file
설명
array stat
( string $filename
)
lstat() is identical to stat()
except it would instead be based off the symlinks status.
인수
-
filename
-
Path to the file.
반환값
stat() and fstat() result
format
| Numeric |
Associative |
Description |
| 0 |
dev |
device number |
| 1 |
ino |
inode number * |
| 2 |
mode |
inode protection mode |
| 3 |
nlink |
number of links |
| 4 |
uid |
userid of owner * |
| 5 |
gid |
groupid of owner * |
| 6 |
rdev |
device type, if inode device |
| 7 |
size |
size in bytes |
| 8 |
atime |
time of last access (Unix timestamp) |
| 9 |
mtime |
time of last modification (Unix timestamp) |
| 10 |
ctime |
time of last inode change (Unix timestamp) |
| 11 |
blksize |
blocksize of filesystem IO ** |
| 12 |
blocks |
number of 512-byte blocks allocated ** |
* On Windows this will always be 0.
** Only valid on systems supporting the st_blksize type - other
systems (e.g. Windows) return -1.
In case of error, stat() returns FALSE.
Note:
PHP의 정수형은 부호 있는 형식이고 많은 플랫폼이 32비트 정수를 사용하기에,
몇몇 파일시스템 함수는 2GB가 넘는 파일에 대해서 예측할 수 없는 결과를 반환합니다.
오류/예외
Upon failure, an E_WARNING is emitted.
예제
Example #1 stat() example
<?php
/* Get file stat */
$stat = stat('C:\php\php.exe');
/*
* Print file access time, this is the same
* as calling fileatime()
*/
echo 'Access time: ' . $stat['atime'];
/*
* Print file modification time, this is the
* same as calling filemtime()
*/
echo 'Modification time: ' . $stat['mtime'];
/* Print the device number */
echo 'Device number: ' . $stat['dev'];
?>
Example #2 Using stat() information together with touch()
<?php
/* Get file stat */
$stat = stat('C:\php\php.exe');
/* Did we failed to get stat information? */
if (!$stat) {
echo 'stat() call failed...';
} else {
/*
* We want the access time to be 1 week
* after the current access time.
*/
$atime = $stat['atime'] + 604800;
/* Touch the file */
if (!touch('some_file.txt', time(), $atime)) {
echo 'Failed to touch file...';
} else {
echo 'touch() returned success...';
}
}
?>
주의
Note:
시간 정밀도는 각각 파일
시스템에 따라 다를 수 있습니다.
Note: 이 함수의 결과는 캐시에
저장합니다. 자세한 설명은 clearstatcache()를
참고하십시오.
참고
- lstat() - Gives information about a file or symbolic link
- fstat() - Gets information about a file using an open file pointer
- filemtime() - Gets file modification time
- filegroup() - Gets file group