filemtime
Данная функция возвращает время последней записи блоков файла, иначе говоря, изменения содержания файла.
Список параметров
Возвращаемые значения
Возвращает время последнего изменения указанного файла, или FALSE в случае возникновения ошибки. Время возвращается в формате временной метки Unix, который подходит для передачи в качестве аргумента функции date() .
Примеры
Пример #1 Пример использования функции filemtime()
// Пример вывода: В последний раз файл somefile.txt был изменен: December 29 2002 22:16:23.
$filename = ‘somefile.txt’ ;
if ( file_exists ( $filename )) echo «В последний раз файл $filename был изменен: » . date ( «F d Y H:i:s.» , filemtime ( $filename ));
>
?>
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING .
Примечания
Замечание:
Учтите, что обработка времени может отличаться в различных файловых системах.
Замечание: Результаты этой функции кэшируются. Более подробную информацию смотрите в разделе clearstatcache() .
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat() , смотрите в Поддерживаемые протоколы и обработчики (wrappers).
Смотрите также
- filectime() — Возвращает время изменения индексного дескриптора файла
- stat() — Возвращает информацию о файле
- touch() — Устанавливает время доступа и модификации файла
- getlastmod() — Определение времени последней модификации страницы
filemtime
Данная функция возвращает время последней записи блоков файла, иначе говоря, изменения содержания файла.
Список параметров
Возвращаемые значения
Возвращает время последнего изменения указанного файла или false в случае возникновения ошибки. Время возвращается в формате временной метки Unix, который подходит для передачи в качестве аргумента функции date() .
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING .
Примеры
Пример #1 Пример использования функции filemtime()
// Пример вывода: В последний раз файл somefile.txt был изменён: December 29 2002 22:16:23.
$filename = ‘somefile.txt’ ;
if ( file_exists ( $filename )) echo «В последний раз файл $filename был изменён: » . date ( «F d Y H:i:s.» , filemtime ( $filename ));
>
?>
Примечания
Замечание:
Учтите, что обработка времени может отличаться в различных файловых системах.
Замечание: Результаты этой функции кешируются. Более подробную информацию смотрите в разделе clearstatcache() .
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обёртками url. Список обёрток, поддерживаемых семейством функций stat() , смотрите в разделе Поддерживаемые протоколы и обёртки.
Смотрите также
- filectime() — Возвращает время изменения индексного дескриптора файла
- stat() — Возвращает информацию о файле
- touch() — Устанавливает время доступа и модификации файла
- getlastmod() — Получает время последней модификации страницы
User Contributed Notes 30 notes
This is a very handy function for dealing with browser caching. For example, say you have a stylesheet and you want to make sure everyone has the most recent version. You could rename it every time you edit it, but that would be a pain in the ass. Instead, you can do this:
By appending a GET value (the UNIX timestamp) to the stylesheet URL, you make the browser think the stylesheet is dynamic, so it’ll reload the stylesheet every time the modification date changes.
To get the last modification time of a directory, you can use this:
$getLastModDir = filemtime("/path/to/directory/.");
Take note on the last dot which is needed to see the directory as a file and to actually get a last modification date of it.
This comes in handy when you want just one ‘last updated’ message on the frontpage of your website and still taking all files of your website into account.
«this is not (necessarily) correct, the modification time of a directory will be the time of the last file *creation* in a directory (and not in it’s sub directories).»
This is not (necessarily) correct either. In *nix the timestamp can be independently set. For example the command «touch directory» updates the timestamp of a directory without file creation.
Also file removal will update the timestamp of a directory.
To get the modification date of some remote file, you can use the fine function by notepad at codewalker dot com (with improvements by dma05 at web dot de and madsen at lillesvin dot net).
But you can achieve the same result more easily now with stream_get_meta_data (PHP>4.3.0).
However a problem may arise if some redirection occurs. In such a case, the server HTTP response contains no Last-Modified header, but there is a Location header indicating where to find the file. The function below takes care of any redirections, even multiple redirections, so that you reach the real file of which you want the last modification date.
// get remote file last modification date (returns unix timestamp)
function GetRemoteLastModified ( $uri )
// default
$unixtime = 0 ;
$fp = fopen ( $uri , «r» );
if( ! $fp )
$MetaData = stream_get_meta_data ( $fp );
foreach( $MetaData [ ‘wrapper_data’ ] as $response )
// case: redirection
if( substr ( strtolower ( $response ), 0 , 10 ) == ‘location: ‘ )
$newUri = substr ( $response , 10 );
fclose ( $fp );
return GetRemoteLastModified ( $newUri );
>
// case: last-modified
elseif( substr ( strtolower ( $response ), 0 , 15 ) == ‘last-modified: ‘ )
$unixtime = strtotime ( substr ( $response , 15 ) );
break;
>
>
fclose ( $fp );
return $unixtime ;
>
?>
There’s a deeply-seated problem with filemtime() under Windows due to the fact that it calls Windows’ stat() function, which implements DST (according to this bug: http://bugs.php.net/bug.php?id=40568). The detection of DST on the time of the file is confused by whether the CURRENT time of the current system is currently under DST.
This is a fix for the mother of all annoying bugs:
function GetCorrectMTime ( $filePath )
$time = filemtime ( $filePath );
$isDST = ( date ( ‘I’ , $time ) == 1 );
$systemDST = ( date ( ‘I’ ) == 1 );
return ( $time + $adjustment );
>
?>
Dustin Oprea
Функции для работы с файловой системой в PHP
Следующие функции для работы с файловой системой являются частью ядра PHP, поэтому вы можете использовать эти функции в своих скриптах без дополнительной установки.
| Функция | Описание |
|---|---|
| basename() | Возвращает компонент имени файла пути |
| chgrp() | Изменяет файловую группу |
| chmod() | Изменяет режим файла |
| chown() | Меняет владельца файла |
| clearstatcache() | Очищает кеш состояния файла |
| copy() | Копирует файл |
| delete() | Смотрите unlink() или unset() |
| dirname() | Возвращает путь к родительскому каталогу |
| disk_free_space() | Возвращает доступное пространство в файловой системе или разделе диска |
| disk_total_space() | Возвращает общий размер файловой системы или раздела диска |
| diskfreespace() | Возвращает доступное пространство в файловой системе или разделе диска. Псевдоним disk_free_space() |
| fclose() | Закрывает указатель открытого файла |
| feof() | Тесты на конец файла для указателя файла |
| fflush() | Сбрасывает буферизованный вывод в файл |
| fgetc() | Возвращает символ из указателя файла |
| fgetcsv() | Получает строку из указателя файла и парсинг для полей CSV |
| fgets() | Читает определенное количество байтов из файла |
| fgetss() | Читает определенное количество байтов из файла и удаляет HTML-теги и PHP-код |
| file() | Читает весь файл в массив |
| file_exists() | Проверяет, существует ли файл или каталог |
| file_get_contents() | Читает весь файл в строку |
| file_put_contents() | Записаывает строку в файл |
| fileatime() | Возвращает время последнего доступа к файлу |
| filectime() | Возвращает время последнего изменения файла |
| filegroup() | Возвращает идентификатор группы файла |
| fileinode() | Возвращает номер inode файла |
| filemtime() | Возвращает время последней модификации файла |
| fileowner() | Возвращает идентификатор пользователя владельца файла |
| fileperms() | Возвращает разрешения для файла |
| filesize() | Возвращает размер файла |
| filetype() | Returns the file type |
| flock() | Блокирует или освобождает файл |
| fnmatch() | Сопоставляет имя файла или строку с указанным шаблоном |
| fopen() | Открывает файл или URL |
| fpassthru() | Выводит все оставшиеся данные в указатель файла |
| fputcsv() | Форматирует строку как CSV и записать в указатель файла |
| fputs() | Псевдоним fwrite() |
| fread() | Читает определенное количество байтов из файла |
| fscanf() | Анализирует ввод из файла в соответствии с указанным форматом |
| fseek() | Ищет указатель файла |
| fstat() | Возвращает информацию о файле, используя указатель открытого файла |
| ftell() | Возвращает текущую позицию указателя чтения / записи файла |
| ftruncate() | Обрезает файл до заданной длины |
| fwrite() | Записывает содержимое строки в указатель файла |
| glob() | Возвращает массив имен файлов / каталогов, соответствующих указанному шаблону |
| is_dir() | Проверяет, является ли файл каталогом |
| is_executable() | Проверяет, является ли файл исполняемым |
| is_file() | Проверяет, является ли файл обычным файлом |
| is_link() | Проверяет, является ли имя файла символической ссылкой |
| is_readable() | Проверяет, существует ли файл и доступен ли для чтения |
| is_uploaded_file() | Проверяет, был ли файл загружен через HTTP POST |
| is_writable() | Проверяет, доступно ли для записи имя файла |
| is_writeable() | Псевдоним is_writable() |
| lchgrp() | Изменяет групповое владение символической ссылкой |
| lchown() | Изменяет право собственности пользователя на символическую ссылку |
| link() | Создает жесткую ссылку |
| linkinfo() | Возвращает информацию о ссылке |
| lstat() | Возвращает информацию о файле или символической ссылке |
| mkdir() | Создает каталог |
| move_uploaded_file() | Перемещает загруженный файл в новое место |
| parse_ini_file() | Разбирает файл конфигурации |
| parse_ini_string() | Разбирает строку конфигурации |
| pathinfo() | Возвращает информацию о пути к файлу |
| pclose() | Закрывает указатель файла процесса |
| popen() | Открывает указатель файла процесса |
| readfile() | Читает файл и записывает в буфер вывода |
| readlink() | Возвращает цель символьной ссылки |
| realpath() | Возвращает канонизированный абсолютный путь |
| realpath_cache_get() | Возвращает записи кэша realpath |
| realpath_cache_size() | Возвращает размер кеша realpath |
| rename() | Переименовывает файл или каталог |
| rewind() | Перематывает назад позиции указателя файла |
| rmdir() | Удаляет пустой каталог |
| set_file_buffer() | Устанавливает размер буфера файла |
| stat() | Возвращает информацию о файле |
| symlink() | Создает символическую ссылку |
| tempnam() | Создает временный файл с уникальным именем файла |
| tmpfile() | Создает уникальный временный файл |
| touch() | Устанавливает время доступа и изменения файла |
| umask() | Изменяет текущую маску |
| unlink() | Удаляет файл |
Насколько публикация полезна?
Нажмите на звезду, чтобы оценить!