com doc/tr: New translation: reference/hash/functions/hash-equals.xml reference/hash/functions/hash-hkdf.xml reference/hash/functions/hash-hmac-algos.xml reference/hash/functions/hash-pbkdf2.xml

diff --git a/reference/hash/functions/hash-equals.xml b/reference/hash/functions/hash-equals.xml
new file mode 100644
index 00000000..729d1ea9
--- /dev/null
+++ b/reference/hash/functions/hash-equals.xml
@@ -0,0 +1,130 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 01a7e4684e48c837813eb6492dd8a8c2887f48d3 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>
+  <refpurpose>Zamanlama saldırısı güvenli dize karşılaştırması</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>hash_equals</methodname>
+   <methodparam><type>string</type><parameter>bilinen_dzg</parameter></methodparam>
+   <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.
+  </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.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>bilinen_dzg</parameter></term>
+    <listitem>
+     <para>
+       Karşılaştırılacak dizge
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>kullanıcı_dzg</parameter></term>
+    <listitem>
+     <para>
+      Kullanıcının sağladığı dizge
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+    İki dizge benzerse &true; yoksa &false; döner.
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Aktarılan değiştirgelerden biri dizge değilse <constant>E_WARNING</constant>
+   seviyesinde bir ileti çıktılanır.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example xml:id="foobar.examples.basic">
+    <title>- <function>hash_equals</function> örneği</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$umulan  = crypt('12345', '$2a$07$usesomesillystringforsalt$');
+$dogru   = crypt('12345', '$2a$07$usesomesillystringforsalt$');
+$yanlis = crypt('apple', '$2a$07$usesomesillystringforsalt$');
+
+var_dump(hash_equals($umulan, $dogru));
+var_dump(hash_equals($umulan, $yanlis));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+bool(true)
+bool(false)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Başarılı bir karşılaştırma için verilen dizgeler eşit uzunlukta olmalıdır.
+    Uzunluklar farklıysa hemen &false; döner. Zamanlama saldırısı durumunda
+    bilinen dizgenin uzunluğu değişebilir.
+   </para>
+  </note>
+  <note>
+   <para>
+    Kullanıcını sağladığı dizgeyi ilk değil ikinci değiştirgede  belirtmek
+    önemlidir.
+   </para>
+  </note>
+ </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
+-->
diff --git a/reference/hash/functions/hash-hkdf.xml b/reference/hash/functions/hash-hkdf.xml
new file mode 100644
index 00000000..e7b63ee9
--- /dev/null
+++ b/reference/hash/functions/hash-hkdf.xml
@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: nilgun Status: ready -->
+<refentry xml:id="function.hash-hkdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>hash_hkdf</refname>
+  <refpurpose>Sağlanan anahtar girdisinden HKDF anahtar türevi oluşturur
+  </refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>hash_hkdf</methodname>
+   <methodparam><type>string</type><parameter>algo</parameter></methodparam>
+   <methodparam><type>string</type><parameter>anahtar</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>uzunluk</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>bilgi</parameter><initializer>""</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>tuz</parameter><initializer>""</initializer></methodparam>
+  </methodsynopsis>
+
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>algo</parameter></term>
+     <listitem>
+      <para>
+       Seçilen aşlama algoritmasının ismi ("md5", "sha256", "haval160,4" ve
+       benzerleri). Desteklenen algoritmaların listesi
+       <function>hash_algos</function> işlevinde bulunabilir.
+       <note>
+        <para>
+         Kriptografik olmayan aşlama algoritmalarına izin verilmez.
+        </para>
+       </note>
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>anahtar</parameter></term>
+     <listitem>
+      <para>
+       Kullanılacak anahtar (ikil veri). Boş olamaz.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term> <parameter>uzunluk</parameter></term>
+     <listitem>
+      <para>
+       İstenen çıktının bayt cinsinden uzunluğu.
+       En çok algoritma aş uzunluğunun 255 katı olabilir.
+      </para>
+      <para>
+       <parameter>uzunluk</parameter> olarak <literal>0</literal> verilirse,
+       öntanımlı çıktı uzunluğu seçilen aş boyutunun 255 katından
+       büyük olamaz.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>bilgi</parameter></term>
+     <listitem>
+      <para>
+       Application/context-specific bilgi dizgesi.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>tuz</parameter></term>
+     <listitem>
+      <para>
+       Türetme sırasında kullanılacak tuz.
+      </para>
+      <para>
+       Seçimlik olmasına rağmen, rasgele bir tuz HKDF'nin gücünü önemli ölçüde
+       arttırır.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Türetilen anahtarın ham ikil gösterimini içeren bir
+   dizge,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   <parameter>anahtar</parameter> boşsa veya  <parameter>algo</parameter>
+   kriptografik değilse ya da  <parameter>uzunluk</parameter> negatif veya çok
+   (algoritma aş uzunluğunun 255 katından) büyükse, bir
+   <constant>E_WARNING</constant> çıktılanır.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>- <function>hash_hkdf</function> örneği</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Rasgele bir anahtar ve türetme sırasında anahtarı güçlendirecek tuz üret
+$girdiAnh = random_bytes(32);
+$tuz = random_bytes(16);
+
+// yukarıda oluşturulan girdiyi kullanılarak ayrı bir anahtar çifti türet
+$şifrelemeAnh = hash_hkdf('sha256', $girdiAnh, 32, 'aes-256-encryption', $tuz);
+$kimlikKanıtAnh = hash_hkdf('sha256', $girdiAnh, 32, 'sha-256-authentication', $salt);
+
+var_dump(şifrelemeAnh !== $kimlikKanıtAnh); // bool(true)
+?>
+]]>
+    </programlisting>
+    <para>
+     Yukarıdaki örnekte, şifreleme için AES-256, kimlik kanıtlama için SHA-256
+     kullanılarak bir anahtar çifti üretir (encrypt-then-HMAC oluşturmaya uygun)
+    </para>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>hash_pbkdf2</function></member>
+    <member><link xlink:href="&url.rfc;5869">RFC 5869</link></member>
+    <member><link xlink:href="&url.git.hub;narfbg/hash_hkdf_compat">kullanıcı alanı gerçeklenim</link></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
+-->
diff --git a/reference/hash/functions/hash-hmac-algos.xml b/reference/hash/functions/hash-hmac-algos.xml
new file mode 100644
index 00000000..4be9ad22
--- /dev/null
+++ b/reference/hash/functions/hash-hmac-algos.xml
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 38fb328862c0e14c63c33f295398e28b66d301d5 Maintainer: nilgun Status: ready -->
+<refentry xml:id="function.hash-hmac-algos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>hash_hmac_algos</refname>
+  <refpurpose>hash_hmac için uygun kayıtlı aşlama algoritmalarının listesini
+   döndürür</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description"><!-- {{{ -->
+  &reftitle.description;
+  <methodsynopsis role="procedural">
+   <type>array</type><methodname>hash_hmac_algos</methodname>
+   <void />
+  </methodsynopsis>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+  &reftitle.returnvalues;
+  <para>
+   <function>hash_hmac</function> işlevi için elverişli aşlama algoritmalarından
+   desteklenenlerin listesini içeren sayısal indisli bir dizi döndürür.
+  </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="examples"><!-- {{{ -->
+  &reftitle.examples;
+  <example xml:id="hash-hmac-algos.example.basic"><!-- {{{ -->
+   <title>- <function>hash_hmac_algos</function> örneği</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+print_r(hash_hmac_algos());
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+Array
+(
+    [0] => md2
+    [1] => md4
+    [2] => md5
+    [3] => sha1
+    [4] => sha224
+    [5] => sha256
+    [6] => sha384
+    [7] => sha512/224
+    [8] => sha512/256
+    [9] => sha512
+    [10] => sha3-224
+    [11] => sha3-256
+    [12] => sha3-384
+    [13] => sha3-512
+    [14] => ripemd128
+    [15] => ripemd160
+    [16] => ripemd256
+    [17] => ripemd320
+    [18] => whirlpool
+    [19] => tiger128,3
+    [20] => tiger160,3
+    [21] => tiger192,3
+    [22] => tiger128,4
+    [23] => tiger160,4
+    [24] => tiger192,4
+    [25] => snefru
+    [26] => snefru256
+    [27] => gost
+    [28] => gost-crypto
+    [29] => haval128,3
+    [30] => haval160,3
+    [31] => haval192,3
+    [32] => haval224,3
+    [33] => haval256,3
+    [34] => haval128,4
+    [35] => haval160,4
+    [36] => haval192,4
+    [37] => haval224,4
+    [38] => haval256,4
+    [39] => haval128,5
+    [40] => haval160,5
+    [41] => haval192,5
+    [42] => haval224,5
+    [43] => haval256,5
+)
+]]>
+   </screen>
+  </example><!-- }}} -->
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="notes"><!-- {{{ -->
+  &reftitle.notes;
+  <note>
+   <para>
+    PHP 7.2.0 öncesinde, desteklenen aş algoritmaların bir listesini almanın
+    tek yolu, <function>hash_hmac</function> için uygun olmayan aş
+    algoritmalarını da döndüren <function>hash_algos</function> işlevini
+    çağırmaktı.
+   </para>
+  </note>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="seealso"><!-- {{{ -->
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>hash_hmac</function></member>
+   <member><function>hash_algos</function></member>
+  </simplelist>
+ </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
+-->
diff --git a/reference/hash/functions/hash-pbkdf2.xml b/reference/hash/functions/hash-pbkdf2.xml
new file mode 100644
index 00000000..ea52aec7
--- /dev/null
+++ b/reference/hash/functions/hash-pbkdf2.xml
@@ -0,0 +1,207 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: dabaf662b17f594cd536ff68ea807b0fbc99d0ee Maintainer: nilgun Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.hash-pbkdf2">
+ <refnamediv>
+  <refname>hash_pbkdf2</refname>
+  <refpurpose>Belirtilen bir parolanın PBKDF2 anahtar türevini döndürür
+  </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="procedural">
+   <type>string</type><methodname>hash_pbkdf2</methodname>
+   <methodparam><type>string</type><parameter>algo</parameter></methodparam>
+   <methodparam><type>string</type><parameter>parola</parameter></methodparam>
+   <methodparam><type>string</type><parameter>tuz</parameter></methodparam>
+   <methodparam><type>int</type><parameter>yineleme</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>uzunluk</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>ikil</parameter><initializer>&false;</initializer></methodparam>
+  </methodsynopsis>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>algo</parameter></term>
+     <listitem>
+      <para>
+       Seçilen aşlama algoritmasının ismi ("md5", "sha256", "haval160,4" ve
+       benzerleri). Desteklenen algoritmaların listesi
+       <function>hash_algos</function> işlevinde bulunabilir.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>parola</parameter></term>
+     <listitem>
+      <para>
+       Türetim için kullanılacak parola.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>tuz</parameter></term>
+     <listitem>
+      <para>
+       Türetim için kullanılacak tuz. Rasgele bir değer üretilmelidir.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>yineleme</parameter></term>
+     <listitem>
+      <para>
+       Türetim için dahili olarak uygulanacak yinelemelerin sayısı.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>uzunluk</parameter></term>
+     <listitem>
+      <para>
+       Çıktı dizgesinin uzunluğu. <parameter>ikil</parameter> &true; ise
+       türetilen anahtarın bayt cinsinden uzunluğudur; &false; ise türetilen
+       anahtar uzunluğunun iki katı olmalıdır (her bayt için iki harf/rakam
+       döner).
+      </para>
+      <para>
+       <literal>0</literal> ise belirtilen algoritmanın tüm çıktısı kullanılır.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>ikil</parameter></term>
+     <listitem>
+      <para>
+       &true; ise ham ikil veri, &false; ise küçük harfli onaltılıklar
+       çıktılanır.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues"><!-- {{{ -->
+  &reftitle.returnvalues;
+  <para>
+   <parameter>ikil</parameter> &true; ise türetilen anahtarın ham ikil gösterimi,
+   &false; ise küçük harfli onaltılık gösterimi döner
+  </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   Algoritma bilinmiyorsa, <parameter>yineleme</parameter> sıfırdan küçük
+   veya eşitse, <parameter>uzunluk</parameter> sıfırdan küçükse veya
+   <parameter>tuz</parameter> çok uzunsa (<constant>INT_MAX</constant><literal>
+   - 4</literal>'ten büyükse), bir <constant>E_WARNING</constant> çıktılanır.
+  </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.2.0</entry>
+       <entry>Kriptografik olmayan aş işlevlerinin (adler32, crc32, crc32b,
+       fnv132, fnv1a32, fnv164, fnv1a64, joaat) kullanımı iptal edildi.</entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>- <function>hash_pbkdf2</function> genel kullanım örneği</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$parola = "password";
+$yineleme = 1000;
+
+// openssl_random_pseudo_bytes(), random_bytes()
+// veya uygun bir rasgelelik kaynağı ile rasgele bir tuz üret
+$tuz = openssl_random_pseudo_bytes(16);
+
+$aş = hash_pbkdf2("sha256", $parola, $tuz, $yineleme, 20);
+echo $aş;
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+120fb6cffcf8b32c43e7
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <caution>
+   <para>
+    PBKDF2 yöntemi depolama için parolaları aşlamada kullanılabilir.
+    Bununla birlikte,  <function>password_hash</function> veya
+    <constant>CRYPT_BLOWFISH</constant> ile <function>crypt</function>
+    parola depolamaya daha uygundur.
+   </para>
+  </caution>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>crypt</function></member>
+    <member><function>password_hash</function></member>
+    <member><function>hash</function></member>
+    <member><function>hash_algos</function></member>
+    <member><function>hash_init</function></member>
+    <member><function>hash_hmac</function></member>
+    <member><function>hash_hmac_file</function></member>
+    <member><function>openssl_pbkdf2</function></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
+-->