svn: /phpdoc/bg/trunk/reference/ filesystem/functions/file.xml filesystem/functions/fwrite.xml session/functions/session-cache-limiter.xml

Modified: phpdoc/bg/trunk/reference/filesystem/functions/file.xml
===================================================================
--- phpdoc/bg/trunk/reference/filesystem/functions/file.xml	2016-05-04 15:40:58 UTC (rev 339132)
+++ phpdoc/bg/trunk/reference/filesystem/functions/file.xml	2016-05-04 22:33:33 UTC (rev 339133)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: ogre Status: ready -->
+<!-- EN-Revision: 334621 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: ogre -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file">
  <refnamediv>
   <refname>file</refname>
@@ -12,7 +13,7 @@
   <methodsynopsis>
    <type>array</type><methodname>file</methodname>
    <methodparam><type>string</type><parameter>filename</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
    <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -25,7 +26,7 @@
    </para>
   </note>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -52,7 +53,8 @@
          </term>
          <listitem>
           <simpara>
-           Търси файла и в <link linkend="ini.include-path">include_path</link>.
+           Търси файла в <link
+           linkend="ini.include-path">include_path</link>.
           </simpara>
          </listitem>
         </varlistentry>
@@ -76,31 +78,6 @@
           </simpara>
          </listitem>
         </varlistentry>
-        <varlistentry>
-         <term>
-          <constant>FILE_TEXT</constant>
-         </term>
-         <listitem>
-          <simpara>
-           Съдържанието се получава в знаков набор UTF-8. Можете да го получите
-           в различно кодиране чрез използването на различен контекст. Този флаг
-           не може да бъде използван с <constant>FILE_BINARY</constant>.
-           Този флаг е наличен от PHP 6 и по-високи версии.
-          </simpara>
-         </listitem>
-        </varlistentry>
-        <varlistentry>
-         <term>
-          <constant>FILE_BINARY</constant>
-         </term>
-         <listitem>
-          <simpara>
-           При указване на този флаг, файлът се изчита в двоичен режим.
-           Това е подразбиращата се стойност и не може да се използва с
-           <constant>FILE_TEXT</constant>. Този флаг е наличен от PHP 6 и по-високи версии.
-          </simpara>
-         </listitem>
-        </varlistentry>
        </variablelist>
       </para>
      </listitem>
@@ -109,7 +86,8 @@
      <term><parameter>context</parameter></term>
      <listitem>
       <para>
-       Ресурс от тип контекст, създаден с функцията <function>stream_context_create</function>/
+       Ресурс от тип контекст, създаден с функцията
+       <function>stream_context_create</function>.
       </para>
       <para>
        &note.context-support;
@@ -119,7 +97,7 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -137,7 +115,7 @@
   </note>
   &note.line-endings;
  </refsect1>
-
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -151,24 +129,6 @@
      </thead>
      <tbody>
       <row>
-       <entry>6.0.0</entry>
-       <entry>
-        Добавена е поддръжка за флаговете <constant>FILE_TEXT</constant> и <constant>FILE_BINARY</constant>.
-       </entry>
-      </row>
-      <row>
-       <entry>5.0.0</entry>
-       <entry>
-        Добавен е параметър <parameter>context</parameter>.
-       </entry>
-      </row>
-      <row>
-       <entry>5.0.0</entry>
-       <entry>
-        Преди PHP 5.0.0 параметърът <parameter>flags</parameter> се отнасяше единствено за <link linkend="ini.include-path">include_path</link> и се включваше с подаване на 1.
-       </entry>
-      </row>
-      <row>
        <entry>4.3.0</entry>
        <entry>
         Функцията <function>file</function> е вече двоично безопасна.
@@ -179,7 +139,7 @@
    </informaltable>
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -194,7 +154,7 @@

 // Извъртане на масива с показване на HTML кода с добавени номера на редове
 foreach ($lines as $line_num => $line) {
-    echo "Ред #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
+    echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
 }

 // Друг пример, нека изчетем уеб страница с низ. Вижте също file_get_contents().
@@ -202,19 +162,18 @@

 // Използване на опционалните флаг параметри, налични от PHP 5 нататък
 $trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
-
 ?>
 ]]>
     </programlisting>
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   &warn.ssl-non-standard;
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -229,7 +188,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/bg/trunk/reference/filesystem/functions/fwrite.xml
===================================================================
--- phpdoc/bg/trunk/reference/filesystem/functions/fwrite.xml	2016-05-04 15:40:58 UTC (rev 339132)
+++ phpdoc/bg/trunk/reference/filesystem/functions/fwrite.xml	2016-05-04 22:33:33 UTC (rev 339133)
@@ -1,12 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: ogre Status: ready -->
+<!-- EN-Revision: 297028 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: ogre -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fwrite">
  <refnamediv>
   <refname>fwrite</refname>
   <refpurpose>Двоично-безопасно записване във файл</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -17,11 +18,11 @@
   </methodsynopsis>
   <simpara>
    <function>fwrite</function> записва съдържанието на
-   <parameter>string</parameter> във файловия поток
-   сочен от <parameter>handle</parameter>.
+   <parameter>string</parameter> във файловия поток сочен от
+   <parameter>handle</parameter>.
   </simpara>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -61,41 +62,62 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   <function>fwrite</function> връща броя на записаните байтове или &false; при грешка.
+   <function>fwrite</function> връща броя на записаните
+   байтове или &false; при грешка.
   </simpara>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
    <para>
-      При операционни системи, които правят разлика между двоични и
-      текстови файлове (като Windows), файлът трябва да е отворен
-      с флаг "b" при извикването на <function>fopen</function>.
+    Записа в мрежов поток може да приключи преди низът да бъде записан изцяло.
+    Върнатата стойност на <function>fwrite</function> може да бъде проверена по следния начин:
+    <programlisting role="php">
+<![CDATA[
+<?php
+function fwrite_stream($fp, $string) {
+    for ($written = 0; $written < strlen($string); $written += $fwrite) {
+        $fwrite = fwrite($fp, substr($string, $written));
+        if ($fwrite === false) {
+            return $written;
+        }
+    }
+    return $written;
+}
+?>
+]]>
+    </programlisting>
    </para>
   </note>
+
   <note>
    <para>
-    Ако сте отворили файла сочен от <parameter>handle</parameter> с
-    <function>fopen</function> в режим на добавяне, записванията на
-    <function>fwrite</function> са атомични (освен в случаите,
-    когато размера на <parameter>string</parameter> надвишава
-    размера на блока на файловата система (при някои платформи);
-    важи само за локални файлове). Това означава, че няма нужда да
+    При операционни системи, които правят разлика между двоични и
+    текстови файлове (като Windows), файлът трябва да е отворен
+    с флаг "b" при извикването на <function>fopen</function>.
+   </para>
+  </note>
+  <note>
+   <para>
+    Ако сте отворили файла сочен от <parameter>handle</parameter> с <function>fopen</function> в
+    режим на добавяне, записванията на <function>fwrite</function> са атомични (освен в случаите,
+    когато размера на <parameter>string</parameter> надвишава размера на блока на файловата система (при някои
+    платформи); важи само за локални файлове). Това означава, че няма нужда да
     използвате <function>flock</function> за да заключите ресурс преди
-    да извикате <function>fwrite</function> - данните ще бъдат записани без прекъсване.
+    да извикате <function>fwrite</function> - данните ще бъдат записани без
+    прекъсване.
    </para>
   </note>
   <note>
    <para>
     Ако запишете два пъти във указател към файл, вторите данни ще бъдат добавени
     към края на файла, т.е. следващия пример няма да работи както е очаквано:
-
-        <programlisting role="php">
+    <programlisting role="php">
 <![CDATA[
 <?php
 $fp = fopen('data.txt', 'w');
@@ -106,11 +128,11 @@
 // Съдържанието на 'data.txt' сега е 123, а не 23!
 ?>
 ]]>
-        </programlisting>
+    </programlisting>
    </para>
   </note>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -126,7 +148,8 @@
 if (is_writable($filename)) {

     // В нашия пример отваряме $filename в режим за добавяне.
-    // Файловия указател е в края на файла и, т.е. там ще отидат данните записани с fwrite()
+    // Файловия указател е в края на файла и, т.е.
+    // там ще отидат данните записани с fwrite()
     if (!$handle = fopen($filename, 'a')) {
          echo "Не мога да отворя ($filename)";
          exit;
@@ -151,7 +174,7 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -164,7 +187,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/bg/trunk/reference/session/functions/session-cache-limiter.xml
===================================================================
--- phpdoc/bg/trunk/reference/session/functions/session-cache-limiter.xml	2016-05-04 15:40:58 UTC (rev 339132)
+++ phpdoc/bg/trunk/reference/session/functions/session-cache-limiter.xml	2016-05-04 22:33:33 UTC (rev 339133)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: pemitev Status: ready -->
+<!-- EN-Revision: 334605 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: pemitev -->
 <refentry xml:id="function.session-cache-limiter" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>session_cache_limiter</refname>
@@ -18,24 +19,25 @@
    кешов ограничител.
   </para>
   <para>
-   Кешовият ограничител определя кои HTTP хедъри за управление на кеша да бъдат
-   изпратени към клиента.
-   Тези хедъри определят правилата, по които съдържанието на страницата, може да бъде
-   кеширано от клиента или от междинни proxy сървъри. Установяването на
-   ограничителя на кеша в <literal>nocache</literal> не позволява кеширане от
-   клиента или от proxy сървъри.
+   Кешовият ограничител определя кои HTTP заглавки за управление на кеша да бъдат изпратени към
+   клиента. Тези заглавки определят правилата, по които съдържанието на страницата,
+   може да бъде кеширано от клиента или от междинни proxy сървъри. Установяването на ограничителя на
+   кеша в <literal>nocache</literal> не позволява кеширане от клиента или от proxy сървъри.
    Стойността <literal>public</literal> позволява кеширането от proxy сървъри и клиента,
    докато <literal>private</literal> не позволява кеширането от proxy сървъри
    и разрешава на клиента да кешира съдържанието.
   </para>
   <para>
-   В режим <literal>private</literal>, хедърът Expire изпратен към клиента,
-   може да предизвика объркване в някои браузъри, включително Mozilla.
-   Можете да предотвратите този проблем, като използвате режим
-   <literal>private_no_expire</literal>. В този режим, хедърът Expire, не
-   се изпраща към клиента.
+   В режим <literal>private</literal>, заглавката Expire изпратен към клиента,
+   може да предизвика объркване в някои браузъри, включително <productname>Mozilla</productname>.
+   Можете да предотвратите този проблем, като използвате режим <literal>private_no_expire</literal>.
+   В този режим, заглавката <literal>Expire</literal>, не се изпраща към клиента.
   </para>
   <para>
+   Установяване на кешовия ограничител в <literal>''</literal> ще изключи непълно автоматичното
+   изпращане на заглавките за кеша.
+  </para>
+  <para>
    Ограничителят на кеша е установен в стойността по подразбиране, която се
    съхранява <link linkend="ini.session.cache-limiter">session.cache_limiter</link>
    в началото на подаване на заявката. По този начин, трябва да се извика
@@ -43,7 +45,7 @@
    заявка (и преди да извикана функцията <function>session_start</function>).
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -55,43 +57,79 @@
        Ако параметърът <parameter>cache_limiter</parameter> е установен, името
        на текущия кешов ограничител се заменя с новата стойност.
       </para>
+      <table>
+       <title>Възможни стойности</title>
+       <tgroup cols="2">
+        <thead>
+         <row>
+          <entry>Стойност</entry>
+          <entry>Заглавка</entry>
+         </row>
+        </thead>
+        <tbody>
+         <row>
+          <entry><literal>public</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Expires: (време в бъдещето съгласно session.cache_expire)
+Cache-Control: public, max-age=(време в бъдещето съгласно session.cache_expire)
+Last-Modified: (датата и времето през което сесията е записана за последен път)
+]]>
+           </programlisting>
+          </entry>
+         </row>
+         <row>
+          <entry><literal>private_no_expire</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Cache-Control: private, max-age=(session.cache_expire в бъдещето), pre-check=(session.cache_expire в бъдещето)
+Last-Modified: (датата и времето през което сесията е записана за последен път)
+]]>
+           </programlisting>
+          </entry>
+         </row>
+         <row>
+          <entry><literal>private</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Expires: Thu, 19 Nov 1981 08:52:00 GMT
+Cache-Control: private, max-age=(session.cache_expire в бъдещето), pre-check=(session.cache_expire в бъдещето)
+Last-Modified: (датата и времето през което сесията е записана за последен път)
+]]>
+           </programlisting>
+          </entry>
+         </row>
+         <row>
+          <entry><literal>nocache</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Expires: Thu, 19 Nov 1981 08:52:00 GMT
+Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
+Pragma: no-cache
+]]>
+           </programlisting>
+          </entry>
+         </row>
+        </tbody>
+       </tgroup>
+      </table>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Връща името на текущия кешов ограничител.
   </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>4.2.0</entry>
-       <entry>
-        Добавен е кешовия ограничител <literal>private_no_expire</literal>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -106,14 +144,14 @@
 session_cache_limiter('private');
 $cache_limiter = session_cache_limiter();

-echo "The cache limiter is now set to $cache_limiter<br />";
+echo "Кешовият ограничител е установен на $cache_limiter<br />";
 ?>
 ]]>
     </programlisting>
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -122,7 +160,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

 <!-- Keep this comment at the end of the file