uTools-Manuals/docs/php/fileatime.html
2019-04-28 19:00:34 +08:00

115 lines
5.7 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>取得文件的上次访问时间</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.fileatime" class="refentry">
<div class="refnamediv">
<h1 class="refname">fileatime</h1>
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">fileatime</span> &mdash; <span class="dc-title">取得文件的上次访问时间</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.fileatime-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>fileatime</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$filename</code></span>
) : <span class="type">int</span></div>
<p class="simpara">
取得文件的上次访问时间。
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.fileatime-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">filename</code></dt>
<dd>
<p class="para">
文件的路径。
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.fileatime-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
返回文件上次被访问的时间, 或者在失败时返回 <strong><code>FALSE</code></strong>。时间以 Unix 时间戳的方式返回。
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.fileatime-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-2785">
<p><strong>Example #1 <span class="function"><strong>fileatime()</strong></span> 例子</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">//&nbsp;输出类似somefile.txt&nbsp;was&nbsp;last&nbsp;accessed:&nbsp;December&nbsp;29&nbsp;2002&nbsp;22:16:23.<br /><br /></span><span style="color: #0000BB">$filename&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'somefile.txt'</span><span style="color: #007700">;<br />if&nbsp;(</span><span style="color: #0000BB">file_exists</span><span style="color: #007700">(</span><span style="color: #0000BB">$filename</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">"</span><span style="color: #0000BB">$filename</span><span style="color: #DD0000">&nbsp;was&nbsp;last&nbsp;accessed:&nbsp;"&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">date</span><span style="color: #007700">(</span><span style="color: #DD0000">"F&nbsp;d&nbsp;Y&nbsp;H:i:s."</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">fileatime</span><span style="color: #007700">(</span><span style="color: #0000BB">$filename</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 errors" id="refsect1-function.fileatime-errors">
<h3 class="title">错误/异常</h3>
<p class="para">
失败时抛出<strong><code>E_WARNING</code></strong>警告。
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.fileatime-notes">
<h3 class="title">注释</h3>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
注意:一个文件的 atime
应该在不论何时读取了此文件中的数据块时被更改。当一个应用程序定期访问大量文件或目录时很影响性能。
</p>
<p class="para">
有些
Unix 文件系统可以在加载时关闭 atime 的更新以提高这类程序的性能。USENET
新闻组假脱机是一个常见的例子。在这种文件系统下本函数没有用处。
</p>
</p></blockquote>
<blockquote class="note"><p><strong class="note">Note</strong>: <p class="para">注意:不同文件系统对时间的判断方法可能是不相同的。</p></p></blockquote>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">此函数的结果会被缓存。参见
<span class="function"><a href="clearstatcache.html" class="function">clearstatcache()</a></span> 以获得更多细节。</span></p></blockquote>
<div class="tip"><strong class="tip">Tip</strong><p class="simpara">自 PHP 5.0.0 起, 此函数也用于<em class="emphasis">某些</em>
URL 包装器。请参见 <a href="wrappers.html" class="xref">支持的协议和封装协议</a>以获得支持 <span class="function"><a href="stat.html" class="function">stat()</a></span> 系列函数功能的包装器列表。</p></div>
</div>
<div class="refsect1 seealso" id="refsect1-function.fileatime-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="filemtime.html" class="function" rel="rdfs-seeAlso">filemtime()</a> - 取得文件修改时间</span></li>
<li class="member"><span class="function"><a href="fileinode.html" class="function" rel="rdfs-seeAlso">fileinode()</a> - 取得文件的 inode</span></li>
<li class="member"><span class="function"><a href="date.html" class="function" rel="rdfs-seeAlso">date()</a> - 格式化一个本地时间/日期</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>