svn: /phpdoc/bg/trunk/reference/mysql/functions/ mysql-connect.xml mysql-query.xml mysql-select-db.xml

[email protected] (Stanislav Yordanov) Sat, 02 Apr 2016 11:13:45 +0000
Newsgroups php.doc.bg
Message-ID <[email protected]>
stanprog                                 Sat, 02 Apr 2016 11:13:45 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=338885

Log:
sync to EN

Changed paths:
    U   phpdoc/bg/trunk/reference/mysql/functions/mysql-connect.xml
    U   phpdoc/bg/trunk/reference/mysql/functions/mysql-query.xml
    U   phpdoc/bg/trunk/reference/mysql/functions/mysql-select-db.xml
svn-diffs-338885.txt (text/x-diff, 8.7 KB)
Modified: phpdoc/bg/trunk/reference/mysql/functions/mysql-connect.xml
===================================================================
--- phpdoc/bg/trunk/reference/mysql/functions/mysql-connect.xml	2016-04-02 10:41:05 UTC (rev 338884)
+++ phpdoc/bg/trunk/reference/mysql/functions/mysql-connect.xml	2016-04-02 11:13:45 UTC (rev 338885)
@@ -1,12 +1,22 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 334605 Maintainer: stanprog Status: ready -->
 <refentry xml:id="function.mysql-connect" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysql_connect</refname>
   <refpurpose>Установява връзка с MySQL сървър</refpurpose>
  </refnamediv>

+ <refsynopsisdiv>
+  <warning>
+   &mysql.alternative.note;
+   <simplelist role="alternatives">
+    <member><function>mysqli_connect</function></member>
+    <member><methodname>PDO::__construct</methodname></member>
+   </simplelist>
+  </warning>
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -105,8 +115,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   При успех връща идентификатора на връзката с MySQL сървъра.
-   При неуспех връща &false;.
+   Връща идентификатора на връзката с MySQL сървъра при успех&return.falseforfailure;.
   </para>
  </refsect1>

@@ -123,17 +132,12 @@
      </thead>
      <tbody>
       <row>
-       <entry>4.3.0</entry>
+       <entry>5.5.0</entry>
        <entry>
-        Добавен е параметърът <parameter>client_flags</parameter>.
+        Функцията генерира грешка от ниво
+        <constant>E_DEPRECATED</constant>.
        </entry>
       </row>
-      <row>
-       <entry>4.2.0</entry>
-       <entry>
-        Добавен е параметърът <parameter>new_link</parameter>.
-       </entry>
-      </row>
      </tbody>
     </tgroup>
    </informaltable>
@@ -189,11 +193,11 @@
    <example>
     <title>Пример за <function>mysql_connect</function> с използване на формата  ":/path/to/socket"</title>
     <programlisting role="php">
-     <![CDATA[
+<![CDATA[
 <?php
 // установяваме връзка с localhost и сокет /tmp/mysql.sock

-//вариант 1: пропускаме localhost
+// вариант 1: пропускаме localhost
 $link = mysql_connect(':/tmp/mysql', 'mysql_user', 'mysql_password');
 if (!$link) {
     die('Връзката не може да бъде установена: ' . mysql_error());
@@ -233,7 +237,7 @@
   </note>
   <note>
    <para>
-    Връзкта към сървъра ще бъде прекъсната в момента в който спре
+    Връзката към сървъра ще бъде прекъсната в момента в който спре
     изпълнението на скрипта, освен ако не е прекъсната по-рано, чрез
     функция <function>mysql_close</function>.
    </para>
@@ -251,7 +255,7 @@
     конфигурационната директива <link linkend="ini.variables-order">variables_order</link>
     не съдържа знака <literal>E</literal>. При Windows, ако oбкръжението не
     е копирано, променливата от обкръжението
-    <literal>SYSTEMROOT</literal> няма да бъде достъпна и ще възникат проблеми
+    <literal>SYSTEMROOT</literal> няма да бъде достъпна и ще възникнат проблеми
     при зареждането на Winsock от страна на PHP.
    </para>
   </note>

Modified: phpdoc/bg/trunk/reference/mysql/functions/mysql-query.xml
===================================================================
--- phpdoc/bg/trunk/reference/mysql/functions/mysql-query.xml	2016-04-02 10:41:05 UTC (rev 338884)
+++ phpdoc/bg/trunk/reference/mysql/functions/mysql-query.xml	2016-04-02 11:13:45 UTC (rev 338885)
@@ -1,18 +1,28 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 283826 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 332891 Maintainer: stanprog Status: ready -->
 <refentry xml:id="function.mysql-query" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysql_query</refname>
   <refpurpose>Изпраща заявка към MySQL</refpurpose>
  </refnamediv>

+ <refsynopsisdiv>
+  <warning>
+   &mysql.alternative.note;
+   <simplelist role="alternatives">
+    <member><function>mysqli_query</function></member>
+    <member><methodname>PDO::query</methodname></member>
+   </simplelist>
+  </warning>
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>resource</type><methodname>mysql_query</methodname>
+   <type>mixed</type><methodname>mysql_query</methodname>
    <methodparam><type>string</type><parameter>query</parameter></methodparam>
-   <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+   <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>mysql_query</function> изпраща единична заявка (множество заявки не се
@@ -33,6 +43,8 @@
       </para>
       <para>
        Низът на заявката не трябва да завършва с точка и запетая.
+       Данните в една SQL заявка трябва да бъдат <link
+       linkend="function.mysql-real-escape-string">екранирани</link>.
       </para>
      </listitem>
     </varlistentry>
@@ -113,7 +125,8 @@
 // Формулиране на заявката
 // Това е най-добрият начин да се изпълни SQL заявка
 // За повече примери вижте mysql_real_escape_string()
-$query = sprintf("SELECT firstname, lastname, address, age FROM friends WHERE firstname='%s' AND lastname='%s'",
+$query = sprintf("SELECT firstname, lastname, address, age FROM friends
+    WHERE firstname='%s' AND lastname='%s'",
     mysql_real_escape_string($firstname),
     mysql_real_escape_string($lastname));


Modified: phpdoc/bg/trunk/reference/mysql/functions/mysql-select-db.xml
===================================================================
--- phpdoc/bg/trunk/reference/mysql/functions/mysql-select-db.xml	2016-04-02 10:41:05 UTC (rev 338884)
+++ phpdoc/bg/trunk/reference/mysql/functions/mysql-select-db.xml	2016-04-02 11:13:45 UTC (rev 338885)
@@ -1,18 +1,28 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 328734 Maintainer: stanprog Status: ready -->
 <refentry xml:id="function.mysql-select-db" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysql_select_db</refname>
   <refpurpose>Избира MySQL база от данни</refpurpose>
  </refnamediv>
-
+
+ <refsynopsisdiv>
+  <warning>
+   &mysql.alternative.note;
+   <simplelist role="alternatives">
+    <member><function>mysqli_select_db</function></member>
+    <member><methodname>PDO::__construct</methodname> (part of dsn)</member>
+   </simplelist>
+  </warning>
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>mysql_select_db</methodname>
    <methodparam><type>string</type><parameter>database_name</parameter></methodparam>
-   <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+   <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
   </methodsynopsis>
   <para>
    Избира указана база от данни като текущо активна за дадена връзка, указана
@@ -21,7 +31,7 @@
    текущо активната база от данни.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -38,14 +48,14 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    &return.success;
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -71,7 +81,7 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
@@ -81,7 +91,7 @@
    </para>
   </note>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>