archived-doc-es/reference/stream/streamwrapper/url-stat.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: seros Status: ready -->

<refentry xml:id="streamwrapper.url-stat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>streamWrapper::url_stat</refname>
  <refpurpose>Recuperar información sobre un archivo</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>array</type><methodname>streamWrapper::url_stat</methodname>
   <methodparam><type>string</type><parameter>path</parameter></methodparam>
   <methodparam><type>int</type><parameter>flags</parameter></methodparam>
  </methodsynopsis>
  <para>
   Este método es llamado en respuesta a todas las funciones relacionadas con
   <function>stat</function>, como:
   <simplelist>
    <member><function>chmod</function> (sólo cuando <link linkend="ini.safe-mode">safe_mode</link> está habilitado)</member>
    <member><function>copy</function></member>
    <member><function>fileperms</function></member>
    <member><function>fileinode</function></member>
    <member><function>filesize</function></member>
    <member><function>fileowner</function></member>
    <member><function>filegroup</function></member>
    <member><function>fileatime</function></member>
    <member><function>filemtime</function></member>
    <member><function>filectime</function></member>
    <member><function>filetype</function></member>
    <member><function>is_writable</function></member>
    <member><function>is_readable</function></member>
    <member><function>is_executable</function></member>
    <member><function>is_file</function></member>
    <member><function>is_dir</function></member>
    <member><function>is_link</function></member>
    <member><function>file_exists</function></member>
    <member><function>lstat</function></member>
    <member><function>stat</function></member>
    <member><methodname>SplFileInfo::getPerms</methodname></member>
    <member><methodname>SplFileInfo::getInode</methodname></member>
    <member><methodname>SplFileInfo::getSize</methodname></member>
    <member><methodname>SplFileInfo::getOwner</methodname></member>
    <member><methodname>SplFileInfo::getGroup</methodname></member>
    <member><methodname>SplFileInfo::getATime</methodname></member>
    <member><methodname>SplFileInfo::getMTime</methodname></member>
    <member><methodname>SplFileInfo::getCTime</methodname></member>
    <member><methodname>SplFileInfo::getType</methodname></member>
    <member><methodname>SplFileInfo::isWritable</methodname></member>
    <member><methodname>SplFileInfo::isReadable</methodname></member>
    <member><methodname>SplFileInfo::isExecutable</methodname></member>
    <member><methodname>SplFileInfo::isFile</methodname></member>
    <member><methodname>SplFileInfo::isDir</methodname></member>
    <member><methodname>SplFileInfo::isLink</methodname></member>
    <member><methodname>RecursiveDirectoryIterator::hasChildren</methodname></member>
   </simplelist>
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>path</parameter></term>
     <listitem>
      <para>
       La ruta del archivo o de la URL de donde obtener las estadísticas. Observe que en el caso que sea
       una URL, debe ser una URL delimitada con ://. No están soportadas formas de URL.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>flags</parameter></term>
     <listitem>
      <para>
       Contiene banderas adicionales establecidas por la API de flujos. Puede contener uno o más
       de los siguientes valores usando OR entre ellos.
       <informaltable>
        <tgroup cols="2">
         <thead>
          <row>
           <entry>Bandera</entry>
           <entry>Descripción</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry>STREAM_URL_STAT_LINK</entry>
           <entry>
            Para recursos con la capacidad de enlazar a otros recursos
            (como HTTP Location: forward, o un enlace simbólico de
            sistema de archivos). Esta bandera especifica que sólo debería ser devuelta
            la información acerca del enlace mismo, no del
            recurso apuntado por el enlace. Esta bandera está establecida en
            respuesta a las llamadas a <function>lstat</function>,
            <function>is_link</function>, o <function>filetype</function>.
           </entry>
          </row>
          <row>
           <entry>STREAM_URL_STAT_QUIET</entry>
           <entry>Si esta bandera está establecida, la envoltura no debería lanzar ningún
            error. Si esta bandera no está establecida, uno mismo es responsable de
            notificar errores usando la función <function>trigger_error</function>
            durante la obtención de estadísticas de la ruta.
           </entry>
          </row>
         </tbody>
        </tgroup>
       </informaltable>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Debería devolver tantos elementos como tiene <function>stat</function>.
   Valores desconocidos o no disponibles deberían ser establecidos a un valor razonable
   (normalmente <constant>0</constant>).
  </para>
 </refsect1>

 <refsect1 role="errors"><!-- {{{ -->
  &reftitle.errors;
  &userstream.not.implemented.warning;
 </refsect1><!-- }}} -->
 
 <!-- {{{
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>streamWrapper::url_stat</function> example</title>
    <programlisting role="php">
<![CDATA[
<?php
/* ... */
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen>
<![CDATA[
...
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 }}}-->

 <refsect1 role="notes"><!-- {{{ -->
  &reftitle.notes;
  &userstream.updates.context;
 </refsect1><!-- }}} -->
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>stat</function></member>
    <member><methodname>streamwrapper::stream_stat</methodname></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->