svn: /phpdoc/bg/trunk/reference/filesystem/functions/ file-put-contents.xml

Modified: phpdoc/bg/trunk/reference/filesystem/functions/file-put-contents.xml
===================================================================
--- phpdoc/bg/trunk/reference/filesystem/functions/file-put-contents.xml	2016-06-19 23:03:19 UTC (rev 339415)
+++ phpdoc/bg/trunk/reference/filesystem/functions/file-put-contents.xml	2016-06-19 23:21:34 UTC (rev 339416)
@@ -1,30 +1,34 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: ogre Status: ready -->
+<!-- EN-Revision: 336832 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: ogre -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file-put-contents">
  <refnamediv>
   <refname>file_put_contents</refname>
   <refpurpose>Записва низ във файл</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>file_put_contents</methodname>
    <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    <methodparam><type>mixed</type><parameter>data</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>
-     Функцията извършва същото, както и последователността <function>fopen</function>,
-     <function>fwrite</function> и <function>fclose</function> (извикани последователно).
+   Функцията извършва същото, като последователността <function>fopen</function>,
+   <function>fwrite</function> и <function>fclose</function>, извикани последователно,
+   за записване на данни във файл.
   </para>
   <para>
-   Ако файлът <parameter>filename</parameter> не съществува ще бъде създаден. Ако съществува ще бъде презаписан, освен ако не е подаден флаг <constant>FILE_APPEND</constant>.
+   Ако файлът <parameter>filename</parameter> не съществува ще бъде създаден.
+   Ако съществува ще бъде презаписан, освен ако не е подаден флаг
+   <constant>FILE_APPEND</constant>.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -41,16 +45,18 @@
      <term><parameter>data</parameter></term>
      <listitem>
       <para>
-      Данните, който ще бъдат записани. Могат да са <type>string</type>,
-      <type>array</type> или <type>stream</type> (както е обяснено по-горе).
+       Данните, който ще бъдат записани. Могат да са <type>string</type>,
+       <type>array</type> или <type>stream</type> (както е обяснено по-горе).
       </para>
       <para>
-      Ако <parameter>data</parameter> е от тип <type>stream</type>, остатъкът
-      в буфера на потока ще бъде записан в посочения файл. Това е подобно на
-      използването на <function>stream_copy_to_stream</function>.
+       Ако <parameter>data</parameter> е от тип <type>stream</type>, остатъкът
+       в буфера на потока ще бъде записан в посочения файл. Това е подобно на
+       използването на <function>stream_copy_to_stream</function>.
       </para>
       <para>
-       Също така, може да използвате параметъра <parameter>data</parameter> като едномерен масив. Това е равнозначно на <literal>file_put_contents($filename, implode('', $array))</literal>.
+       Също така, може да използвате параметъра <parameter>data</parameter> като едномерен
+       масив. Това е равнозначно на
+       <literal>file_put_contents($filename, implode('', $array))</literal>.
       </para>
      </listitem>
     </varlistentry>
@@ -58,7 +64,9 @@
      <term><parameter>flags</parameter></term>
      <listitem>
       <para>
-       Стойността на <parameter>flags</parameter> може да бъде комбинация от следните флагове (с някои ограничения), свързани с двочен ИЛИ оператор (<literal>|</literal>).
+       Стойността на <parameter>flags</parameter> може да бъде комбинация от
+       следните флагове (с някои ограничения), свързани с двоичен ИЛИ
+       оператор (<literal>|</literal>).
       </para>
       <para>
        <table>
@@ -76,7 +84,9 @@
             <constant>FILE_USE_INCLUDE_PATH</constant>
            </entry>
            <entry>
-            Търси файла <parameter>filename</parameter> и в пътищата за включване. Вижте <link linkend="ini.include-path">include_path</link> за повече информация.
+            Търси файла <parameter>filename</parameter> и в пътищата за включване.
+            Вижте <link linkend="ini.include-path">include_path</link> за повече
+            информация.
            </entry>
           </row>
           <row>
@@ -84,7 +94,8 @@
             <constant>FILE_APPEND</constant>
            </entry>
            <entry>
-            Ако файлът <parameter>filename</parameter> съшествува, данните ще бъдат добавени към него вместо да бъдат презаписани отгоре.
+            Ако файлът <parameter>filename</parameter> съществува,
+            данните ще бъдат добавени към него вместо да бъдат презаписани отгоре.
            </entry>
           </row>
           <row>
@@ -92,25 +103,13 @@
             <constant>LOCK_EX</constant>
            </entry>
            <entry>
-            Придобива изключително заключване върху файла докато се записва в него.
+            Придобива изключително заключване върху файла докато се записва
+            в него. С други думи, <function>flock</function> се извиква
+            между извикването на <function>fopen</function> и на
+            <function>fwrite</function>. Това не е идентично на
+            извикване на функция <function>fopen</function> в режим "x".
            </entry>
           </row>
-          <row>
-           <entry>
-            <constant>FILE_TEXT</constant>
-           </entry>
-           <entry>
-            Данните от <parameter>data</parameter> се записват в текстов режим. Ако се използва unicode семантика, кодирането по подразбиране ще е UTF-8. Можете да използвате различно кодиране чрез създаването на context или чрез използването на <function>stream_default_encoding</function>, за да промените подразбиращото се кодиране. Този флаг не може да бъде използван едновременно с <constant>FILE_BINARY</constant>. Този флаг е наличен от PHP6.
-           </entry>
-          </row>
-          <row>
-           <entry>
-            <constant>FILE_BINARY</constant>
-           </entry>
-           <entry>
-            Данните от <parameter>data</parameter> се записват в двоичен режим. Това е режимът използван по подразбиране. Не може да бъде използван едновременно с <constant>FILE_TEXT</constant>. Този флаг е наличен от PHP6.
-           </entry>
-          </row>
          </tbody>
         </tgroup>
        </table>
@@ -121,21 +120,62 @@
      <term><parameter>context</parameter></term>
      <listitem>
       <para>
-       Валиден ресурс, създаден с <function>stream_context_create</function>.
+       Валиден ресурс, създаден с
+       <function>stream_context_create</function>.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-  Функцията връща броя байтове, които са били записани във файла или &false; при неуспех.
+   Функцията връща броя байтове, които са били записани във файла или
+   &false; при неуспех.
   </para>
+  &return.falseproblem;
  </refsect1>
-
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Пример за базова употреба</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$file = 'people.txt';
+// Отваря файла за да вземе съществуващото съдържание
+$current = file_get_contents($file);
+// Добавя личност към файла
+$current .= "John Smith\n";
+// Записва съдържанието обратно във файла
+file_put_contents($file, $current);
+?>
+]]>
+    </programlisting>
+   </example>
+   <example>
+    <title>Употреба на флагове</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$file = 'people.txt';
+// Новата личност, което ще бъде добавена към файла
+$person = "John Smith\n";
+// Записва информацията във файла,
+// посредством флаг FILE_APPEND за да се добави към края на файла
+// и флаг LOCK_EX за да не може друг да записва във файла по същото време
+file_put_contents($file, $person, FILE_APPEND | LOCK_EX);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -149,36 +189,24 @@
      </thead>
      <tbody>
       <row>
-       <entry>5.0.0</entry>
-       <entry>
-        Добавена е поддръжка за context.
-       </entry>
-      </row>
-      <row>
        <entry>5.1.0</entry>
        <entry>
-        Добавена е поддръжка за <constant>LOCK_EX</constant>и взможността да се
+        Добавена е поддръжка за <constant>LOCK_EX</constant> и възможността да се
         подаде поток на параметър <parameter>data</parameter>.
        </entry>
       </row>
-      <row>
-       <entry>6.0.0</entry>
-       <entry>
-        Добавена е поддръжка за флаговете <constant>FILE_TEXT</constant> и <constant>FILE_BINARY</constant>
-       </entry>
-      </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.bin-safe;
   &tip.fopen-wrapper;
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -190,7 +218,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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