php/archived-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

mysql : fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-19 03:23:08 +00:00
parent 4778a13705
commit 11cc528e25
54 changed files with 571 additions and 571 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
reference/mysql/book.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.mysql">
<?phpdoc extension-membership="pecl"?>
<title>Оригинальный API-интерфейс доступа к MySQL-серверам</title>
<titleabbrev>Оригинальный MySQL</titleabbrev>
@@ -9,20 +9,20 @@
<!-- {{{ preface -->
<preface xml:id="intro.mysql">
&reftitle.intro;
<para>
<simpara>
Модуль устарел с PHP 5.5.0, а в PHP версии 7.0.0 модуль удалили. Вместо устаревшего модуля
с MySQL-серверами работают через модуль <link linkend="book.mysqli">mysqli</link>
или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Дополнительную информацию о выборе API-интерфейса для взаимодействия с СУБД MySQL
содержит «<link linkend="mysqlinfo.api.choosing">Обзор API-интерфейсов для подключения к MySQL</link>».
</para>
<para>
</simpara>
<simpara>
Функции модуля открывают доступ к серверам баз данных MySQL.
Подробнее о MySQL рассказывет сайт <link xlink:href="&url.mysql;">&url.mysql;</link>.
</para>
<para>
</simpara>
<simpara>
Документация к MySQL доступна по адресу <link xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>.
</para>
</simpara>
</preface>
<!-- }}} -->
@@ -32,7 +32,8 @@
&reference.mysql.examples;
&reference.mysql.reference;
</book><!-- Keep this comment at the end of the file
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t

20
reference/mysql/changelog.xml
View File

@@ -1,22 +1,22 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="changelog.mysql">
<title>&ChangelogListingTitle;</title>
<para>&ChangelogListingDescription;</para>
<simpara>&ChangelogListingDescription;</simpara>
<simplesect>
<title>Общий список изменений для модуля ext/mysql</title>
<para>
<simpara>
Этот список изменений ссылается на модуль ext/mysql.
</para>
</simpara>
</simplesect>
<simplesect xml:id="changelog.mysql.global">
<title>Глобальные изменения в ext/mysql</title>
<para>
<simpara>
Следующий список представляет собой подборку изменений модуля ext/mysql.
</para>
</simpara>
<informaltable xml:id="changelog.mysql.global.table">
<tgroup cols="2">
<thead>
@@ -29,9 +29,9 @@
<row>
<entry>7.0.0</entry>
<entry>
<para>
<simpara>
Этот модуль удалён из PHP. Подробности тут <xref linkend="mysqlinfo.api.choosing"/>.
</para>
</simpara>
</entry>
</row>
</tbody>
@@ -41,10 +41,10 @@
<simplesect xml:id="changelog.mysql.functions">
<title>Изменения в существующих функциях</title>
<para>
<simpara>
Нижеследующий список является компиляцией всех
изменений в функциях ext/mysql.
</para>
</simpara>
<?phpdoc generate-changelog-for="ref.mysql book.mysql"?>
</simplesect>

44
reference/mysql/configure.xml
View File

@@ -1,38 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mysql.installation">
&reftitle.install;
<warning>
&mysql.alternative.note;
</warning>
<para xml:id="mysql.configure">
<simpara xml:id="mysql.configure">
Для компиляции просто используйте опцию конфигурации
<option role="configure">--with-mysql[=DIR]</option>,
где необязательный параметр <literal>[DIR]</literal> указывает на директорию
с установленным MySQL.
</para>
<para>
</simpara>
<simpara>
Несмотря на то, что модуль MySQL совместим с MySQL 4.1.0 и
выше, он не поддерживает дополнительную функциональность, предоставляемую
этими версиями. Для получения такой возможности воспользуйтесь
модулем <link linkend="book.mysqli">MySQLi</link>.
</para>
<para>
</simpara>
<simpara>
Если вы хотите установить модуль mysql совместно с mysqli, то
для избежания каких-либо конфликтов необходимо использовать одну
и ту же клиентскую библиотеку.
</para>
</simpara>
<section xml:id="mysql.installation.linux">
<title>Установка на Linux-системы</title>
<para>
<simpara>
Примечание: <literal>[DIR]</literal> является путём к файлам клиентской библиотеки
MySQL (<emphasis>заголовкам и библиотекам</emphasis>), которые можно скачать с
<link xlink:href="&url.mysql;">MySQL</link>.
</para>
</simpara>
<table xml:id="mysql.installation.compile.support">
<title>Таблица компиляции ext/mysql по версиям PHP</title>
<tgroup cols="5">
@@ -86,7 +86,7 @@
<title>Установка на Windows-системы</title>
<section xml:id="mysql.installation.windows.php52">
<title>PHP 5.0.x, 5.1.x, 5.2.x</title>
<para>
<simpara>
Поддержка MySQL больше не включена по умолчанию, поэтому для её
включения необходимо подключить <filename>php_mysql.dll</filename> DLL
внутри &php.ini;. Кроме этого, PHP понадобится доступ к клиентской библиотеке
@@ -98,8 +98,8 @@
Хотя копирование <filename>libmysql.dll</filename> в системную папку Windows
также сработает (потому что системная папка находится по умолчанию в
<envar>PATH</envar>), это не рекомендуется.
</para>
<para>
</simpara>
<simpara>
Как и при включении любого другого модуля PHP (в том числе и
<filename>php_mysql.dll</filename>), директива
<link linkend="ini.extension-dir">extension_dir</link> должна указывать на
@@ -107,43 +107,43 @@
<link linkend="install.windows.manual">Инструкции по ручной установке в Windows
</link>. Пример значения extension_dir для PHP 5:
<literal>c:\php\ext</literal>
</para>
</simpara>
<note>
<para>
<simpara>
Если при старте веб-сервера происходит подобная ошибка:
<literal>"Unable to load dynamic library './php_mysql.dll'"</literal>,
("Невозможно подгрузить динамическую библиотеку './php_mysql.dll'"),
то это случается из-за того, что на вашей системе не может быть найдена
<filename>php_mysql.dll</filename> и/или <filename>libmysql.dll</filename>.
</para>
</simpara>
</note>
</section>
<section xml:id="mysql.installation.windows.php53">
<title>PHP 5.3.0+</title>
<para>
<simpara>
<link linkend="mysqlnd.overview">MySQL Native Driver</link> включён
по умолчанию. В том числе <filename>php_mysql.dll</filename>, но без требования
и использования <filename>libmysql.dll</filename>.
</para>
</simpara>
</section>
</section>
<section xml:id="mysql.installation.notes">
<title>Замечания по установке MySQL</title>
<warning>
<para>
<simpara>
Сбои в работе PHP могут возникнуть при загрузке
этого модуля вместе с модулем recode.
За дополнительной информацией обращайтесь к разделу о модуле для
<link linkend="ref.recode">recode</link>.
</para>
</simpara>
</warning>
<note>
<para>
<simpara>
Если вам требуется поддержка кодировок отличных от <emphasis>latin</emphasis>,
(установленной по умолчанию), вам придётся установить внешнюю библиотеку
libmysqlclient, скомпилированную с их поддержкой.
</para>
</simpara>
</note>
</section>
</section>

38
reference/mysql/functions/mysql-affected-rows.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-affected-rows">
<refnamediv>
@@ -23,11 +23,11 @@
<type>int</type><methodname>mysql_affected_rows</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает количество рядов, затронутых последним INSERT, UPDATE,
REPLACE или DELETE запросом, связанным с дескриптором
<parameter>link_identifier</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,29 +39,29 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает количество изменённых записей в случае успешного выполнения, и -1
в случае если последний запрос не удался.
</para>
<para>
</simpara>
<simpara>
Если последний запрос был DELETE без указания WHERE и, соответственно,
таблица была очищена, функция вернёт ноль во всех версиях MySQL
до 4.1.2.
</para>
<para>
</simpara>
<simpara>
При использовании UPDATE, MySQL не обновит колонки, уже содержащие новое
значение. Вследствие этого, функция <function>mysql_affected_rows</function>
не всегда возвращает количество рядов, подошедших под условия, только
количество рядов, обновлённых запросом.
</para>
<para>
</simpara>
<simpara>
Запрос REPLACE сначала удаляет запись с указанным первичным ключом,
а потом вставляет новую. Данная функция возвращает количество
удалённых записей вместе с количеством вставленных.
</para>
<para>
</simpara>
<simpara>
В случае использования запросов типа "INSERT ... ON DUPLICATE KEY UPDATE", возвращаемое значение будет равно <literal>1</literal> в случае, если была произведена вставка, или <literal>2</literal> при обновлении существующего ряда.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -126,27 +126,27 @@ mysql_query("COMMIT");
&reftitle.notes;
<note>
<title>Транзакции</title>
<para>
<simpara>
При использовании транзакций
<function>mysql_affected_rows</function> нужно вызывать
после запросов INSERT, UPDATE, DELETE, но не после
COMMIT.
</para>
</simpara>
</note>
<note>
<title>Запросы SELECT</title>
<para>
<simpara>
Чтобы получить количество рядов, возвращённых SELECT-запросом,
используйте функцию <function>mysql_num_rows</function>.
</para>
</simpara>
</note>
<note>
<title>Каскадные внешние ключи</title>
<para>
<simpara>
<function>mysql_affected_rows</function> не подсчитывает ряды,
неявно изменённые ограничениями ON DELETE CASCADE и/или
ON UPDATE CASCADE.
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-client-encoding.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-client-encoding">
<refnamediv>
@@ -22,9 +22,9 @@
<type>string</type><methodname>mysql_client_encoding</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает значение переменной MySQL <literal>character_set</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,10 +36,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает используемую по умолчанию кодировку для данного
соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

14
reference/mysql/functions/mysql-close.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-close">
<refnamediv>
@@ -23,12 +23,12 @@
<type>bool</type><methodname>mysql_close</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_close</function> закрывает непостоянное соединение с
базой данных MySQL, на которое указывает переданный дескриптор.
Если параметр <parameter>link_identifier</parameter> не указан,
закрывается последнее открытое (текущее) соединение.
</para>
</simpara>
&mysql.close.connections.result.sets;
</refsect1>
@@ -41,9 +41,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -74,11 +74,11 @@ mysql_close($link);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_close</function> не закрывает постоянные
соединения, созданные функцией <function>mysql_pconnect</function>.
Для дополнительной информации смотрите руководство по <link linkend="features.persistent-connections">постоянным соединениям</link>.
</para>
</simpara>
</note>
</refsect1>

46
reference/mysql/functions/mysql-connect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-connect">
<refnamediv>
@@ -27,10 +27,10 @@
<methodparam choice="opt"><type>bool</type><parameter>new_link</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Открывает новое соединение с сервером MySQL или использует
уже существующее.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,46 +39,46 @@
<varlistentry>
<term><parameter>server</parameter></term>
<listitem>
<para>
<simpara>
Сервер MySQL. Может также включать номер порта, например,
"hostname:port" или путь к локальному сокету, например,
":/path/to/socket" для локального сервера.
</para>
<para>
</simpara>
<simpara>
Если PHP-директива <link linkend="ini.mysql.default-host">
mysql.default_host</link> не определена (по умолчанию), то
значением по умолчанию является 'localhost:3306'.
В &sqlsafemode; этот параметр игнорируется и всегда используется
значение 'localhost:3306'.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
Имя пользователя. Значение по умолчанию определяется
директивой <link linkend="ini.mysql.default-user">mysql.default_user</link>.
В &sqlsafemode; этот параметр будет проигнорирован и будет
использован пользователь, владеющий процессом сервера.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
Пароль. Значение по умолчанию определяется директивой
<link linkend="ini.mysql.default-password">mysql.default_password</link>.
В &sqlsafemode; этот параметр будет проигнорирован и в качестве
пароля будет использована пустая строка.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>new_link</parameter></term>
<listitem>
<para>
<simpara>
Если второй вызов функции <function>mysql_connect</function>
произошёл с теми же аргументами, то новое соединение не будет
установлено. Вместо этого функция вернёт ссылку
@@ -88,13 +88,13 @@
соединение, даже если соединение с аналогичными параметрами
уже открыто.
В &sqlsafemode; этот параметр игнорируется.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>client_flags</parameter></term>
<listitem>
<para>
<simpara>
Параметр <parameter>client_flags</parameter> должен быть комбинацией из
следующих констант:
128 (включает обработку <literal>LOAD DATA LOCAL</literal>),
@@ -104,7 +104,7 @@
<constant>MYSQL_CLIENT_INTERACTIVE</constant>.
Подробнее читайте в разделе <xref linkend="mysql.client-flags"/>.
В &sqlsafemode; этот параметр игнорируется.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -112,10 +112,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает дескриптор соединения с MySQL в случае успешного
выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -191,7 +191,7 @@ mysql_close($link);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
При указании параметру <parameter>server</parameter> значения
&quot;localhost&quot; или &quot;localhost:port&quot; клиентская
библиотека MySQL будет пытаться соединиться с локальным сокетом.
@@ -201,17 +201,17 @@ mysql_close($link);
локальному сокету, правильный путь должен быть установлен через указание директивы &php.ini;
<link linkend="ini.mysql.default-host">mysql.default_host</link> в &php.ini;,
после чего можно оставлять параметр <parameter>server</parameter> пустым.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Соединение с сервером будет закрыто при завершении исполнения
скрипта, если только до этого оно не было закрыто с помощью
функции <function>mysql_close</function>.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Ошибка "Can't create TCP/IP socket (10106)"
(Невозможно создать сокет TCP/IP) обычно означает, что
конфигурационная директива <link linkend="ini.variables-order">variables_order</link>
@@ -219,7 +219,7 @@ mysql_close($link);
не будет скопирована переменная окружения
<literal>SYSTEMROOT</literal>, то PHP будет испытывать проблемы
при загрузке Winsock.
</para>
</simpara>
</note>
</refsect1>

26
reference/mysql/functions/mysql-create-db.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-create-db">
<refnamediv>
@@ -24,10 +24,10 @@
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_create_db</function> пытается создать базу данных на
сервере, с которым ассоциирован переданный дескриптор соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,9 +36,9 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
Имя создаваемой базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -47,20 +47,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример создания базы данных MySQL</title>
<para>
<simpara>
Функция <function>mysql_create_db</function> не рекомендуется к
использованию. Предпочтительнее использовать <function>mysql_query</function> с
SQL-запросом создания базы данных <literal>CREATE DATABASE</literal>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -90,16 +90,16 @@ if (mysql_query($sql, $link)) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_createdb</function>
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Данная функция не будет доступна, если модуль MySQL был
скомпилирован клиентской библиотекой MySQL версии 4.x.
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-data-seek.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-data-seek">
<refnamediv>
@@ -24,14 +24,14 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>row_number</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_data_seek</function> перемещает внутренний указатель
результата запроса, с которым связан переданный дескриптор,
к ряду с указанным номером. Следующий вызов к функции получения
данных MySQL, такой как <function>mysql_fetch_assoc</function>,
вернёт именно его.
</para>
<para>
</simpara>
<simpara>
Нумерация <parameter>row_number</parameter> начинается с 0.
<parameter>row_number</parameter> должен быть значением в диапазоне
от 0 до <function>mysql_num_rows</function> - 1. Однако, если
@@ -39,7 +39,7 @@
попытка сдвига указателя к нулевому ряду завершится неудачей - будет вызвана
ошибка уровня <constant>E_WARNING</constant>
и <function>mysql_data_seek</function> вернёт &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -49,9 +49,9 @@
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
Желаемый номер ряда в полученном дескрипторе результата.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -59,9 +59,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -108,11 +108,11 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Функция <function>mysql_data_seek</function> может быть использована
только с <function>mysql_query</function>, но не с
<function>mysql_unbuffered_query</function>.
</para>
</simpara>
</note>
</refsect1>

26
reference/mysql/functions/mysql-db-name.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-db-name">
<refnamediv>
@@ -24,10 +24,10 @@
<methodparam><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>field</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает название базы данных из вызова к
<function>mysql_list_dbs</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,25 +36,25 @@
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
<simpara>
Дескриптор результата, полученный из вызова <function>mysql_list_dbs</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row</parameter></term>
<listitem>
<para>
<simpara>
Индекс в результате.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>field</parameter></term>
<listitem>
<para>
<simpara>
Имя поля.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -62,11 +62,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает название базы данных в случае успешного выполнения, или &false; в
случае ошибки. В случае возврата &false; используйте
<function>mysql_error</function> для определения природы ошибок.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -96,10 +96,10 @@ while ($i < $cnt) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_dbname</function>
</para>
</simpara>
</note>
</refsect1>

26
reference/mysql/functions/mysql-db-query.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-db-query">
<refnamediv>
@@ -25,10 +25,10 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_db_query</function> выбирает базу данных и выполняет
запрос к ней.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,20 +37,20 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
Имя базы данных, на которую произойдёт переключение.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
<simpara>
Запрос MySQL.
</para>
<para>
</simpara>
<simpara>
Данные в запросе должны быть <link linkend="function.mysql-real-escape-string">корректно проэкранированы</link>.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -59,12 +59,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает ресурс результата запроса к MySQL или &false; в случае возникновения ошибки.
Функция также возвращает &true;/&false; для
<literal>INSERT</literal>/<literal>UPDATE</literal>/<literal>DELETE</literal>
запросов для индикации успеха/провала.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -109,7 +109,7 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Учтите, что эта функция <emphasis role="strong">НЕ</emphasis> переключает
соединение обратно к предыдущей базе данных. Другими словами, вы не
можете использовать эту функцию, чтобы <emphasis>временно</emphasis>
@@ -118,7 +118,7 @@ mysql_free_result($result);
<literal>database.table</literal> в SQL-запросах или функцию
<function>mysql_select_db</function>, вместо использования
этой функции.
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-drop-db.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-drop-db">
<refnamediv>
@@ -23,12 +23,12 @@
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_drop_db</function> пытается уничтожить базу данных
на сервере, на который ссылается переданный дескриптор соединения.
Данная функция устарела, используйте вместо неё
<function>mysql_query</function> с запросом <literal>DROP DATABASE</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,9 +37,9 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
Имя удаляемой базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -48,9 +48,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -80,16 +80,16 @@ if (mysql_query($sql, $link)) {
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
<simpara>
Эта функция недоступна, если модуль был скомпилирован
с клиентской библиотекой MySQL версии 4.x.
</para>
</simpara>
</warning>
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_dropdb</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-errno.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-errno">
<refnamediv>
@@ -23,17 +23,17 @@
<type>int</type><methodname>mysql_errno</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает код ошибки последней функции работы с MySQL.
</para>
<para>
</simpara>
<simpara>
Ошибки работы с MySQL больше не вызывают сообщений в PHP. Вместо этого
используйте функцию <function>mysql_errno</function>, чтобы получить код
ошибки. Учтите, что функция возвращает код ошибки только последней
выполненной функции (исключая <function>mysql_error</function> и
<function>mysql_errno</function>). Проверяйте результат работы функции до
вызова следующей.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -45,10 +45,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает код ошибки последней функции работы с MySQL,
или <literal>0</literal> (ноль), если операция выполнена успешно.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-error.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-error">
<refnamediv>
@@ -23,7 +23,7 @@
<type>string</type><methodname>mysql_error</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает текст ошибки выполнения последней функции MySQL.
Ошибки работы с MySQL больше не вызывают сообщений в PHP. Вместо
этого используйте функцию <function>mysql_error</function>, для
@@ -32,7 +32,7 @@
<function>mysql_error</function> и <function>mysql_errno</function>),
поэтому убедитесь, что вы вызываете данную функцию до вызова
следующей функции MySQL.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -44,11 +44,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает текст ошибки выполнения последней функции MySQL,
или <literal>''</literal> (пустую строку), если операция
выполнена успешно.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/mysql/functions/mysql-escape-string.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-escape-string">
<refnamediv>
@@ -23,19 +23,19 @@
<type>string</type><methodname>mysql_escape_string</methodname>
<methodparam><type>string</type><parameter>unescaped_string</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция экранирует <parameter>unescaped_string</parameter> таким
образом, после чего её можно безопасно использовать в <function>mysql_query</function>.
Данная функция устарела.
</para>
<para>
</simpara>
<simpara>
Функция идентична <function>mysql_real_escape_string</function>, исключая тот
факт, что <function>mysql_real_escape_string</function> принимает
параметром ещё и идентификатор соединения и экранирует строку
с учётом текущей кодировки. <function>mysql_escape_string</function>
не делает этого и результат работы не зависит от кодировки,
в который вы работаете с БД.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -44,9 +44,9 @@
<varlistentry>
<term><parameter>unescaped_string</parameter></term>
<listitem>
<para>
<simpara>
Экранируемая строка.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,9 +54,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает экранируемую строку.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -84,10 +84,10 @@ Escaped string: Zak\'s Laptop
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_escape_string</function> не экранирует символы
<literal>%</literal> и <literal>_</literal>.
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-fetch-array.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-array">
<refnamediv>
@@ -24,10 +24,10 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>result_type</parameter><initializer>MYSQL_BOTH</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает массив, соответствующий обработанному ряду результата
запроса и сдвигает внутренний указатель данных вперёд.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,12 +37,12 @@
<varlistentry>
<term><parameter>result_type</parameter></term>
<listitem>
<para>
<simpara>
Тип возвращаемого массива. Является константой и может принимать
следующие значения: <constant>MYSQL_ASSOC</constant>,
<constant>MYSQL_NUM</constant> и
<constant>MYSQL_BOTH</constant>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -50,7 +50,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает массив строк, соответствующих обработанному ряду результата
запроса, или &false;, если рядов больше нет. Тип возвращаемого
массива зависит от значения параметра <parameter>result_type</parameter>.
@@ -61,15 +61,15 @@
<function>mysql_fetch_assoc</function>), а
<constant>MYSQL_NUM</constant> - только численные (аналогично
функции <function>mysql_fetch_row</function>).
</para>
<para>
</simpara>
<simpara>
Если несколько колонок в результате будут иметь одинаковые
названия, то будет возвращена последняя колонка. Чтобы получить
доступ к другим колонкам с тем же именем, используйте численные
индексы массива или псевдонимы в запросе. В случае псевдонимов
используйте именно их - вы не сможете использовать настоящие
имена колонок.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -148,12 +148,12 @@ mysql_free_result($result);
&reftitle.notes;
<note>
<title>Производительность</title>
<para>
<simpara>
Важно заметить, что <function>mysql_fetch_array</function>
работает <emphasis>незначительно</emphasis> медленнее,
чем <function>mysql_fetch_row</function>, в то же время
предоставляя намного более удобный доступ к данным.
</para>
</simpara>
</note>
&database.field-case;
&database.fetch-null;

18
reference/mysql/functions/mysql-fetch-assoc.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-assoc">
<refnamediv>
@@ -26,13 +26,13 @@
<type>array</type><methodname>mysql_fetch_assoc</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает ассоциативный массив, соответствующий полученному ряду и сдвигает вперёд
внутренний указатель результата.
Функция <function>mysql_fetch_assoc</function> аналогична вызову функции
<function>mysql_fetch_array</function> со вторым необязательным параметром, равным
MYSQL_ASSOC. Функция возвращает только ассоциативный массив.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -44,11 +44,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает ассоциативный массив строк, соответствующий полученному ряду, либо
&false; если рядов больше нет.
</para>
<para>
</simpara>
<simpara>
Если два или более столбцов результата имеют одинаковые имена,
приоритет будет иметь последний столбец. Для доступа к другому
одноимённому столбцу (или столбцам), вам необходимо либо обратиться
@@ -56,7 +56,7 @@
<function>mysql_fetch_row</function> либо добавить псевдонимы к нужным столбцам.
Для более подробной информации о псевдонимах
смотрите описание примера <function>mysql_fetch_array</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -117,12 +117,12 @@ mysql_free_result($result);
&reftitle.notes;
<note>
<title>Производительность</title>
<para>
<simpara>
Важно отметить, что
<function>mysql_fetch_assoc</function> лишь <emphasis>незначительно</emphasis>
медленнее, чем <function>mysql_fetch_row</function>, но в то же время предоставляет
важную дополнительную информацию.
</para>
</simpara>
</note>
&database.field-case;
&database.fetch-null;

18
reference/mysql/functions/mysql-fetch-field.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-field">
<refnamediv>
@@ -24,11 +24,11 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>field_offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает объект, содержащий информацию о колонке. Эту функцию
можно использовать для получения информации о полях в переданном
результате запроса.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,12 +38,12 @@
<varlistentry>
<term><parameter>field_offset</parameter></term>
<listitem>
<para>
<simpara>
Числовое смещение поля. Если смещение не указано,
функция возвращает информацию о первой колонке, которая
ещё не была обработана этой функцией.
Нумерация <parameter>field_offset</parameter> начинается с <literal>0</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -51,10 +51,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает <type>object</type>, содержащий информацию о колонке.
Объект содержит следующие свойства:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -171,11 +171,11 @@ mysql_free_result($result);
&reftitle.notes;
&database.field-case;
<note>
<para>
<simpara>
Если поля или таблицы имеют дополнительные имена в запросе SQL,
то будет возвращены эти дополнительные имена. Исходное имя может быть получено, например,
с помощью <methodname>mysqli_result::fetch_field</methodname>.
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-fetch-lengths.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-lengths">
<refnamediv>
@@ -23,18 +23,18 @@
<type class="union"><type>array</type><type>false</type></type><methodname>mysql_fetch_lengths</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает массив длин для каждого поля, содержащегося в последнем ряду
результата, полученном из MySQL.
</para>
<para>
</simpara>
<simpara>
<function>mysql_fetch_lengths</function> возвращает длины каждого поля,
содержащегося в последнем ряду, обработанном функциями
<function>mysql_fetch_row</function>,
<function>mysql_fetch_assoc</function>,
<function>mysql_fetch_array</function> и
<function>mysql_fetch_object</function> в массиве, начинающемся с 0.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -46,9 +46,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Массив (<type>array</type>) длин в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/mysql/functions/mysql-fetch-object.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-object">
<refnamediv>
@@ -28,10 +28,10 @@
<methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает объект со свойствами, соответствующими колонкам в обработанном
ряду и сдвигает внутренний указатель результата вперёд.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,20 +41,20 @@
<varlistentry>
<term><parameter>class_name</parameter></term>
<listitem>
<para>
<simpara>
Имя класса. Будет создан экземпляр указанного класса, заполнен
свойствами и возвращён.
Если не указан, возвращается экземпляр <classname>stdClass</classname>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>params</parameter></term>
<listitem>
<para>
<simpara>
Необязательный массив (<type>array</type>) параметров, передаваемых
в конструктор создаваемого экземпляра <parameter>class_name</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -62,11 +62,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает объект (<type>object</type>) со строковыми свойствами,
соответствующими полученному ряду, или &false;, если рядов больше
нет.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -113,20 +113,20 @@ var_dump($obj);
&reftitle.notes;
<note>
<title>Производительность</title>
<para>
<simpara>
В плане скорости эта функция аналогична
<function>mysql_fetch_array</function> и почти также быстра, как
<function>mysql_fetch_row</function> (разница незначительна).
</para>
</simpara>
</note>
<note>
<para>
<simpara>
<function>mysql_fetch_object</function> работает аналогично
<function>mysql_fetch_array</function>, с единственным отличием -
функция возвращает объект вместо массива. Это, кроме всего прочего,
означает, что вы сможете работать с полями только по имени колонок,
а не индексов (числа не могут быть свойствами объекта).
</para>
</simpara>
</note>
&database.field-case;
&database.fetch-null;

14
reference/mysql/functions/mysql-fetch-row.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-row">
<refnamediv>
@@ -26,11 +26,11 @@
<type>array</type><methodname>mysql_fetch_row</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает массив с числовыми индексами, содержащий данные
обработанного ряда, и сдвигает внутренний указатель результата
вперёд.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,16 +42,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает массив строк с числовыми индексами, содержащий данные
обработанного ряда, или &false;, если рядов не осталось.
</para>
<para>
</simpara>
<simpara>
<function>mysql_fetch_row</function> обрабатывает один ряд результата, на
который ссылается переданный указатель. Ряд возвращается в виде массива.
Каждая колонка располагается в следующей ячейке массива, начиная
с нулевого индекса
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/mysql/functions/mysql-field-flags.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-flags">
<refnamediv>
@@ -24,12 +24,12 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_flags</function> возвращает флаги, связанные
с указанным полем. Каждый флаг возвращается как отдельное слово,
отделённое от предыдущего пробелом. Полученное значение можно
разбить в массив, используя функцию <function>explode</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,10 +42,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку с флагами, связанными с результатом&return.falseforfailure;.
</para>
<para>
</simpara>
<simpara>
Возвращаются следующие флаги, если ваша версия MySQL
их уже поддерживает: <literal>"not_null"</literal>,
<literal>"primary_key"</literal>, <literal>"unique_key"</literal>,
@@ -53,7 +53,7 @@
<literal>"unsigned"</literal>, <literal>"zerofill"</literal>,
<literal>"binary"</literal>, <literal>"enum"</literal>,
<literal>"auto_increment"</literal> и <literal>"timestamp"</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -93,10 +93,10 @@ Array
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldflags</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-field-len.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-len">
<refnamediv>
@@ -24,9 +24,9 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_len</function> возвращает длину указанного поля.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Длина указанного поля в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -69,10 +69,10 @@ echo $length;
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldlen</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-field-name.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-name">
<refnamediv>
@@ -24,10 +24,10 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_name</function> возвращает название колонки с
указанным индексом.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Название поля по указанному индексу в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -87,10 +87,10 @@ password
&reftitle.notes;
&database.field-case;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldname</function>
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-field-seek.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-seek">
<refnamediv>
@@ -28,12 +28,12 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Перемещает указатель к полю с указанным смещением. Если следующий
вызов функции <function>mysql_fetch_field</function> не содержит
смещения, то будет возвращено смещение, содержащееся в
<function>mysql_field_seek</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -46,9 +46,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

14
reference/mysql/functions/mysql-field-table.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-table">
<refnamediv>
@@ -24,9 +24,9 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает название таблицы, которой принадлежит указанное поле.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Имя таблицы в случае успешного выполнения.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -74,10 +74,10 @@ for ($i = 0; $i < mysql_num_fields($result); ++$i) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldtable</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-field-type.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-field-type">
<refnamediv>
@@ -24,11 +24,11 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция <function>mysql_field_type</function> аналогична функции
<function>mysql_field_name</function>. Аргументы одинаковы, но вместо
имени колонки возвращается её тип.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,12 +41,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Поля могут быть следующих типов: <literal>"int"</literal>,
<literal>"real"</literal>, <literal>"string"</literal>,
<literal>"blob"</literal> и других, подробно описанных
<link xlink:href="&url.mysql.docs;">документации MySQL</link>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -93,10 +93,10 @@ string type 9 not_null enum
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldtype</function>
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-free-result.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-free-result">
<refnamediv>
@@ -23,18 +23,18 @@
<type>bool</type><methodname>mysql_free_result</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_free_result</function> высвободит всю память, занимаемую
результатом, на который ссылается переданный дескриптор
<parameter>result</parameter>.
</para>
<para>
</simpara>
<simpara>
<function>mysql_free_result</function> нуждается в вызове только в том
случае, если вы всерьёз обеспокоены тем, сколько памяти используют ваши
запросы к БД, возвращающие большое количество данных. Вся память,
используемая для хранения этих данных автоматически очистится в конце
работы скрипта.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -46,16 +46,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
<para>
</simpara>
<simpara>
Если в качестве параметра <parameter>result</parameter> передан
не ресурс, то будет вызвана ошибка уровня E_WARNING. Стоит также
заметить, что <function>mysql_query</function> возвращает
<type>resource</type> только для запросов SELECT, SHOW,
EXPLAIN и DESCRIBE.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -87,10 +87,10 @@ echo $row['email'];
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_freeresult</function>
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-get-client-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-client-info">
<refnamediv>
@@ -26,10 +26,10 @@
<type>string</type><methodname>mysql_get_client_info</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
<function>mysql_get_client_info</function> возвращает строку, содержащую
версию клиентской библиотеки.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Версия клиентской библиотеки MySQL.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-get-host-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-host-info">
<refnamediv>
@@ -26,10 +26,10 @@
<type class="union"><type>string</type><type>false</type></type><methodname>mysql_get_host_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Описывает тип используемого соединения, указанного переданным
дескриптором соединения, включая имя хоста.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,10 +41,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, описывающую тип используемого соединения, указанного переданным
дескриптором соединения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-get-proto-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-proto-info">
<refnamediv>
@@ -22,9 +22,9 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_get_proto_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает информацию о протоколе MySQL.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,9 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает используемый протокол MySQL в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-get-server-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-server-info">
<refnamediv>
@@ -26,9 +26,9 @@
<type class="union"><type>string</type><type>false</type></type><methodname>mysql_get_server_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает версию сервера MySQL.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает версию сервера MySQL в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/mysql/functions/mysql-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-info">
<refnamediv>
@@ -22,9 +22,9 @@
<type>string</type><methodname>mysql_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает подробную информацию о последнем запросе.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,22 +36,22 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает информацию о запросе в случае успешного выполнения, или &false;
в случае возникновения ошибки. Смотрите пример ниже для каких запросов
возвращается информация и как выглядят возвращаемые значения.
Для не перечисленных запросов будет возвращено значение &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Корректные виды запросов MySQL</title>
<para>
<simpara>
Числа расставлены только для примера -- их значения зависят от
результата запроса.
</para>
</simpara>
<programlisting role="mysql">
<![CDATA[
INSERT INTO ... SELECT ...
@@ -72,11 +72,11 @@ String format: Rows matched: 65 Changed: 65 Warnings: 0
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_info</function> возвращает значение не равное &false;
для INSERT ... VALUES только в том случае, если в запросе присутствует
несколько списков значений.
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-insert-id.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-insert-id">
<refnamediv>
@@ -23,10 +23,10 @@
<type>int</type><methodname>mysql_insert_id</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает идентификатор, сгенерированный колонкой с AUTO_INCREMENT
последним запросом (обычно INSERT).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,12 +38,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Идентификатор, сгенерированный колонкой с AUTO_INCREMENT
последним запросом в случае успешного выполнения, <literal>0</literal>, если
последний запрос не генерирует значение AUTO_INCREMENT value, и
&false;, если соединение MySQL не было установлено.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -70,7 +70,7 @@ printf("Идентификатор последней вставленной з
<refsect1 role="notes">
&reftitle.notes;
<caution>
<para>
<simpara>
<function>mysql_insert_id</function> конвертирует возвращаемый функцией
MySQL C API тип значения функции <literal>mysql_insert_id()</literal> в
тип <literal>long</literal> (называемый <type>int</type> в PHP).
@@ -81,21 +81,21 @@ printf("Идентификатор последней вставленной з
максимальных значениях целых чисел смотрите в
<link linkend="language.types.integer">разделе документации,
посвящённом целым числам</link>.
</para>
</simpara>
</caution>
<note>
<para>
<simpara>
Так как <function>mysql_insert_id</function> работает с последним
выполненным запросом, вызывайте <function>mysql_insert_id</function>
сразу же после запроса, генерирующего новое значение.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Значение в SQL функции MySQL
<literal>LAST_INSERT_ID()</literal> всегда содержит последний
сгенерированный ID и не обнуляется между запросами.
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-list-dbs.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-dbs">
<refnamediv>
@@ -22,10 +22,10 @@
<type>resource</type><methodname>mysql_list_dbs</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает указатель на результат, содержащий список баз данных,
доступных на указанном сервере.
</para>
</simpara>
</refsect1>
@@ -38,13 +38,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает <type>resource</type> результата в случае успешного выполнения, или
&false; в случае возникновения ошибки. Используйте функцию
<function>mysql_tablename</function>, чтобы получить
данные из результата, или любую другую функцию, работающую с результатами
запросов, например <function>mysql_fetch_array</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -86,10 +86,10 @@ database3
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_listdbs</function>
</para>
</simpara>
</note>
</refsect1>

30
reference/mysql/functions/mysql-list-fields.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-fields">
<refnamediv>
@@ -24,14 +24,14 @@
<methodparam><type>string</type><parameter>table_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает информацию о таблице с переданным именем.
</para>
<para>
</simpara>
<simpara>
Эта функция устарела. Вместо неё рекомендуется использовать
<function>mysql_query</function> с SQL-запросом
<literal>SHOW COLUMNS FROM table [LIKE 'name']</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,17 +40,17 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
Имя опрашиваемой базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Имя опрашиваемой таблицы.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -59,17 +59,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Дескриптор результата (<type>resource</type>) в случае успешного выполнения,
или &false; в случае возникновения ошибки.
</para>
<para>
</simpara>
<simpara>
Возвращаемый результат может быть обработан с помощью следующих
функций: <function>mysql_field_flags</function>,
<function>mysql_field_len</function>,
<function>mysql_field_name</function>&listendand;
<function>mysql_field_type</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -121,10 +121,10 @@ Array
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_listfields</function>
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-list-processes.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-processes">
<refnamediv>
@@ -22,9 +22,9 @@
<type class="union"><type>resource</type><type>false</type></type><methodname>mysql_list_processes</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает список текущих процессов на сервере MySQL.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,9 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Дескриптор результата (<type>resource</type>) в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/mysql/functions/mysql-list-tables.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-tables">
<refnamediv>
@@ -23,14 +23,14 @@
<methodparam><type>string</type><parameter>database</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция возвращает список имён таблиц базы данных MySQL.
</para>
<para>
</simpara>
<simpara>
Функция устарела. Вместо неё рекомендуют использовать
функцию <function>mysql_query</function> с запросом
<literal>SHOW TABLES [FROM db_name] [LIKE 'pattern']</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
Имя базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -50,16 +50,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
В случае успешного выполнения
функция возвращает дескриптор результата (<type>resource</type>)&return.falseforfailure;.
</para>
<para>
</simpara>
<simpara>
Для работы с результатом запроса
вызывают функцию <function>mysql_tablename</function>
или другую функцию, которая умеет это делать, например
функцию <function>mysql_fetch_array</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -101,10 +101,10 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_listtables</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-num-fields.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-num-fields">
<refnamediv>
@@ -23,9 +23,9 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_num_fields</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает количество полей в результате запроса.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,10 +37,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает количество полей в результате запроса (<type>resource</type>)
в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -67,10 +67,10 @@ echo mysql_num_fields($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_numfields</function>
</para>
</simpara>
</note>
</refsect1>

18
reference/mysql/functions/mysql-num-rows.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-num-rows">
<refnamediv>
@@ -24,13 +24,13 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_num_rows</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает количество рядов результата запроса. Эта команда
работает только с запросами SELECT или SHOW, возвращающих актуальный
результат запроса. Чтобы получить количество рядов,
обработанных функциями INSERT, UPDATE, REPLACE и DELETE,
используйте функцию <function>mysql_affected_rows</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,9 +42,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Количество рядов в результате запроса в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -72,17 +72,17 @@ echo "Получено $num_rows рядов\n";
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
При использовании <function>mysql_unbuffered_query</function> функция
<function>mysql_num_rows</function> не вернёт корректного значения до
тех пор, пока все ряды не будут получены.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_numrows</function>
</para>
</simpara>
</note>
</refsect1>

54
reference/mysql/functions/mysql-pconnect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-pconnect">
<refnamediv>
@@ -36,29 +36,29 @@
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam>
</methodsynopsis>
-->
<para>
<simpara>
Устанавливает постоянное соединение с сервером MySQL.
</para>
</simpara>
<!-- TODO: Integrate this information more nicely with features.persistent -->
<para>
<simpara>
<function>mysql_pconnect</function> работает аналогично
<function>mysql_connect</function> с двумя важными отличиями.
</para>
<para>
</simpara>
<simpara>
Во-первых, при соединении функция пытается найти уже открытый
(постоянный) указатель на тот же сервер с тем же пользователем и паролем.
Если он найден, возвращён функцией будет именно он, вместо открытия
нового соединения.
</para>
<para>
</simpara>
<simpara>
Во-вторых, соединение с SQL-сервером не будет закрыто, когда работа
скрипта закончится. Вместо этого, оно останется рабочим для будущего
использования (<function>mysql_close</function> также не закрывает
постоянные соединения, открытые <function>mysql_pconnect</function>).
</para>
<para>
</simpara>
<simpara>
Соединения такого типа называют 'постоянными'.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -67,39 +67,39 @@
<varlistentry>
<term><parameter>server</parameter></term>
<listitem>
<para>
<simpara>
Сервер MySQL. Может также включать номер порта, например,
"hostname:port" или путь к локальному сокету, например,
":/path/to/socket" для локального хоста.
</para>
<para>
</simpara>
<simpara>
Если директива <link linkend="ini.mysql.default-host">
mysql.default_host</link> не определена (по умолчанию), то
по умолчанию используется значение 'localhost:3306'
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
Имя пользователя. По умолчанию используется имя пользователя,
владеющего серверным процессом.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
Пароль. По умолчанию используется пустая строка.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>client_flags</parameter></term>
<listitem>
<para>
<simpara>
Параметр <parameter>client_flags</parameter> может быть
комбинацией следующих констант:
128 (включает обработку <literal>LOAD DATA LOCAL</literal>),
@@ -107,7 +107,7 @@
<constant>MYSQL_CLIENT_COMPRESS</constant>,
<constant>MYSQL_CLIENT_IGNORE_SPACE</constant> и
<constant>MYSQL_CLIENT_INTERACTIVE</constant>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -115,29 +115,29 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает дескриптор постоянного соединения MySQL в случае успешного выполнения,
и &false; в случае возникновения ошибки.
</para>
</simpara>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Учтите, что соединения такого типа работают только, если
PHP установлен как модуль. За дополнительной информацией
обращайтесь к разделу
"<link linkend="features.persistent-connections">Постоянные соединения с
базами данных</link>".
</para>
</simpara>
</note>
<warning>
<para>
<simpara>
Использование постоянных соединений может потребовать некоторой
настройки Apache и MySQL. Убедитесь, что вы не превысите максимальное
число дозволенных соединений в MySQL.
</para>
</simpara>
</warning>
</refsect1>

14
reference/mysql/functions/mysql-ping.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-ping">
<refnamediv>
@@ -22,16 +22,16 @@
<type>bool</type><methodname>mysql_ping</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Проверяет работает ли соединение с сервером. Если оно
утеряно, автоматически предпринимается попытка пересоединения. Эта
функция может быть использована в скриптах, работающих на протяжении
долгого времени.
</para>
</simpara>
<note>
<para>
<simpara>
Автоматическое восстановление соединения по умолчанию отключено в версиях MySQL &gt;= 5.0.3.
</para>
</simpara>
</note>
</refsect1>
@@ -44,10 +44,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true;, если соединение в рабочем состоянии
и &false; в противном случае.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

42
reference/mysql/functions/mysql-query.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-query">
<refnamediv>
@@ -24,12 +24,12 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_query</function> посылает один запрос
(посылка нескольких запросов не поддерживается) активной базе
данных сервера, на который ссылается переданный дескриптор
<parameter>link_identifier</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,13 +38,13 @@
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
<simpara>
SQL-запрос
</para>
<para>
</simpara>
<simpara>
Запрос не должен заканчиваться точкой с запятой.
Данные в запросе должны быть <link linkend="function.mysql-real-escape-string">корректно проэкранированы</link>.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -53,43 +53,43 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Для запросов SELECT, SHOW, DESCRIBE, EXPLAIN и других запросов,
возвращающих результат из нескольких рядов,
<function>mysql_query</function> возвращает дескриптор результата
запроса (<type>resource</type>), или &false; в случае возникновения ошибки.
</para>
<para>
</simpara>
<simpara>
Для других типов SQL-запросов, INSERT, UPDATE, DELETE, DROP и других,
<function>mysql_query</function> возвращает &true; в случае успешного выполнения
и &false; в случае возникновения ошибки.
</para>
<para>
</simpara>
<simpara>
Полученный дескриптор результата нужно передать в функцию
<function>mysql_fetch_assoc</function> или любую другую функцию,
работающую с результатами запросов.
</para>
<para>
</simpara>
<simpara>
Используйте <function>mysql_num_rows</function> для выяснения
количества рядов в результате SELECT-запроса или
<function>mysql_affected_rows</function> для выяснения количества
обработанных рядов запросами DELETE, INSERT, REPLACE и UPDATE.
</para>
<para>
</simpara>
<simpara>
<function>mysql_query</function> также завершится с ошибкой и
вернёт &false;, если у пользователя нет доступа к какой-либо из
таблиц, фигурирующих в запросе.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Неверный запрос</title>
<para>
<simpara>
Следующий запрос составлен неправильно и
<function>mysql_query</function> вернёт &false;.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -104,10 +104,10 @@ if (!$result) {
</example>
<example>
<title>Верный запрос</title>
<para>
<simpara>
Следующий запрос верен, поэтому <function>mysql_query</function>
вернёт <type>resource</type>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

50
reference/mysql/functions/mysql-real-escape-string.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-real-escape-string">
<refnamediv>
@@ -24,30 +24,30 @@
<methodparam><type>string</type><parameter>unescaped_string</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Экранирует специальные символы в <parameter>unescaped_string</parameter>,
принимая во внимание кодировку соединения, таким образом, что результат
можно безопасно использовать в SQL-запросе в функции <function>mysql_query</function>.
Если вставляются бинарные данные, то к ним так же необходимо применять эту функцию.
</para>
<para>
</simpara>
<simpara>
<function>mysql_real_escape_string</function> вызывает библиотечную функцию MySQL
mysql_real_escape_string, которая добавляет обратную косую черту к следующим символам:
<literal>\x00</literal>, <literal>\n</literal>, <literal>\r</literal>, <literal>\</literal>,
<literal>'</literal>, <literal>"</literal> и <literal>\x1a</literal>.
</para>
<para>
</simpara>
<simpara>
Эта функция должна всегда (за несколькими исключениями) использоваться для того,
чтобы обезопасить данные, вставляемые в запрос перед отправкой его в MySQL.
</para>
</simpara>
<caution>
<title>Безопасность: кодировка символов по умолчанию</title>
<para>
<simpara>
Кодировка символов должна устанавливаться как на сервере, так и с помощью функции
<function>mysql_set_charset</function>, чтобы влиять на поведение
<function>mysql_real_escape_string</function>. Подробнее описано в разделе <link linkend="mysqlinfo.concepts.charset">кодировка символов</link>.
</para>
</simpara>
</caution>
</refsect1>
@@ -57,9 +57,9 @@
<varlistentry>
<term><parameter>unescaped_string</parameter></term>
<listitem>
<para>
<simpara>
Экранируемая строка.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -68,19 +68,19 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, в которой экранированы все необходимые символы,
или &false; в случае возникновения ошибки.
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
Запуск этой функции без существующего соединения с MySQL вызовет ошибку уровня
<constant>E_WARNING</constant>. Данную функцию можно запускать только если есть
соединение с MySQL.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -105,10 +105,10 @@ $query = sprintf("SELECT * FROM users WHERE user='%s' AND password='%s'",
<example>
<title>Пример использования <function>mysql_real_escape_string</function> без наличия
соединения</title>
<para>
<simpara>
Этот пример показывает, что произойдёт, если вызвать эту функцию без наличия
соединения с MySQL.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -154,36 +154,36 @@ echo $query;
?>
]]>
</programlisting>
<para>
<simpara>
Запрос, который будет отправлен в MySQL:
</para>
</simpara>
<screen>
<![CDATA[
SELECT * FROM users WHERE user='aidan' AND password='' OR ''=''
]]>
</screen>
<para>
<simpara>
Это позволит кому угодно войти в систему без пароля.
</para>
</simpara>
</example>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Функцию <function>mysql_real_escape_string</function> можно использовать
только после того, как установлено соединение с MySQL. В противном
случае возникнет ошибка уровня <constant>E_WARNING</constant>, а функция
возвратит &false;. Если <parameter>link_identifier</parameter> не указан,
используется последнее открытое соединение.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Если не пользоваться этой функцией, то запрос становится уязвимым для
<link linkend="security.database.sql-injection">взлома с помощью SQL-инъекций</link>.
</para>
</simpara>
</note>
<note>
<simpara>

30
reference/mysql/functions/mysql-result.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-result">
<refnamediv>
@@ -29,10 +29,10 @@
<methodparam><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>field</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает содержимое одного поля из набора результата MySQL.
</para>
<para>
</simpara>
<simpara>
Работая с большими результатами запросов, следует использовать одну из
функций, обрабатывающих сразу целый ряд результата (указаны ниже).
Так как эти функции возвращают значение нескольких ячеек сразу,
@@ -40,7 +40,7 @@
Кроме того, учтите, что указание численного смещения работает
намного быстрее, чем указание колонки, или колонки с таблицей
через точку.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -50,24 +50,24 @@
<varlistentry>
<term><parameter>row</parameter></term>
<listitem>
<para>
<simpara>
Номер получаемого ряда из результата. Нумерация рядов начинается
с <literal>0</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>field</parameter></term>
<listitem>
<para>
<simpara>
Имя или смещение получаемого поля.
</para>
<para>
</simpara>
<simpara>
Может быть как смещением поля, именем поля, так и именем поля
вместе с таблицей (таблица.поле). Если для поля был указан псевдоним
('select foo as bar from...'), используйте его вместо имени
самого поля. Если не указан, возвращается первое поле.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -75,10 +75,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Содержимое одного поля из набора результата MySQL в случае успешного выполнения,
или &false; в случае возникновения ошибки.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -111,10 +111,10 @@ mysql_close($link);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Вызовы функции <function>mysql_result</function> не должны смешиваться с
другими функциями, работающими с результатом запроса.
</para>
</simpara>
</note>
</refsect1>

18
reference/mysql/functions/mysql-select-db.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-select-db">
<refnamediv>
@@ -24,12 +24,12 @@
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Выбирает для работы указанную базу данных на сервере, на который
ссылается переданный дескриптор соединения. Каждый последующий
вызов функции <function>mysql_query</function> будет работать
с выбранной базой данных.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,9 +38,9 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
Имя выбираемой базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -49,9 +49,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -81,10 +81,10 @@ if (!$db_selected) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_selectdb</function>
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-set-charset.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-set-charset">
<refnamediv>
@@ -25,9 +25,9 @@
<methodparam><type>string</type><parameter>charset</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Устанавливает кодировку по умолчанию для текущего соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,9 +36,9 @@
<varlistentry>
<term><parameter>charset</parameter></term>
<listitem>
<para>
<simpara>
Корректное название кодировки.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -47,26 +47,26 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Данная функция требует MySQL версии 5.0.7 или выше.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Это наиболее предпочитаемый способ для смены кодировки.
Использование <function>mysql_query</function> в этих целях
(например <literal>SET NAMES utf8</literal>) не рекомендуется.
Смотрите раздел <link linkend="mysqlinfo.concepts.charset">
кодировка символов в MySQL</link> для подробной информации.
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-stat.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-stat">
<refnamediv>
@@ -26,9 +26,9 @@
<type>string</type><methodname>mysql_stat</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_stat</function> возвращает текущий статус сервера.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,7 +40,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку с данными аптайма, количества потоков, запросов,
количеством открытых таблиц и таблиц с сброшенным внутренним кешем
(flush tables), а также количество запросов в секунду. Для получения
@@ -48,7 +48,7 @@
SQL-запрос <literal>SHOW STATUS</literal>.
Если передан некорректный <parameter>link_identifier</parameter>,
то будет возвращён &null;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

30
reference/mysql/functions/mysql-tablename.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-tablename">
<refnamediv>
@@ -23,14 +23,14 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>i</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает имя таблицы из <parameter>result</parameter>.
</para>
<para>
</simpara>
<simpara>
Данная функция устарела. Вместо неё рекомендуется использование
<function>mysql_query</function> с SQL-запросом
<literal>SHOW TABLES [FROM db_name] [LIKE 'pattern']</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,18 +39,18 @@
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
<simpara>
Дескриптор результата типа <type>resource</type>,
полученный из вызова <function>mysql_list_tables</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i</parameter></term>
<listitem>
<para>
<simpara>
Целочисленный индекс (номер ряда/таблицы)
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -58,15 +58,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Имя таблицы в случае успешного выполнения&return.falseforfailure;.
</para>
<para>
</simpara>
<simpara>
Используйте функцию <function>mysql_tablename</function>
для работы с результатом запроса, либо любую другую функцию,
способную это делать, например,
<function>mysql_fetch_array</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -93,10 +93,10 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Для определения количества таблиц в результате запроса можно
использовать функцию <function>mysql_num_rows</function>.
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-thread-id.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-thread-id">
<refnamediv>
@@ -22,14 +22,14 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_thread_id</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_thread_id</function> возвращает идентификатор
текущего потока. Если соединение потеряно и вы пересоединились с помощью
<function>mysql_ping</function>, то идентификатор потока изменится.
Это означает, что вам не следует получать данный идентификатор
и хранить его для дальнейшего использования. Вызывайте функцию
тогда, когда он вам нужен.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,9 +41,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Идентификатор потока в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/mysql/functions/mysql-unbuffered-query.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-unbuffered-query">
<refnamediv>
@@ -23,7 +23,7 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_unbuffered_query</function> посылает запрос MySQL
<parameter>query</parameter> без автоматической обработки и буферизации
её результата, в отличие от функции <function>mysql_query</function>.
@@ -34,7 +34,7 @@
использовании <function>mysql_unbuffered_query</function> с несколькими
соединениями MySQL, вы должны указать необязательный параметр
<parameter>link_identifier</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -43,13 +43,13 @@
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
<simpara>
Запускаемый SQL-запрос.
</para>
<para>
</simpara>
<simpara>
Данные в запросе должны быть
<link linkend="function.mysql-real-escape-string">корректно проэкранированы</link>.
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -58,30 +58,30 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Для SELECT, SHOW, DESCRIBE и EXPLAIN запросов
<function>mysql_unbuffered_query</function>
возвращает <type>resource</type> в случае успешного выполнения, или &false;
в случае возникновения ошибки.
</para>
<para>
</simpara>
<simpara>
Для остальных типов SQL-запросов, UPDATE, DELETE, DROP и т.д.,
<function>mysql_unbuffered_query</function> возвращает &true; в случае
успеха и &false; в случае возникновения ошибки.
</para>
</simpara>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
Однако, плюсы использования <function>mysql_unbuffered_query</function> имеют
свою цену: вы не можете использовать функции <function>mysql_num_rows</function> и
<function>mysql_data_seek</function> с результатом запроса, возвращённым
этой функцией, пока не будут получены все ряды.
Кроме того, вы должны будете обработать все ряды запроса
до отправки нового запроса, используя тот же <parameter>link_identifier</parameter>.
</para>
</simpara>
</note>
</refsect1>

46
reference/mysql/ini.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="mysql.configuration">
&reftitle.runtime;
@@ -99,10 +99,10 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Разрешает доступ к локальным файлам, с точки зрения PHP,
с помощью инструкций LOAD DATA
</para>
</simpara>
</listitem>
</varlistentry>
@@ -112,11 +112,11 @@
<type>bool</type>
</term>
<listitem>
<para>
<simpara>
Позволять ли
<link linkend="features.persistent-connections">постоянные соединения</link>
с MySQL.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -126,9 +126,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Максимальное количество постоянных соединений c MySQL на один процесс.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -138,10 +138,10 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Максимальное количество соединений с MySQL на один процесс, включая
постоянные соединения.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -151,12 +151,12 @@
<type>bool</type>
</term>
<listitem>
<para>
<simpara>
Режим трассировки. Если включена опция <literal>mysql.trace_mode</literal>,
будут отображаться предупреждения при сканировании таблиц/индексов,
непустых результирующих наборов (result sets), а также ошибки SQL.
(Добавлено в версии PHP 4.3.0)
</para>
</simpara>
</listitem>
</varlistentry>
@@ -166,7 +166,7 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
TCP-порт, используемый для соединения с базой данных по умолчанию (если
не был указан другой). Если эта директива опущена, порт будет взят из
переменной среды <envar>MYSQL_TCP_PORT</envar>, значения
@@ -174,7 +174,7 @@
или константы <constant>MYSQL_PORT</constant>, указанной при компиляции,
в указанном порядке. Win32 использует только константу
<constant>MYSQL_PORT</constant>.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -184,10 +184,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Имя сокета по умолчанию, используемого для соединения с локальной базой данных, если не
был указан другой.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mysql.default-host">
@@ -196,10 +196,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Адрес сервера по умолчанию, используемый для соединения с сервером базы
данных, если не указан другой. Не работает в &sqlsafemode;.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -209,10 +209,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Имя пользователя по умолчанию, используемое для соединения с сервером базы
данных, если не указано другое. Не работает в &sqlsafemode;.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -222,10 +222,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Пароль по умолчанию, используемый для соединения с сервером базы данных,
если не указан другой. Не работает в &sqlsafemode;.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mysql.connect-timeout">
@@ -234,10 +234,10 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Время ожидания ответа до разрыва соединения в секундах. Linux также
использует это значение при ожидании первого ответа от сервера.
</para>
</simpara>
</listitem>
</varlistentry>

8
reference/mysql/reference.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: tony2001 Status: ready -->
<reference xml:id="ref.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: tony2001 Status: ready -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ref.mysql">
<title>Функции СУБД MySQL</title>
<titleabbrev>MySQL</titleabbrev>
@@ -9,7 +9,7 @@
<section xml:id="mysql.notes">
&reftitle.notes;
<note>
<para>
<simpara>
Большинство функций MySQL принимают
<parameter>link_identifier</parameter> как последний, опциональный
параметр. Если он не указан, то используется последнее открытое
@@ -17,7 +17,7 @@
используя параметры, указанные в &php.ini;. В случае неудачи, функции
возвращают &false;.
&false;.
</para>
</simpara>
</note>
</section>
</partintro>

13
reference/mysql/setup.xml
View File

@@ -1,16 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d5a653cf30dde918ae0a9eb897f94107b2084247 Maintainer: shein Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="mysql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mysql.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="mysql.requirements">
&reftitle.required;
<para>
<simpara>
Для использования этих функций PHP должен быть собран с поддержкой MySQL.
</para>
</simpara>
<warning>
&mysql.alternative.note;
</warning>
@@ -28,12 +27,12 @@
<!-- {{{ Resources -->
<section xml:id="mysql.resources">
&reftitle.resources;
<para>
<simpara>
Есть два типа ресурсов, используемых в модуле
MySQL. Первый является идентификатором соединения
для подключения к базе данных, а второй ресурс
содержит результат выполнения запроса.
</para>
</simpara>
</section>
<!-- }}} -->