<!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="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Filesystem (Sistema de arquivos)"
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"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.set-file-buffer.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.symlink.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.stat"
></A
>stat</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN50593"
></A
><P
> (PHP 3, PHP 4, PHP 5)</P
>stat -- Obtem informações sobre um arquivo</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN50596"
></A
><H2
>Descrição</H2
>array <B
CLASS="methodname"
>stat</B
> ( string filename )<BR
></BR
><P
> Coleta estatísticas do arquivo informado em
<CODE
CLASS="parameter"
>filename</CODE
>. Se <CODE
CLASS="parameter"
>filename</CODE
>
for um link simbólico, estatísticas serão do próprio arquivo, não do
link. <A
HREF="function.lstat.html"
><B
CLASS="function"
>lstat()</B
></A
> é idêntica a <B
CLASS="function"
> stat()</B
>, exceto que ela busca as estatísticas do
symlink.
</P
><P
> Em caso de erro, <B
CLASS="function"
>stat()</B
> retorna <TT
CLASS="constant"
><B
>FALSE</B
></TT
> e também
dispara um alerta.
</P
><P
> Retorna um array com as estatísticas do arquivo com os
seguintes elementos. Esse array é baseado no zero. Além de
retornar esses elemtos de uma maneira numérica, eles podem ser acessados
através de índices associativos, como informado ao lado de cada parâmetro. Isto
foi acrescentado no PHP 4.0.6:
</P
><P
> <DIV
CLASS="table"
><A
NAME="AEN50614"
></A
><P
><B
>Tabela 1. Formato de retorno de <B
CLASS="function"
>stat()</B
> e
<A
HREF="function.fstat.html"
><B
CLASS="function"
>fstat()</B
></A
></B
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><COL><COL><COL><THEAD
><TR
><TH
>Índice Numérico</TH
><TH
>Índice Associativo (desde o PHP 4.0.6)</TH
><TH
>Descrição</TH
></TR
></THEAD
><TBODY
><TR
><TD
>0</TD
><TD
>dev</TD
><TD
>device number / número do dispositivo</TD
></TR
><TR
><TD
>1</TD
><TD
>ino</TD
><TD
>inode number / número do inode</TD
></TR
><TR
><TD
>2</TD
><TD
>mode</TD
><TD
>inode protection mode / modo de proteção do inode</TD
></TR
><TR
><TD
>3</TD
><TD
>nlink</TD
><TD
>number of links / número de links</TD
></TR
><TR
><TD
>4</TD
><TD
>uid</TD
><TD
>userid of owner / userid do proprietário</TD
></TR
><TR
><TD
>5</TD
><TD
>gid</TD
><TD
>groupid of owner / groupid do proprietário</TD
></TR
><TR
><TD
>6</TD
><TD
>rdev</TD
><TD
>device type, if inode device * / tipo do dispositivo</TD
></TR
><TR
><TD
>7</TD
><TD
>size</TD
><TD
>size in bytes / tamanho em bytes</TD
></TR
><TR
><TD
>8</TD
><TD
>atime</TD
><TD
>time of last access (unix timestamp) / horário último acesso</TD
></TR
><TR
><TD
>9</TD
><TD
>mtime</TD
><TD
>time of last modification (unix timestamp) / horário última modificação</TD
></TR
><TR
><TD
>10</TD
><TD
>ctime</TD
><TD
>time of last change (unix timestamp) / horário última alteração</TD
></TR
><TR
><TD
>11</TD
><TD
>blksize</TD
><TD
>blocksize of filesystem IO * / tamanho do bloco no sistema de arquivos</TD
></TR
><TR
><TD
>12</TD
><TD
>blocks</TD
><TD
>number of blocks allocated / número de blocos alocados</TD
></TR
></TBODY
></TABLE
></DIV
>
* - somente disponível em sistemas que suportem st_blksize. Outros
sistemas (como o Windows) retornam -1.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>O resultado desta
função é cacheada. Veja <A
HREF="function.clearstatcache.html"
><B
CLASS="function"
>clearstatcache()</B
></A
> para
mais detalhes.</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>Esta função não trabalha com
<A
HREF="features.remote-files.html"
>arquivos remotos</A
>, de forma que o arquivo
a ser examinado precisa ser acessível pelo sistema de arquivos do servidor.</P
></BLOCKQUOTE
></DIV
><P
> Veja também <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
> e
<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"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.symlink.html"
ACCESSKEY="N"
>Próxima</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"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>symlink</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
