getlastmod
(PHP 4, PHP 5)
getlastmod — Определение времени последней модификации страницы
Описание
int getlastmod
( void
)
Получает время последней модификации текущей страницы.
Если требуется определить время модификации произвольного файла, используйте функцию filemtime().
Возвращаемые значения
Возвращает время последней модификации текущей страницы. Значение является
меткой времени Unix совместимой с фукнцией date().
Функция вернет FALSE
в случае ошибок.
Примеры
Пример #1 Пример использования getlastmod()
<?php
// Выводит нечто вроде 'Последнее изменение: March 04 1998 20:43:59.'
echo "Последнее изменение: " . date ("F d Y H:i:s.", getlastmod());
?>
Смотрите также
- date() - Форматирует вывод системной даты/времени
- getmyuid() - Получение UID владельца скрипта PHP
- getmygid() - Получение GID владельца PHP скрипта
- get_current_user() - Получение имени владельца текущего PHP скрипта
- getmyinode() - Получение значения inode текущего скрипта
- getmypid() - Получение ID процесса PHP
- filemtime() - Возвращает время последнего изменения файла
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Изменение поведения PHP
- PHP Опции и Информация
- assert_options
- assert
- cli_get_process_title
- cli_set_process_title
- dl
- extension_loaded
- gc_collect_cycles
- gc_disable
- gc_enable
- gc_enabled
- gc_mem_caches
- get_cfg_var
- get_current_user
- get_defined_constants
- get_extension_funcs
- get_include_path
- get_included_files
- get_loaded_extensions
- get_magic_quotes_gpc
- get_magic_quotes_runtime
- get_required_files
- get_resources
- getenv
- getlastmod
- getmygid
- getmyinode
- getmypid
- getmyuid
- getopt
- getrusage
- ini_alter
- ini_get_all
- ini_get
- ini_restore
- ini_set
- magic_quotes_runtime
- main
- memory_get_peak_usage
- memory_get_usage
- php_ini_loaded_file
- php_ini_scanned_files
- php_logo_guid
- php_sapi_name
- php_uname
- phpcredits
- phpinfo
- phpversion
- putenv
- restore_include_path
- set_include_path
- set_magic_quotes_runtime
- set_time_limit
- sys_get_temp_dir
- version_compare
- zend_logo_guid
- zend_thread_id
- zend_version
Коментарии
I found issues using getlastmod() to test whether or not I was successful in setting the Last Modified date in the header. The code below shows the same Last Modified date before and after I set the Last-Modified header.
<?php
//True modified date
$modified = date ("F d Y H:i:s.", getlastmod());
//artificial modified date - sent to header
$last_modified = gmdate('D, d M Y H:i:s T', (time() - 43200));
//caching prevention
header("Last-Modified: $last_modified GMT");
header("Cache-Control: no-store, no-cache, must-revalidate"); // HTTP/1.1
header("Cache-Control: post-check=0, pre-check=0", false);
header("Pragma: no-cache"); // HTTP/1.0
$getlast_modified = date ("F d Y H:i:s.", getlastmod());
print "True modified date(Before): $modified <p /> Date sent to header(After): $getlast_modified";
?>
I then used the PEAR, HTTP_Request class which worked, the Last-Modified date updates everytime it is requested, the desired effect.
<?php
require 'HTTP/Request.php';
$r = new HTTP_Request('http://www.sample.com/page.php');
$r->sendRequest();
$response_headers = $r->getResponseHeader();
print $response_headers["last-modified"];
?>
Setting the 'Last-Modified' header:
<?php
setlocale(LC_TIME, "C");
$ft = filemtime ('referencefile');
$localt = mktime ();
$gmtt = gmmktime ();
$ft = $ft - $gmtt + $localt;
$modified = strftime ("%a, %d %b %Y %T GMT", $ft);
?>
DO NOT use this function unless you are absolutely sure both your Apache and PHP have been compiled with the same value for -DFILE_OFFSET_BITS.
If not, this function will return the access time (or maybe even garbage) instead of the modification time due do Apache and PHP using different versions of the stat structure.
This is true regardless of Apache and PHP version.
To be on the safe side, always use the workaround already posted below:
filemtime($_SERVER['SCRIPT_FILENAME'])
If you use register_shutdown_function() on certain SAPIs, various filesystem-related things inside the shutdown function might do unexpected things, one of which being this function can return false.
On the other hand getlastmod() apparently caches the return value, so if you use it at least once in normal code it should work for the remainder of the request.
function for displaying last modification time accross more direcotries. e.g. to display last modification date in "about" section of your web page
<?php
function array_prefix_values($prefix, $array)
{
$callback = create_function('$s','return "'.$prefix.'".$s;');
return array_map($callback,$array);
}
function get_last_update()
{
if ( func_num_args() < 1 ) return 0;
$dirs = func_get_args();
$files = array();
foreach ( $dirs as $dir )
{
$subfiles = scandir($dir);
$subfiles = array_prefix_values($dir,$subfiles);
$subfiles = array_filter($subfiles,"is_file");
$files = array_merge($files,$subfiles);
}
$maxtimestamp = 0;
$maxfilename = "";
foreach ( $files as $file )
{
$timestamp = filemtime($file);
if ( $timestamp > $maxtimestamp )
{
$maxtimestamp = $timestamp;
$maxfilename = $file;
}
}
return date("Ymd",$maxtimestamp)." ($maxfilename)";
}
print "last update: ".get_last_update("./lib/", "./css/", "./lang/");
?>
OUTPUT:
last update: 20110927 (./lang/sk.php)
With better words getlastmod() returning the last time the script in which it is being called was modified, it does not require or use a parameter.
Return latest mod time of all included files:
<?php
function get_page_mod_time() {
$incls = get_included_files();
$incls = array_filter($incls, "is_file");
$mod_times = array_map('filemtime', $incls);
$mod_time = max($mod_times);
return $mod_time;
}
?>