sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 08:58:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Added some clarification regarding filetimes as some people

Browse source 
in de.comp.lang.php started building last modification time footers based on
ctimes.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@30331 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Kristian Köhntopp 2000-08-15 20:22:01 +00:00
parent cc27d3a303
commit 969d3d2633
1 changed files with 30 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
functions/filesystem.xml
View file

@ -690,6 +690,17 @@ $fcontents = join( '', file( 'http://www.php.net' ) );
The results of this function are cached. See
<function>clearstatcache</function> for more details.
</simpara>
<simpara>
Note: The atime of a file is supposed to change whenever
the data blocks of a file are being read. This can be
costly performancewise when an appliation regularly
accesses a very large number of files or directories. Some
Unix filesystems can be mounted with atime updates disabled
to increase the performance of such applications; USENET
news spools are a common example. On such filesystems
this function will be useless.
</simpara>
</refsect1>
</refentry>
@ -716,6 +727,19 @@ $fcontents = join( '', file( 'http://www.php.net' ) );
The results of this function are cached. See
<function>clearstatcache</function> for more details.
</para>
<para>Note: In most Unix filesystem, a file is considered
changed, when it's Inode data is changed, that is, when
the permissions, the owner, the group or other metadata
from the Inode is written to. See also
<function>filemtime()</function> (this is what you want to use
when you want to create "Last Modified" footers on web pages) and
<function>fileatime()</function>.
</para>
<para>Note: In some Unix texts the ctime of a file is being
referred to as the creation time of the file. This is wrong.
There is no creation time for Unix files in most Unix
filesystems.
</para>
</refsect1>
</refentry>
@ -798,6 +822,12 @@ $fcontents = join( '', file( 'http://www.php.net' ) );
The results of this function are cached. See
<function>clearstatcache</function> for more details.
</para>
<para>Note: This function returns the time when the data
blocks of a file were being written to, that is, the time
when the content of the file was changed. Use
<function>date()</function> on the result of this function
to get a printable modification date for use in page footers.
</para>
</refsect1>
</refentry>