stat.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: nilgun Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stat">
 <refnamediv>
  <refname>stat</refname>
  <refpurpose>Bir dosya hakkında bilgi döndürür
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>array</type><type>false</type></type><methodname>stat</methodname>
   <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam>
  </methodsynopsis>
  <para>
   <parameter>dosyaismi</parameter> ile belirtilen dosyanın istatistiklerini
   toplar.  Eğer <parameter>dosyaismi</parameter> bir sembolik bağ ise
   istatistikler bağ dosyasından değil hedefinden toplanır.
   PHP 7.4.0 öncesinde, Windows üzerinde, bu durumda, <abbrev>NTS</abbrev>
   <literal>size</literal>, <literal>atime</literal>, <literal>mtime</literal>
   ve <literal>ctime</literal> istatistiklerini sembolik bağdan oluştururdu.
  </para>
  <para>
   <function>lstat</function>, sembolik bağların durumunu döndürmesi dışında
   <function>stat</function> işlevine eşdeğerdir.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>dosyaismi</parameter></term>
     <listitem>
      <para>
       Dosyanın yolu.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   <table>
    <title><function>stat</function> and <function>fstat</function> sonuç
    biçemi</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>İndis</entry>
       <entry>Anahtar</entry>
       <entry>Açıklama</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>0</entry>
       <entry>dev</entry>
       <entry>aygıt numarası ***</entry>
      </row>
      <row>
       <entry>1</entry>
       <entry>ino</entry>
       <entry>dosya düğümü numarası ****</entry>
      </row>
      <row>
       <entry>2</entry>
       <entry>mode</entry>
       <entry>dosya düğümü koruma kipi *****</entry>
      </row>
      <row>
       <entry>3</entry>
       <entry>nlink</entry>
       <entry>bağ sayısı</entry>
      </row>
      <row>
       <entry>4</entry>
       <entry>uid</entry>
       <entry>sahibinin kullanıcı kimliği *</entry>
      </row>
      <row>
       <entry>5</entry>
       <entry>gid</entry>
       <entry>sahibinin grup kimliği *</entry>
      </row>
      <row>
       <entry>6</entry>
       <entry>rdev</entry>
       <entry>dosya düğümü aygıtı ise aygıt türü</entry>
      </row>
      <row>
       <entry>7</entry>
       <entry>size</entry>
       <entry>bayt sayısı</entry>
      </row>
      <row>
       <entry>8</entry>
       <entry>atime</entry>
       <entry>son erişim zamanı (Unix zaman damgası)</entry>
      </row>
      <row>
       <entry>9</entry>
       <entry>mtime</entry>
       <entry>son değişiklik zamanı (Unix zaman damgası)</entry>
      </row>
      <row>
       <entry>10</entry>
       <entry>ctime</entry>
       <entry>dosya düğümü son değişiklik zamanı (Unix zaman damgası)</entry>
      </row>
      <row>
       <entry>11</entry>
       <entry>blksize</entry>
       <entry>dosya sisteminin G/Ç blok boyu **</entry>
      </row>
      <row>
       <entry>12</entry>
       <entry>blocks</entry>
       <entry>ayrılmış 512 baytlık blokların sayısı **</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para>
   * Windows üzerinde daima <literal>0</literal>'dır.
  </para>
  <para>
   ** Sadece st_blksize türünü destekleyen sistemlerde geçerlidir;
   diğer sistemlerde (Windows gibi) <literal>-1</literal> döner.
  </para>
  <para>
   *** PHP 7.4.0 öncesinde, Windows üzerinde, bu  dosyayı içeren birimin 64
   bitlik <emphasis>işaretsiz</emphasis> bir tam sayı olarak seri numarasıdır,
   bu nedenle taşabilir. Önceden, sürücü harfinin sayısal karşılığıydı
   (örneğin, C: sürücüsü <function>stat</function> için <literal>2</literal>
   ve <function>lstat</function> için <literal>0</literal> idi).
  </para>
  <para>
   **** PHP 7.4.0 öncesinde, Windows üzerinde, bu, 64 bitlik
   <emphasis>işaretsiz</emphasis> bir tam sayı olarak dosyayla ilişkili
   tanımlayıcıdır, bu nedenle taşabilir. Önceden her zaman
   <literal>0</literal> idi.
  </para>
  <para>
   ***** Windows'ta, yazılabilir izin biti, salt-okunur yapılır ve tüm
   kullanıcılar, grup ve sahip için aynı değer kullanılır.
   <function>is_writable</function> işlevinin aksine ACL dikkate alınmaz.
  </para>
  <para>
   Çeşitli işlevler tarafından okunan bilgileri içeren <literal>kip</literal>
   değeri. Sekizlik olarak yazıldığında, sağdan başlayarak, ilk üç hane
   <function>chmod</function> tarafından döndürülür. Sonraki basamak PHP
   tarafından yok sayılır. Sonraki iki hane dosya türünü gösterir:
   <table>
    <title><literal>kip</literal> dosya türleri</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Sekizlik <literal>kip</literal></entry>
       <entry>Anlamı</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>0140000</literal></entry>
       <entry>soket</entry>
      </row>
      <row>
       <entry><literal>0120000</literal></entry>
       <entry>bağ</entry>
      </row>
      <row>
       <entry><literal>0100000</literal></entry>
       <entry>normal dosya</entry>
      </row>
      <row>
       <entry><literal>0060000</literal></entry>
       <entry>blok aygıtı</entry>
      </row>
      <row>
       <entry><literal>0040000</literal></entry>
       <entry>dizin</entry>
      </row>
      <row>
       <entry><literal>0020000</literal></entry>
       <entry>karakter aygıtı</entry>
      </row>
      <row>
       <entry><literal>0010000</literal></entry>
       <entry>fifo</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
   Dolayısıyla, örneğin, normal bir dosyanın kipi <literal>0100644</literal>
   iken dizin için <literal>0040755</literal> olur.
  </para>
  <para>
   Hata durumunda, <function>stat</function> &false; döndürür.
  </para>
  &fs.file.32bit;
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Başarısızlık durumunda bir <constant>E_WARNING</constant> çıktılanır.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>7.4.0</entry>
      <entry>
       Windows üzerinde, aygıt numarası artık dosyayı içeren birimin seri
       numarası oldu. Evvelce dosya ile ilgili tanımlayıcının düğüm numarası
       idi.
      </entry>
     </row>
     <row>
      <entry>7.4.0</entry>
      <entry>
       Sembolik bağların <literal>size</literal>, <literal>atime</literal>,
       <literal>mtime</literal> ve  <literal>ctime</literal> istatistikleri
       olarak artık hedefin istatistikleri kullanılıyor. Evvelce, bunları
       <abbrev>NTS</abbrev> sembolik bağdan oluştururdu.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>stat</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
/* Dosya durumunu alalım */
$stat = stat('C:\php\php.exe');

/*
 * Dosya erişim zamanını basalım.
 * Bu, fileatime() çağrısına eşdeğerdir.
 */
echo 'Erişim zamanı: ' . $stat['atime'];

/*
 * Dosya değişiklik zamanını basalım.
 * Bu, filemtime() çağrısına eşdeğerdir.
 */
echo 'Değişiklik zamanı: ' . $stat['mtime'];

/* Aygıt numarasını basalım */
echo 'Aygıt numarası: ' . $stat['dev'];
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>- <function>stat</function> bilgisinin <function>touch</function>
    ile birlikte kullanımı</title>
    <programlisting role="php">
<![CDATA[
<?php
/* Dosya durumunu alalım */
$stat = stat('C:\php\php.exe');

/* Bilgiyi alırken başarısız olduk mu? */
if(!$stat) {
    echo 'Stat çağrısı başarısız oldu...';
} else {
    /*
     * Mevcut erişim zamanı 1 hafta öncesi olsun
     */
    $atime = $stat['atime'] + 604800;

    /* Dosyaya dokunalım */
    if (!touch('some_file.txt', time(), $atime)) {
        echo 'Dosyaya erişilemedi...';
    } else {
        echo 'Dosyaya başarıyla erişildi...';
    }
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  &note.filesystem-time-res;
  &note.clearstatcache;
  &tip.fopen-wrapper.stat;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>lstat</function></member>
    <member><function>fstat</function></member>
    <member><function>filemtime</function></member>
    <member><function>filegroup</function></member>
    <member><classname>SplFileInfo</classname></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
-->