<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >stat</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="PHP 手册" HREF="index.html"><LINK REL="UP" TITLE="Filesystem 文件系统函数" HREF="ref.filesystem.html"><LINK REL="PREVIOUS" TITLE="set_file_buffer" HREF="function.set-file-buffer.html"><LINK REL="NEXT" TITLE="symlink" HREF="function.symlink.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP 手册</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.set-file-buffer.html" ACCESSKEY="P" >上一页</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.symlink.html" ACCESSKEY="N" >下一页</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.stat" ></A >stat</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN54795" ></A ><P > (PHP 3, PHP 4, PHP 5)</P >stat -- 给出文件的信息</DIV ><DIV CLASS="refsect1" ><A NAME="AEN54798" ></A ><H2 >说明</H2 >array <B CLASS="methodname" >stat</B > ( string filename )<BR ></BR ><P > 获取由 <CODE CLASS="parameter" >filename</CODE > 指定的文件的统计信息。如果 <CODE CLASS="parameter" >filename</CODE > 是符号连接，则统计信息是关于被连接文件本身的，而不是符号连接。<A HREF="function.lstat.html" ><B CLASS="function" >lstat()</B ></A > 和 <B CLASS="function" >stat()</B > 相同，只除了它会返回符号连接的状态。 </P ><P > 如果出错，<B CLASS="function" >stat()</B > 返回 <TT CLASS="constant" ><B >FALSE</B ></TT >，并且发出一条警告。 </P ><P > 返回一个数组包含有文件的统计信息，该数组具有以下列出的单元，数组下标从零开始。除了数字索引之外自 PHP 4.0.6 起还可以通过关联索引来访问。 </P ><P > <DIV CLASS="table" ><A NAME="AEN54816" ></A ><P ><B >表 1. <B CLASS="function" >stat()</B > 和 <A HREF="function.fstat.html" ><B CLASS="function" >fstat()</B ></A > 返回格式</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><THEAD ><TR ><TH >数字下标</TH ><TH >关联键名（自 PHP 4.0.6）</TH ><TH >说明</TH ></TR ></THEAD ><TBODY ><TR ><TD >0</TD ><TD >dev</TD ><TD >device number - 设备名</TD ></TR ><TR ><TD >1</TD ><TD >ino</TD ><TD >inode number - inode 号码</TD ></TR ><TR ><TD >2</TD ><TD >mode</TD ><TD >inode protection mode - inode 保护模式</TD ></TR ><TR ><TD >3</TD ><TD >nlink</TD ><TD >number of links - 被连接数目</TD ></TR ><TR ><TD >4</TD ><TD >uid</TD ><TD >userid of owner - 所有者的用户 id</TD ></TR ><TR ><TD >5</TD ><TD >gid</TD ><TD >groupid of owner- 所有者的组 id</TD ></TR ><TR ><TD >6</TD ><TD >rdev</TD ><TD >device type, if inode device * - 设备类型，如果是 inode 设备的话</TD ></TR ><TR ><TD >7</TD ><TD >size</TD ><TD >size in bytes - 文件大小的字节数</TD ></TR ><TR ><TD >8</TD ><TD >atime</TD ><TD >time of last access (unix timestamp) - 上次访问时间（Unix 时间戳）</TD ></TR ><TR ><TD >9</TD ><TD >mtime</TD ><TD >time of last modification (unix timestamp) - 上次修改时间（Unix 时间戳）</TD ></TR ><TR ><TD >10</TD ><TD >ctime</TD ><TD >time of last change (unix timestamp) - 上次改变时间（Unix 时间戳）</TD ></TR ><TR ><TD >11</TD ><TD >blksize</TD ><TD >blocksize of filesystem IO * - 文件系统 IO 的块大小</TD ></TR ><TR ><TD >12</TD ><TD >blocks</TD ><TD >number of blocks allocated - 所占据块的数目</TD ></TR ></TBODY ></TABLE ></DIV > * - 仅在支持 st_blksize 类型的系统下有效。其它系统（如 Windows）返回 -1。 </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >注意: </B >本函数的结果会被缓存。更多信息参见 <A HREF="function.clearstatcache.html" ><B CLASS="function" >clearstatcache()</B ></A >。</P ></BLOCKQUOTE ></DIV ><DIV CLASS="tip" ><BLOCKQUOTE CLASS="tip" ><P ><B >提示: </B >自 <TT CLASS="literal" >PHP 5.0.0</TT > 起本函数也可被<SPAN CLASS="emphasis" ><I CLASS="emphasis" >某些</I ></SPAN > URL wrapper 使用。参考<A HREF="wrappers.html" >附录 N</A > 来看哪些 wrapper 支持 <B CLASS="function" >stat()</B > 系列函数的功能。</P ></BLOCKQUOTE ></DIV ><P > 参见 <A HREF="function.lstat.html" ><B CLASS="function" >lstat()</B ></A >，<A HREF="function.fstat.html" ><B CLASS="function" >fstat()</B ></A >，<A HREF="function.filemtime.html" ><B CLASS="function" >filemtime()</B ></A > 和 <A HREF="function.filegroup.html" ><B CLASS="function" >filegroup()</B ></A >。 </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.set-file-buffer.html" ACCESSKEY="P" >上一页</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >起始页</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.symlink.html" ACCESSKEY="N" >下一页</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >set_file_buffer</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.filesystem.html" ACCESSKEY="U" >上一级</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >symlink</TD ></TR ></TABLE ></DIV ></BODY ></HTML >
