update for sync with English docs

2026-03-23 23:02:09 +01:00 · 2023-10-23 14:22:47 +03:00
parent 03be9f3ee3
commit 19b5c48617
17 changed files with 237 additions and 215 deletions
--- a/language/errors.xml
+++ b/language/errors.xml
@@ -1,10 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: f0fe52e5a693be46f0c81012b15b929ad264228e Maintainer: nilgun Status: ready -->
-<chapter xml:id="language.errors" xmlns="http://docbook.org/ns/docbook" xmlns:phd="http://www.php.net/ns/phd">
+<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: nilgun Status: ready -->
+<chapter xml:id="language.errors" xmlns="http://docbook.org/ns/docbook">
 <title>Hatalar</title>

- <sect1 phd:chunk="false" xml:id="language.errors.intro">
+ <sect1 annotations="chunk:false" xml:id="language.errors.intro">
  <title>Giriş</title>

  <para>
--- a/language/exceptions.xml
+++ b/language/exceptions.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6f9e433f4b4a591801c3a49fc459550ea1b5f613 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 7a75b854c8c52226d38397e7e8177e339fdb273f Maintainer: nilgun Status: ready -->
 <!-- CREDITS: tpug, dirt, sezer -->
-<chapter xml:id="language.exceptions" xmlns:phd="http://www.php.net/ns/phd">
+<chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook">
 <title>İstisnalar</title>
 <para>
  PHP diğer programlama dillerindekine benzer bir istisna modeline
@@ -29,7 +29,7 @@
  satırına sahip olması gerekiyordu.
 </para>

- <sect1 phd:chunk="false" xml:id="language.exceptions.catch">
+ <sect1 annotations="chunk:false" xml:id="language.exceptions.catch">
  <title><literal>catch</literal></title>
  <para>
   Bir &catch; bloğu oluşturulan bir istisnaya nasıl yanıt verileceğini
@@ -70,7 +70,7 @@
  </para>
 </sect1>

- <sect1 phd:chunk="false" xml:id="language.exceptions.finally">
+ <sect1 annotations="chunk:false" xml:id="language.exceptions.finally">
  <title><literal>finally</literal></title>
  <para>
   &catch; bloklarının yerine veya sonrasında bir
@@ -88,7 +88,7 @@
  </para>
 </sect1>

- <sect1 phd:chunk="false" xml:id="language.exceptions.exception-handler">
+ <sect1 annotations="chunk:false" xml:id="language.exceptions.exception-handler">
  <title>Küresel istisna işleyici</title>
  <para>
   Eğer bir istisnanın küresel bağlama kadar kabarcıklanmasına izin verilirse,
@@ -100,7 +100,7 @@
  </para>
 </sect1>

- <sect1 phd:chunk="false" xml:id="language.exceptions.notes">
+ <sect1 annotations="chunk:false" xml:id="language.exceptions.notes">
  &reftitle.notes;
  <note>
   <para>
@@ -135,7 +135,7 @@ set_error_handler('exceptions_error_handler');
  </tip>
 </sect1>

- <sect1 phd:chunk="false" xml:id="language.exceptions.examples">
+ <sect1 annotations="chunk:false" xml:id="language.exceptions.examples">
  &reftitle.examples;
  <example>
   <title>- Bir İstisna Oluşturmak</title>
--- a/language/functions.xml
+++ b/language/functions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1f8a9bbeec69c16c4b965c350525baf5744b8f4e Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: b22f4a798a435fb159af88806341ce9cbe9f38c2 Maintainer: nilgun Status: ready -->
 <!-- CREDITS: tpug, sezer -->
 <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
  <title>İşlevler</title>
@@ -494,17 +494,6 @@ Bir kase az çilek içeren süzme yoğurt yapılıyor.
     <literal>...</literal> konarak listenin uzatılmasını destekler.
    </simpara>

-    <note>
-     <simpara>
-      Değişken uzunlukta bağımsız değişken listesi
-      <function>func_num_args</function>,
-      <function>func_get_arg</function> ve
-      <function>func_get_args</function> işlevleri kullanılarak da elde
-      edilebilir. Bu teknik <literal>...</literal> kullanımından öncesine ait
-      olduğundan kullanımı önerilmez.
-     </simpara>
-    </note>
-
    <para>
     Bağımsız değişken listeleri, işlevin değişken sayıda bağımsız değişken kabul ettiğini
     belirtmek için <literal> ... </literal> simgesini içerebilir. Bu durumda
@@ -623,46 +612,6 @@ Catchable fatal error: Argument 2 passed to total_intervals() must be an instanc
    olarak da aktarabilirsiniz.
   </para>

-  <sect3 xml:id="functions.variable-arg-list.old">
-   <title>Daha eski PHP sürümlerinde</title>
-
-   <para>
-    Bir işlevin değişken sayıda bağımsız değişken içerebilmesi için özel bir
-    sözdizimi gerekmez; ancak işlevin bağımsız değişkenlerine erişim için
-    <function>func_num_args</function>, <function>func_get_arg</function>
-    ve <function>func_get_args</function> kullanmak gerekir.
-   </para>
-
-   <para>
-    Eski PHP sürümlerinde yukarıdaki ilk örnek şöyle gerçeklenirdi;
-   </para>
-   <para>
-    <example>
-     <title>Eski PHP sürümlerinde değişken bağımsız değişkenlere erişim</title>
-     <programlisting role="php">
-<![CDATA[
-<?php
-function sum() {
-    $acc = 0;
-    foreach (func_get_args() as $n) {
-        $acc += $n;
-    }
-    return $acc;
-}
-
-echo sum(1, 2, 3, 4);
-?>
-]]>
-      </programlisting>
-      &example.outputs;
-      <screen>
-<![CDATA[
-10
-]]>
-      </screen>
-     </example>
-    </para>
-   </sect3>
  </sect2>

  <sect2 xml:id="functions.named-arguments">
--- a/language/operators/errorcontrol.xml
+++ b/language/operators/errorcontrol.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 52407313885d27a4e891e08dd2e2481bcc39e244 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 8d20b244cd76f802a31f5a9fc7ca8d97e2163391 Maintainer: nilgun Status: ready -->
 <sect1 xml:id="language.operators.errorcontrol">
 <title>Hata Denetim İşleçleri</title>
 <simpara>
@@ -17,8 +17,9 @@
   PHP 8.0.0'dan önce, özel hata işleyicisinden çağrılan
   <function>error_reporting</function> işlevi, hata <literal>@</literal>
   işleci ile bastırılmış olsa bile daima <literal>0</literal> döndürürdü.
-   PHP 8.0.0 ve sonrasında  <literal>E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR
-   | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE</literal> dönmektedir.
+   PHP 8.0.0 ve sonrasında  <literal>E_ERROR | E_CORE_ERROR |
+    E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE</literal>
+   bitsel ifadesinin değeri dönmektedir.
  </para>
 </warning>

--- a/language/operators/increment.xml
+++ b/language/operators/increment.xml
@@ -1,19 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 52407313885d27a4e891e08dd2e2481bcc39e244 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 02302a754aa0b2ea9a783f792e2c2c6c54230829 Maintainer: nilgun Status: ready -->
 <sect1 xml:id="language.operators.increment">
- <title>Arttırım ve Eksiltim İşleçleri</title>
+ <title>Artırım ve Eksiltim İşleçleri</title>
 <para>
-  PHP, C tarzı önceden ve sonradan arttırım ve eksiltim işleçlerini
-  destekler.
+  PHP, önceden ve sonradan artırım ve eksiltim işleçlerini destekler.
+  Bunlar değeri bir artıran veya eksilten tek terimli işleçlerdir.
 </para>
- <note>
-  <simpara>
-   Arttırım ve eksiltim işleçleri sadece sayıları ve dizeleri etkiler.
-   Diziler, nesneler, mantıksallar ve özkaynaklar etkilenmez.
-   &null; değerini eksiltmenin bir etkisi yoktur fakat arttırmanın sonucu
-   <literal>1</literal>'dir.
-  </simpara>
- </note>
 <table>
  <title>Arttırım ve Eksiltim İşleçleri</title>
  <tgroup cols="3">
@@ -27,15 +19,15 @@
   <tbody>
    <row>
     <entry><userinput>++$a</userinput></entry>
-     <entry>Önceden arttırım</entry>
-     <entry><varname>$a</varname> bir arttırıldıktan sonra
+     <entry>Önceden artırım</entry>
+     <entry><varname>$a</varname> bir artırıldıktan sonra
     döndürülür.</entry>
    </row>
    <row>
     <entry><userinput>$a++</userinput></entry>
-     <entry>Sonradan arttırım</entry>
+     <entry>Sonradan artırım</entry>
     <entry><varname>$a</varname> döndürüldükten sonra değeri bir
-     arttırılır.</entry>
+     artırılır.</entry>
    </row>
    <row>
     <entry><userinput>--$a</userinput></entry>
@@ -58,43 +50,95 @@
   <programlisting role="php">
 <![CDATA[
 <?php
-echo "<h3>Sonradan arttırım</h3>\n";
+echo "Sonradan artırım\n";
 $a = 5;
-echo "5 olmalı: " . $a++ . "<br />\n";
-echo "6 olmalı: " . $a . "<br />\n";
+var_dump($a++);
+var_dump($a);

-echo "<h3>Önceden arttırım</h3>\n";
+echo "Önceden artırım\n";
 $a = 5;
-echo "6 olmalı: " . ++$a . "<br />\n";
-echo "6 olmalı: " . $a . "<br />\n";
+var_dump(++$a);
+var_dump($a);

-echo "<h3>Sonradan eksiltim</h3>\n";
+echo "Sonradan eksiltim\n";
 $a = 5;
-echo "5 olmalı: " . $a-- . "<br />\n";
-echo "4 olmalı: " . $a . "<br />\n";
+var_dump($a--);
+var_dump($a);

-echo "<h3>Önceden eksiltim</h3>\n";
+echo "Sonradan eksiltim\n";
 $a = 5;
-echo "4 olmalı: " . --$a . "<br />\n";
-echo "4 olmalı: " . $a . "<br />\n";
+var_dump(--$a);
+var_dump($a);
 ?>
 ]]>
   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+Sonradan artırım:
+int(5)
+int(6)
+Önceden artırım:
+int(6)
+int(6)
+Sonradan eksiltim:
+int(5)
+int(4)
+Sonradan eksiltim:
+int(4)
+int(4)
+]]>
+   </screen>
  </informalexample>
+  <warning>
+   <para>
+    Artırım ve eksiltim işleçlerinin <type>bool</type> türündeki değerler
+    üstünde etkisi yoktur. İleri sürümlerde değer örtük olarak
+    <type>int</type> türüne dönüşüm uygulanacağından PHP 8.3.0 ve sonrasında
+    bir <constant>E_WARNING</constant> çıktılanır.
+   </para>
+   <para>
+    Eksiltim işlecinin <type>null</type> türünde değerler üzerinde etkisi
+    yoktur. İleri sürümlerde değer örtük olarak <type>int</type> türüne
+    dönüşüm uygulanacağından PHP 8.3.0 ve sonrasında bir
+    <constant>E_WARNING</constant> çıktılanır.
+   </para>
+   <para>
+    Değer <link linkend="language.types.numeric-strings">sayısal dizge</link>
+    değilse eksiltim işleci etkisizdir. İleri sürümlerde
+    <classname>TypeError</classname> oluşturacak olan bu durum PHP 8.3.0 ve
+    sonrasında bir <constant>E_WARNING</constant> çıktılanmasına sebep olur.
+   </para>
+  </warning>
+  <note>
+   <para>
+    Aşırı yüklemeyi destekleyen dahili nesnelerin toplama ve çıkarma
+    işlemlerinde de artırım ve eksiltim yapılabilir. Böyle bir dahili
+    nesneye örnek olarak <classname>GMP</classname> verilebilir.
+   </para>
+  </note>
 </para>
- <para>
-  PHP, karakter değişkenleri üzerinde çalışırken C'nin değil Perl'in
-  yöntemlerini izler. Örneğin, PHP ve Perl'de
-  <literal>$a = 'Z'; $a++;</literal> ifadesi <literal>$a</literal>
-  içinde 'AA' değerini döndürürken, C'de <literal>a = 'Z'; a++;</literal>
-  ifadesi <literal>a</literal> içinde'[' döndürür. <literal>'Z'</literal>
-  için ASCII değer 90, <literal>'['</literal> için 91'dir.
-  Karakterlerin arttırılabileceğine fakat azaltılamayacağına ve sadece
-  ASCII harflerin ve rakamların (a-z ve A-Z, 0-9) desteklendiğine dikkat
-  edilmelidir. Diğer karakterler üzerinde arttırım ve eksiltim etkisiz olup
-  özgün değer değişmeden döndürürlür.
+
+ <sect2 xml:id="language.operators.increment.string">
+  <title>PERL dizge artırım özelliği</title>
+  <warning>
+   <simpara>
+    Bu özelliğin PHP 8.3.0 ve sonrasında kullanımı bazı durumlarda
+    önerilmemekte olup böyle bir durumun ortaya çıkmaması için bu özellik
+    yerine <function>str_increment</function> işlevi kullanılmalıdır.
+   </simpara>
+  </warning>
+
+  <para>
+   Değer <link linkend="language.types.numeric-strings">sayısal dizge</link>
+   değilse dizgeye artırım uygulanabilir. Bunun için dizgenin abecesaysal
+   ASCII dizge olması gerekir. Harflerin bir sonraki harfe kadar artırılması
+   durumunda, <literal>Z</literal> harfine ulaşıldığında artış soldaki değere
+   taşınır. Örneğin, <code>$a = 'Z'; $a++;</code> için <varname>$a</varname>
+   değeri <literal>'AA'</literal> olur.
+  </para>
  <example>
-   <title>- Karakter değişkenleri üzerinde aritmetik işlemler</title>
+   <title>- PERL dizge artırım örneği</title>
   <programlisting role="php">
 <![CDATA[
 <?php
@@ -142,10 +186,43 @@ A14
 ]]>
   </screen>
  </example>
- </para>
- <para>
-  Mantıksal değerlere arttırım ve eksiltim uygulamanın bir etkisi olmaz.
- </para>
+
+  <warning>
+   <para>
+    Abecesayısal dizge, <link linkend="language.types.numeric-strings">sayısal
+    dizge</link> olarak yorumlanırsa değer <type>int</type> veya
+    <type>float</type> türüne dönüştürülür. Bu özellikle üstel gösterimle
+    yazılmış gerçel bir sayı gibi görünen dizgelerde ortaya çıkar.
+    <function>str_increment</function> işlevi böyle örtük tür dönüşümlerinden
+    etkilenmez.
+   </para>
+   <example>
+    <title>- float türüne dönüştürülen abecesayısal dizge</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$s = "5d9";
+var_dump(++$s);
+var_dump(++$s);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+string(3) "5e0"
+float(6)
+]]>
+    </screen>
+    <para>
+     Bunun nedeni, <literal>"5e0"</literal> değerinin <type>float</type>
+     olarak yorumlanması ve artırılmadan önce <literal>5,0</literal> değerine
+     dönüştürülmesidir.
+    </para>
+   </example>
+  </warning>
+ </sect2>
+
 </sect1>

 <!-- Keep this comment at the end of the file
--- a/language/predefined/variables/httpresponseheader.xml
+++ b/language/predefined/variables/httpresponseheader.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: cb0630b14901459c0bf1556e7d68f1b4c0d3796e Maintainer: yasar Status: ready -->
+<!-- EN-Revision: c2cf2290247ae581d10dc4d74d91cc4f97293daa Maintainer: yasar Status: ready -->
 <phpdoc:varentry xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="reserved.variables.httpresponseheader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>$http_response_header</refname>
@@ -29,8 +28,9 @@
 <?php
 function get_contents() {
  file_get_contents("http://example.com");
-  var_dump($http_response_header);
+  var_dump($http_response_header); // değişken yerel etki alanında değerlendirilir
 }
+// get_contents() çağrısı değişkeni işlev etki alanının dışında değerlendirmez
 get_contents();
 var_dump($http_response_header);
 ?>
@@ -59,6 +59,8 @@ array(9) {
  [8]=>
  string(38) "Content-Type: text/html; charset=UTF-8"
 }
+
+Warning: Undefined variable $http_response_header
 NULL
 ]]>
    </screen>
--- a/reference/array/functions/array-change-key-case.xml
+++ b/reference/array/functions/array-change-key-case.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2c0d7af2fd69ecd914abec5cfebae53aca8d491f Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 58d11dfe19531e1355980b2892964c07dd8e8068 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.array-change-key-case" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>array_change_key_case</refname>
@@ -52,8 +52,7 @@
  &reftitle.returnvalues;
  <para>
   Anahtarların büyük harflerden veya küçük harflerden oluştuğu bir dizi
-   döner. Eğer belirtilen <parameter>dizi</parameter> bir dizi değilse
-   &null; döner.
+   döner.
  </para>
 </refsect1>

--- a/reference/errorfunc/functions/error-reporting.xml
+++ b/reference/errorfunc/functions/error-reporting.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: de9c65c91ff1710d8b2d2ec955caea0162679305 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 9caac4c5cce859b4ae5d497972442fcfaa840d81 Maintainer: nilgun Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.error-reporting">
 <refnamediv>
  <refname>error_reporting</refname>
@@ -52,10 +52,18 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Eski <link linkend="ini.error-reporting">error_reporting</link> değeri
-   veya <parameter>hata_seviyesi</parameter> bağımsız değişkeni atlanmışsa, daima
-   geçerli hata raporlama seviyesi döner.
+   <parameter>hata_seviyesi</parameter> bağımsız değişkenine dönüşmeden
+   <emphasis>önce</emphasis>,
+   <link linkend="ini.error-reporting">error_reporting</link> hata raporlama
+   seviyesi döner.
  </para>
+  <note>
+   <simpara>
+    <link linkend="language.operators.errorcontrol">Hata denetimi</link> için
+    <literal>@</literal>-işleci hatanın işlenmesi sırasında
+    <parameter>hata_seviyesi</parameter>ni değiştirir.
+   </simpara>
+  </note>
 </refsect1>

 <refsect1 role="examples">
@@ -112,12 +120,13 @@ ini_set('error_reporting', E_ALL);
  &reftitle.seealso;
  <para>
   <simplelist>
-    <member>The <link linkend="ini.display-errors">display_errors</link>
+    <member><link linkend="ini.display-errors">display_errors</link>
    yönergesi</member>
-    <member>The <link linkend="ini.html-errors">html_errors</link>
+    <member><link linkend="ini.html-errors">html_errors</link>
    yönergesi</member>
-    <member>The <link linkend="ini.xmlrpc-errors">xmlrpc_errors</link>
+    <member><link linkend="ini.xmlrpc-errors">xmlrpc_errors</link>
    yönergesi</member>
+    <member><link linkend="language.operators.errorcontrol">hata denetim</link> işleci</member>
    <member><function>ini_set</function></member>
   </simplelist>
  </para>
--- a/reference/hash/functions/hash-copy.xml
+++ b/reference/hash/functions/hash-copy.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: f3e46c7b29574706553f3d892c86aa78ded9e4c0 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 584a9fb976cccc93109776a904ec1c5ddb2d580f Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-copy" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_copy</refname>
@@ -13,7 +12,7 @@
   <methodparam><type>HashContext</type><parameter>bağlam</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Aşlama Bağlamını kopyalar
+   Aşlama bağlamını kopyalar.
  </para>
 </refsect1>

@@ -73,15 +72,15 @@
    <programlisting role="php">
 <![CDATA[
 <?php
-$context = hash_init("md5");
-hash_update($context, "data");
+$context = hash_init("sha256");
+hash_update($context, "Pijamalı hasta ");

 /* kulanmaya devem edebilmek için bağlamı kopyalayalım */
 $copy_context = hash_copy($context);

 echo hash_final($context), "\n";

-hash_update($copy_context, "data");
+hash_update($copy_context, "yağız şoföre çabucak güvendi.");
 echo hash_final($copy_context), "\n";
 ?>
 ]]>
@@ -89,8 +88,8 @@ echo hash_final($copy_context), "\n";
    &example.outputs;
    <screen>
 <![CDATA[
-8d777f385d3dfec8815d20f7496026dc
-511ae0b1c13f95e5f08f1a0dd3da3d93
+36ae7cdae49d9a73ac20adb1325eb6855cb11ba7f502e9c549d0aeebd286abab
+04eb8190a875ba9b6d05edbb0873e47ad41c48c2fac96e404040568868f3f20d
 ]]>
    </screen>
   </example>
--- a/reference/hash/functions/hash-equals.xml
+++ b/reference/hash/functions/hash-equals.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 91e303f2d27cbca485137230fa7d2e50e75f19a6 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 472a8ae5cc4e91fcf8365760ba07787f61087aae Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-equals" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>hash_equals</refname>
@@ -14,13 +14,22 @@
   <methodparam><type>string</type><parameter>kullanıcı_dzg</parameter></methodparam>
  </methodsynopsis>
  <para>
-   İki dizgenin uzunluklarını aynı zamanı kullanarak karşılaştırır.
-   Uzunluklar farklıysa hemen &false; döner.
+   Yürütme sırasında <parameter>bilinen_dzg</parameter> içeriği hakkında
+   bilgi sızdırmaksızın iki dizgenin eşit olup olmadığına bakar.
  </para>
  <para>
-   Bu işlev, zamanlama saldırılarını azaltmak için kullanılmalıdır; Örneğin,
-  <function>crypt</function> parola aşlarını denerken.
+   Bu işlev, zamanlama saldırılarını azaltmak için kullanılabilir.
+   <code>===</code> ile düzenli karşılaştırma yapmak, iki değerin farklı olup
+   olmadığına ve ilk farkın hangi konumda bulunabileceğine bağlı olarak daha
+   fazla veya daha az zaman alacaktır, dolayısıyla
+   <parameter>bilinen_dzg</parameter> içeriği hakkında bilgi sızdırılacaktır.
  </para>
+  <caution>
+   <para>
+    Kullanıcı tarafından sağlanan dizgenin birinci yerine ikinci bağımsız
+    değişken olarak belirtilmesi önemlidir.
+   </para>
+  </caution>
 </refsect1>

 <refsect1 role="parameters">
@@ -30,7 +39,7 @@
    <term><parameter>bilinen_dzg</parameter></term>
    <listitem>
     <para>
-       Karşılaştırılacak dizge
+      Gizli tutulması gereken dizge.
     </para>
    </listitem>
   </varlistentry>
@@ -38,7 +47,7 @@
    <term><parameter>kullanıcı_dzg</parameter></term>
    <listitem>
     <para>
-      Kullanıcının sağladığı dizge
+      Karşılaştıma için kullanıcının sağladığı dizge.
     </para>
    </listitem>
   </varlistentry>
@@ -60,20 +69,25 @@
    <programlisting role="php">
 <![CDATA[
 <?php
-$umulan  = crypt('12345', '$2a$07$usesomesillystringforsalt$');
-$dogru   = crypt('12345', '$2a$07$usesomesillystringforsalt$');
-$yanlis = crypt('apple', '$2a$07$usesomesillystringforsalt$');
+$gizliAnahtar = '8uRhAeH89naXfFXKGOEj';

-var_dump(hash_equals($umulan, $dogru));
-var_dump(hash_equals($umulan, $yanlis));
+// Değer ve imzayı kullanıcı örn. URL içinde sağlar ve
+// $_GET kullanılarak alınır.
+$değer = 'username=rasmuslerdorf';
+$imza = '8c35009d3b50caf7f5d2c1e031842e6b7823a1bb781d33c5237cd27b57b5f327';
+
+if (hash_equals(hash_hmac('sha256', $değer, $gizliAnahtar), $signature)) {
+    echo "Değer doğru imzalanmış.", PHP_EOL;
+} else {
+    echo "Değer tahrif edilmiş.", PHP_EOL;
+}
 ?>
 ]]>
    </programlisting>
    &example.outputs;
    <screen>
 <![CDATA[
-bool(true)
-bool(false)
+Değer doğru imzalanmış.
 ]]>
    </screen>
   </example>
@@ -89,12 +103,15 @@ bool(false)
    bilinen dizgenin uzunluğu değişebilir.
   </para>
  </note>
-  <note>
-   <para>
-    Kullanıcını sağladığı dizgeyi ilk değil ikinci bağımsız değişkende  belirtmek
-    önemlidir.
-   </para>
-  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>hash_hmac</function></member>
+   </simplelist>
+  </para>
 </refsect1>

 </refentry>
--- a/reference/hash/functions/hash-file.xml
+++ b/reference/hash/functions/hash-file.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ac6b36357e5f5294a2c0577b85d193d84f0017ff Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 20dcfbb0dd7150cbe5dfd7903a3001229295c549 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-file" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_file</refname>
@@ -104,16 +104,16 @@
 <?php
 /* Aşı hesaplanacak dosyayı oluşturalım */
 file_put_contents('example.txt',
-    'Dağ başını duman almış gümüş dere durmaz akar.');
+    'Pijamalı hasta yağız şoföre çabucak güvendi.');

-echo hash_file('md5', 'example.txt');
+echo hash_file('sha256', 'example.txt');
 ?>
 ]]>
    </programlisting>
    &example.outputs;
    <screen>
 <![CDATA[
-44366f3bc27a70d68b5e77157d9644ec
+04eb8190a875ba9b6d05edbb0873e47ad41c48c2fac96e404040568868f3f20d
 ]]>
    </screen>
   </example>
--- a/reference/hash/functions/hash-final.xml
+++ b/reference/hash/functions/hash-final.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: dabaf662b17f594cd536ff68ea807b0fbc99d0ee Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 20dcfbb0dd7150cbe5dfd7903a3001229295c549 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-final" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_final</refname>
@@ -78,42 +77,6 @@
  </para>
 </refsect1>

- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-   <example>
-    <title>- <function>hash_final</function> örneği</title>
-    <programlisting role="php">
-<![CDATA[
-<?php
-$ctx = hash_init('sha1');
-hash_update($ctx, 'Dağ başını duman almış gümüş dere durmaz akar.');
-echo hash_final($ctx);
-?>
-]]>
-    </programlisting>
-    &example.outputs;
-    <screen>
-<![CDATA[
-5437dd7cc3b1a3572da12bf314963301f270e8
-]]>
-    </screen>
-   </example>
-  </para>
- </refsect1>
-
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>hash_init</function></member>
-    <member><function>hash_update</function></member>
-    <member><function>hash_update_stream</function></member>
-    <member><function>hash_update_file</function></member>
-   </simplelist>
-  </para>
- </refsect1>
-
 </refentry>

 <!-- Keep this comment at the end of the file
--- a/reference/hash/functions/hash-hmac-file.xml
+++ b/reference/hash/functions/hash-hmac-file.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 91e303f2d27cbca485137230fa7d2e50e75f19a6 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 50960545e781ff94ba371befc04346de48a0bb82 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-hmac-file" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_hmac_file</refname>
@@ -127,16 +127,16 @@
 <?php
 /* Aşı hesaplanacak dosyayı oluşturalım */
 file_put_contents('example.txt',
-    'Dağ başını duman almış gümüş dere durmaz akar.');
+    'Pijamalı hasta yağız şoföre çabucak güvendi.');

-echo hash_hmac_file('md5', 'example.txt', 'çokgizli');
+echo hash_hmac_file('sha256', 'example.txt', 'çokgizli');
 ?>
 ]]>
    </programlisting>
    &example.outputs;
    <screen>
 <![CDATA[
-51b361d728a6f44309941d09f1e6ba6f
+863f6b38ab2a65abe35721011273a251026eb485f8a62926afea24188881391b
 ]]>
    </screen>
   </example>
--- a/reference/hash/functions/hash-hmac.xml
+++ b/reference/hash/functions/hash-hmac.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 91e303f2d27cbca485137230fa7d2e50e75f19a6 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 33b00cc27920489594afa964ffbf2660e4e245f7 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-hmac" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_hmac</refname>
@@ -120,15 +120,15 @@
    <programlisting role="php">
 <![CDATA[
 <?php
-echo hash_hmac('ripemd160',
-    'Dağ başını duman almış gümüş dere durmaz akar.', 'çokgizli');
+echo hash_hmac('sha256',
+    'Pijamalı hasta yağız şoföre çabucak güvendi.', 'çokgizli');
 ?>
 ]]>
    </programlisting>
    &example.outputs;
    <screen>
 <![CDATA[
-f23fd9908400e8fa4b388a7228c6aa686bbdf74e
+863f6b38ab2a65abe35721011273a251026eb485f8a62926afea24188881391b
 ]]>
    </screen>
   </example>
@@ -143,6 +143,7 @@ f23fd9908400e8fa4b388a7228c6aa686bbdf74e
    <member><function>hash_hmac_algos</function></member>
    <member><function>hash_init</function></member>
    <member><function>hash_hmac_file</function></member>
+    <member><function>hash_equals</function></member>
   </simplelist>
  </para>
 </refsect1>
--- a/reference/hash/functions/hash-init.xml
+++ b/reference/hash/functions/hash-init.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 91e303f2d27cbca485137230fa7d2e50e75f19a6 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 20dcfbb0dd7150cbe5dfd7903a3001229295c549 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-init" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_init</refname>
@@ -139,17 +139,23 @@
    <programlisting role="php">
 <![CDATA[
 <?php
-$ctx = hash_init('md5');
-hash_update($ctx, 'Dağ başını duman almış ');
-hash_update($ctx, 'Gümüş dere durmaz akar.');
-echo hash_final($ctx);
+$hash = hash('sha256', 'Pijamalı hasta yağız şoföre çabucak güvendi.');
+
+$ctx = hash_init('sha256');
+hash_update($ctx, 'Pijamalı hasta ');
+hash_update($ctx, 'yağız şoföre çabucak güvendi.');
+$incremental_hash = hash_final($ctx);
+
+echo $incremental_hash, PHP_EOL;
+var_dump($hash === $incremental_hash);
 ?>
 ]]>
    </programlisting>
    &example.outputs;
    <screen>
 <![CDATA[
-57ef7029fa14e930500d3c6d371ef12b
+04eb8190a875ba9b6d05edbb0873e47ad41c48c2fac96e404040568868f3f20d
+bool(true)
 ]]>
    </screen>
   </example>
--- a/reference/hash/functions/hash-update-stream.xml
+++ b/reference/hash/functions/hash-update-stream.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: dabaf662b17f594cd536ff68ea807b0fbc99d0ee Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 20dcfbb0dd7150cbe5dfd7903a3001229295c549 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash-update-stream" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash_update_stream</refname>
@@ -94,10 +93,11 @@
 <![CDATA[
 <?php
 $fp = tmpfile();
-fwrite($fp, 'Dağ başını duman almış gümüş dere durmaz akar.');
+fwrite($fp, 'yağız şoföre çabucak güvendi.');
 rewind($fp);

-$ctx = hash_init('md5');
+$ctx = hash_init('sha256');
+hash_update($ctx, 'Pijamalı hasta ');
 hash_update_stream($ctx, $fp);
 echo hash_final($ctx);
 ?>
@@ -106,7 +106,7 @@ echo hash_final($ctx);
    &example.outputs;
    <screen>
 <![CDATA[
-08badfbbc252d96b1e4615cca2b0424e
+04eb8190a875ba9b6d05edbb0873e47ad41c48c2fac96e404040568868f3f20d
 ]]>
    </screen>
   </example>
--- a/reference/hash/functions/hash.xml
+++ b/reference/hash/functions/hash.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4b4c8b47408da359d4d0ab39f19673f006895908 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 20dcfbb0dd7150cbe5dfd7903a3001229295c549 Maintainer: nilgun Status: ready -->
 <refentry xml:id="function.hash" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>hash</refname>
@@ -108,14 +108,14 @@
    <programlisting role="php">
 <![CDATA[
 <?php
-echo hash('ripemd160', 'Dağ başını duman almış gümüş dere durmaz akar.');
+echo hash('sha256', 'Pijamalı hasta yağız şoföre çabucak güvendi.');
 ?>
 ]]>
    </programlisting>
    &example.outputs;
    <screen>
 <![CDATA[
-5397ae847c5c30e0ca3d8b2f3b3f71fd6be383bd
+04eb8190a875ba9b6d05edbb0873e47ad41c48c2fac96e404040568868f3f20d
 ]]>
    </screen>
   </example>