From 11cc528e257576ca839bf06cec69be2070bf399a Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Mon, 19 Jan 2026 03:23:08 +0000 Subject: [PATCH] mysql : fix XML by converting para to simpara tags via script --- reference/mysql/book.xml | 19 +++---- reference/mysql/changelog.xml | 20 +++---- reference/mysql/configure.xml | 44 +++++++-------- .../mysql/functions/mysql-affected-rows.xml | 38 ++++++------- .../mysql/functions/mysql-client-encoding.xml | 10 ++-- reference/mysql/functions/mysql-close.xml | 14 ++--- reference/mysql/functions/mysql-connect.xml | 46 ++++++++-------- reference/mysql/functions/mysql-create-db.xml | 26 ++++----- reference/mysql/functions/mysql-data-seek.xml | 22 ++++---- reference/mysql/functions/mysql-db-name.xml | 26 ++++----- reference/mysql/functions/mysql-db-query.xml | 26 ++++----- reference/mysql/functions/mysql-drop-db.xml | 22 ++++---- reference/mysql/functions/mysql-errno.xml | 14 ++--- reference/mysql/functions/mysql-error.xml | 10 ++-- .../mysql/functions/mysql-escape-string.xml | 22 ++++---- .../mysql/functions/mysql-fetch-array.xml | 22 ++++---- .../mysql/functions/mysql-fetch-assoc.xml | 18 +++---- .../mysql/functions/mysql-fetch-field.xml | 18 +++---- .../mysql/functions/mysql-fetch-lengths.xml | 14 ++--- .../mysql/functions/mysql-fetch-object.xml | 26 ++++----- reference/mysql/functions/mysql-fetch-row.xml | 14 ++--- .../mysql/functions/mysql-field-flags.xml | 18 +++---- reference/mysql/functions/mysql-field-len.xml | 14 ++--- .../mysql/functions/mysql-field-name.xml | 14 ++--- .../mysql/functions/mysql-field-seek.xml | 10 ++-- .../mysql/functions/mysql-field-table.xml | 14 ++--- .../mysql/functions/mysql-field-type.xml | 14 ++--- .../mysql/functions/mysql-free-result.xml | 22 ++++---- .../mysql/functions/mysql-get-client-info.xml | 10 ++-- .../mysql/functions/mysql-get-host-info.xml | 10 ++-- .../mysql/functions/mysql-get-proto-info.xml | 10 ++-- .../mysql/functions/mysql-get-server-info.xml | 10 ++-- reference/mysql/functions/mysql-info.xml | 18 +++---- reference/mysql/functions/mysql-insert-id.xml | 22 ++++---- reference/mysql/functions/mysql-list-dbs.xml | 14 ++--- .../mysql/functions/mysql-list-fields.xml | 30 +++++------ .../mysql/functions/mysql-list-processes.xml | 10 ++-- .../mysql/functions/mysql-list-tables.xml | 26 ++++----- .../mysql/functions/mysql-num-fields.xml | 14 ++--- reference/mysql/functions/mysql-num-rows.xml | 18 +++---- reference/mysql/functions/mysql-pconnect.xml | 54 +++++++++---------- reference/mysql/functions/mysql-ping.xml | 14 ++--- reference/mysql/functions/mysql-query.xml | 42 +++++++-------- .../functions/mysql-real-escape-string.xml | 50 ++++++++--------- reference/mysql/functions/mysql-result.xml | 30 +++++------ reference/mysql/functions/mysql-select-db.xml | 18 +++---- .../mysql/functions/mysql-set-charset.xml | 22 ++++---- reference/mysql/functions/mysql-stat.xml | 10 ++-- reference/mysql/functions/mysql-tablename.xml | 30 +++++------ reference/mysql/functions/mysql-thread-id.xml | 10 ++-- .../functions/mysql-unbuffered-query.xml | 26 ++++----- reference/mysql/ini.xml | 46 ++++++++-------- reference/mysql/reference.xml | 8 +-- reference/mysql/setup.xml | 13 +++-- 54 files changed, 571 insertions(+), 571 deletions(-) diff --git a/reference/mysql/book.xml b/reference/mysql/book.xml index 6bc979fcd..4ec3acef2 100644 --- a/reference/mysql/book.xml +++ b/reference/mysql/book.xml @@ -1,7 +1,7 @@ - + - + Оригинальный API-интерфейс доступа к MySQL-серверам Оригинальный MySQL @@ -9,20 +9,20 @@ &reftitle.intro; - + Модуль устарел с PHP 5.5.0, а в PHP версии 7.0.0 модуль удалили. Вместо устаревшего модуля с MySQL-серверами работают через модуль mysqli или PDO_MySQL. Дополнительную информацию о выборе API-интерфейса для взаимодействия с СУБД MySQL содержит «Обзор API-интерфейсов для подключения к MySQL». - - + + Функции модуля открывают доступ к серверам баз данных MySQL. Подробнее о MySQL рассказывет сайт &url.mysql;. - - + + Документация к MySQL доступна по адресу &url.mysql.docs;. - + @@ -32,7 +32,8 @@ &reference.mysql.examples; &reference.mysql.reference; - + &ChangelogListingTitle; - &ChangelogListingDescription; + &ChangelogListingDescription; Общий список изменений для модуля ext/mysql - + Этот список изменений ссылается на модуль ext/mysql. - + Глобальные изменения в ext/mysql - + Следующий список представляет собой подборку изменений модуля ext/mysql. - + @@ -29,9 +29,9 @@ 7.0.0 - + Этот модуль удалён из PHP. Подробности тут . - + @@ -41,10 +41,10 @@ Изменения в существующих функциях - + Нижеследующий список является компиляцией всех изменений в функциях ext/mysql. - + diff --git a/reference/mysql/configure.xml b/reference/mysql/configure.xml index 14065d54a..603d41cb9 100644 --- a/reference/mysql/configure.xml +++ b/reference/mysql/configure.xml @@ -1,38 +1,38 @@ - + -
+
&reftitle.install; &mysql.alternative.note; - + Для компиляции просто используйте опцию конфигурации , где необязательный параметр [DIR] указывает на директорию с установленным MySQL. - - + + Несмотря на то, что модуль MySQL совместим с MySQL 4.1.0 и выше, он не поддерживает дополнительную функциональность, предоставляемую этими версиями. Для получения такой возможности воспользуйтесь модулем MySQLi. - - + + Если вы хотите установить модуль mysql совместно с mysqli, то для избежания каких-либо конфликтов необходимо использовать одну и ту же клиентскую библиотеку. - +
Установка на Linux-системы - + Примечание: [DIR] является путём к файлам клиентской библиотеки MySQL (заголовкам и библиотекам), которые можно скачать с MySQL. - + Таблица компиляции ext/mysql по версиям PHP @@ -86,7 +86,7 @@ Установка на Windows-системы
PHP 5.0.x, 5.1.x, 5.2.x - + Поддержка MySQL больше не включена по умолчанию, поэтому для её включения необходимо подключить php_mysql.dll DLL внутри &php.ini;. Кроме этого, PHP понадобится доступ к клиентской библиотеке @@ -98,8 +98,8 @@ Хотя копирование libmysql.dll в системную папку Windows также сработает (потому что системная папка находится по умолчанию в PATH), это не рекомендуется. - - + + Как и при включении любого другого модуля PHP (в том числе и php_mysql.dll), директива extension_dir должна указывать на @@ -107,43 +107,43 @@ Инструкции по ручной установке в Windows . Пример значения extension_dir для PHP 5: c:\php\ext - + - + Если при старте веб-сервера происходит подобная ошибка: "Unable to load dynamic library './php_mysql.dll'", ("Невозможно подгрузить динамическую библиотеку './php_mysql.dll'"), то это случается из-за того, что на вашей системе не может быть найдена php_mysql.dll и/или libmysql.dll. - +
PHP 5.3.0+ - + MySQL Native Driver включён по умолчанию. В том числе php_mysql.dll, но без требования и использования libmysql.dll. - +
Замечания по установке MySQL - + Сбои в работе PHP могут возникнуть при загрузке этого модуля вместе с модулем recode. За дополнительной информацией обращайтесь к разделу о модуле для recode. - + - + Если вам требуется поддержка кодировок отличных от latin, (установленной по умолчанию), вам придётся установить внешнюю библиотеку libmysqlclient, скомпилированную с их поддержкой. - +
diff --git a/reference/mysql/functions/mysql-affected-rows.xml b/reference/mysql/functions/mysql-affected-rows.xml index acbc704ad..b0a5c2ac7 100644 --- a/reference/mysql/functions/mysql-affected-rows.xml +++ b/reference/mysql/functions/mysql-affected-rows.xml @@ -1,5 +1,5 @@ - + @@ -23,11 +23,11 @@ intmysql_affected_rows resourcelink_identifierNULL - + Возвращает количество рядов, затронутых последним INSERT, UPDATE, REPLACE или DELETE запросом, связанным с дескриптором link_identifier. - + @@ -39,29 +39,29 @@ &reftitle.returnvalues; - + Возвращает количество изменённых записей в случае успешного выполнения, и -1 в случае если последний запрос не удался. - - + + Если последний запрос был DELETE без указания WHERE и, соответственно, таблица была очищена, функция вернёт ноль во всех версиях MySQL до 4.1.2. - - + + При использовании UPDATE, MySQL не обновит колонки, уже содержащие новое значение. Вследствие этого, функция mysql_affected_rows не всегда возвращает количество рядов, подошедших под условия, только количество рядов, обновлённых запросом. - - + + Запрос REPLACE сначала удаляет запись с указанным первичным ключом, а потом вставляет новую. Данная функция возвращает количество удалённых записей вместе с количеством вставленных. - - + + В случае использования запросов типа "INSERT ... ON DUPLICATE KEY UPDATE", возвращаемое значение будет равно 1 в случае, если была произведена вставка, или 2 при обновлении существующего ряда. - + @@ -126,27 +126,27 @@ mysql_query("COMMIT"); &reftitle.notes; Транзакции - + При использовании транзакций mysql_affected_rows нужно вызывать после запросов INSERT, UPDATE, DELETE, но не после COMMIT. - + Запросы SELECT - + Чтобы получить количество рядов, возвращённых SELECT-запросом, используйте функцию mysql_num_rows. - + Каскадные внешние ключи - + mysql_affected_rows не подсчитывает ряды, неявно изменённые ограничениями ON DELETE CASCADE и/или ON UPDATE CASCADE. - + diff --git a/reference/mysql/functions/mysql-client-encoding.xml b/reference/mysql/functions/mysql-client-encoding.xml index 27928d5e4..c9b706d3e 100644 --- a/reference/mysql/functions/mysql-client-encoding.xml +++ b/reference/mysql/functions/mysql-client-encoding.xml @@ -1,5 +1,5 @@ - + @@ -22,9 +22,9 @@ stringmysql_client_encoding resourcelink_identifierNULL - + Возвращает значение переменной MySQL character_set. - + @@ -36,10 +36,10 @@ &reftitle.returnvalues; - + Возвращает используемую по умолчанию кодировку для данного соединения. - + diff --git a/reference/mysql/functions/mysql-close.xml b/reference/mysql/functions/mysql-close.xml index 04332dd04..17abfabfe 100644 --- a/reference/mysql/functions/mysql-close.xml +++ b/reference/mysql/functions/mysql-close.xml @@ -1,5 +1,5 @@ - + @@ -23,12 +23,12 @@ boolmysql_close resourcelink_identifierNULL - + mysql_close закрывает непостоянное соединение с базой данных MySQL, на которое указывает переданный дескриптор. Если параметр link_identifier не указан, закрывается последнее открытое (текущее) соединение. - + &mysql.close.connections.result.sets; @@ -41,9 +41,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -74,11 +74,11 @@ mysql_close($link); &reftitle.notes; - + mysql_close не закрывает постоянные соединения, созданные функцией mysql_pconnect. Для дополнительной информации смотрите руководство по постоянным соединениям. - + diff --git a/reference/mysql/functions/mysql-connect.xml b/reference/mysql/functions/mysql-connect.xml index 89abc75fb..7fbcea420 100644 --- a/reference/mysql/functions/mysql-connect.xml +++ b/reference/mysql/functions/mysql-connect.xml @@ -1,5 +1,5 @@ - + @@ -27,10 +27,10 @@ boolnew_link&false; intclient_flags0 - + Открывает новое соединение с сервером MySQL или использует уже существующее. - + @@ -39,46 +39,46 @@ server - + Сервер MySQL. Может также включать номер порта, например, "hostname:port" или путь к локальному сокету, например, ":/path/to/socket" для локального сервера. - - + + Если PHP-директива mysql.default_host не определена (по умолчанию), то значением по умолчанию является 'localhost:3306'. В &sqlsafemode; этот параметр игнорируется и всегда используется значение 'localhost:3306'. - + username - + Имя пользователя. Значение по умолчанию определяется директивой mysql.default_user. В &sqlsafemode; этот параметр будет проигнорирован и будет использован пользователь, владеющий процессом сервера. - + password - + Пароль. Значение по умолчанию определяется директивой mysql.default_password. В &sqlsafemode; этот параметр будет проигнорирован и в качестве пароля будет использована пустая строка. - + new_link - + Если второй вызов функции mysql_connect произошёл с теми же аргументами, то новое соединение не будет установлено. Вместо этого функция вернёт ссылку @@ -88,13 +88,13 @@ соединение, даже если соединение с аналогичными параметрами уже открыто. В &sqlsafemode; этот параметр игнорируется. - + client_flags - + Параметр client_flags должен быть комбинацией из следующих констант: 128 (включает обработку LOAD DATA LOCAL), @@ -104,7 +104,7 @@ MYSQL_CLIENT_INTERACTIVE. Подробнее читайте в разделе . В &sqlsafemode; этот параметр игнорируется. - + @@ -112,10 +112,10 @@ &reftitle.returnvalues; - + Возвращает дескриптор соединения с MySQL в случае успешного выполнения&return.falseforfailure;. - + @@ -191,7 +191,7 @@ mysql_close($link); &reftitle.notes; - + При указании параметру server значения "localhost" или "localhost:port" клиентская библиотека MySQL будет пытаться соединиться с локальным сокетом. @@ -201,17 +201,17 @@ mysql_close($link); локальному сокету, правильный путь должен быть установлен через указание директивы &php.ini; mysql.default_host в &php.ini;, после чего можно оставлять параметр server пустым. - + - + Соединение с сервером будет закрыто при завершении исполнения скрипта, если только до этого оно не было закрыто с помощью функции mysql_close. - + - + Ошибка "Can't create TCP/IP socket (10106)" (Невозможно создать сокет TCP/IP) обычно означает, что конфигурационная директива variables_order @@ -219,7 +219,7 @@ mysql_close($link); не будет скопирована переменная окружения SYSTEMROOT, то PHP будет испытывать проблемы при загрузке Winsock. - + diff --git a/reference/mysql/functions/mysql-create-db.xml b/reference/mysql/functions/mysql-create-db.xml index dcb58ced6..71d194351 100644 --- a/reference/mysql/functions/mysql-create-db.xml +++ b/reference/mysql/functions/mysql-create-db.xml @@ -1,5 +1,5 @@ - + @@ -24,10 +24,10 @@ stringdatabase_name resourcelink_identifierNULL - + mysql_create_db пытается создать базу данных на сервере, с которым ассоциирован переданный дескриптор соединения. - + @@ -36,9 +36,9 @@ database_name - + Имя создаваемой базы данных. - + &mysql.linkid.description; @@ -47,20 +47,20 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.examples; Пример создания базы данных MySQL - + Функция mysql_create_db не рекомендуется к использованию. Предпочтительнее использовать mysql_query с SQL-запросом создания базы данных CREATE DATABASE. - + &reftitle.notes; - + &info.deprecated.alias; mysql_createdb - + - + Данная функция не будет доступна, если модуль MySQL был скомпилирован клиентской библиотекой MySQL версии 4.x. - + diff --git a/reference/mysql/functions/mysql-data-seek.xml b/reference/mysql/functions/mysql-data-seek.xml index 47ee07360..a29d01507 100644 --- a/reference/mysql/functions/mysql-data-seek.xml +++ b/reference/mysql/functions/mysql-data-seek.xml @@ -1,5 +1,5 @@ - + @@ -24,14 +24,14 @@ resourceresult introw_number - + mysql_data_seek перемещает внутренний указатель результата запроса, с которым связан переданный дескриптор, к ряду с указанным номером. Следующий вызов к функции получения данных MySQL, такой как mysql_fetch_assoc, вернёт именно его. - - + + Нумерация row_number начинается с 0. row_number должен быть значением в диапазоне от 0 до mysql_num_rows - 1. Однако, если @@ -39,7 +39,7 @@ попытка сдвига указателя к нулевому ряду завершится неудачей - будет вызвана ошибка уровня E_WARNING и mysql_data_seek вернёт &false;. - + @@ -49,9 +49,9 @@ row_number - + Желаемый номер ряда в полученном дескрипторе результата. - + @@ -59,9 +59,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -108,11 +108,11 @@ mysql_free_result($result); &reftitle.notes; - + Функция mysql_data_seek может быть использована только с mysql_query, но не с mysql_unbuffered_query. - + diff --git a/reference/mysql/functions/mysql-db-name.xml b/reference/mysql/functions/mysql-db-name.xml index 1d4b434f2..1c19b52ad 100644 --- a/reference/mysql/functions/mysql-db-name.xml +++ b/reference/mysql/functions/mysql-db-name.xml @@ -1,5 +1,5 @@ - + @@ -24,10 +24,10 @@ introw mixedfieldNULL - + Возвращает название базы данных из вызова к mysql_list_dbs. - + @@ -36,25 +36,25 @@ result - + Дескриптор результата, полученный из вызова mysql_list_dbs. - + row - + Индекс в результате. - + field - + Имя поля. - + @@ -62,11 +62,11 @@ &reftitle.returnvalues; - + Возвращает название базы данных в случае успешного выполнения, или &false; в случае ошибки. В случае возврата &false; используйте mysql_error для определения природы ошибок. - + @@ -96,10 +96,10 @@ while ($i < $cnt) { &reftitle.notes; - + &info.deprecated.alias; mysql_dbname - + diff --git a/reference/mysql/functions/mysql-db-query.xml b/reference/mysql/functions/mysql-db-query.xml index ab695bc31..82ad59485 100644 --- a/reference/mysql/functions/mysql-db-query.xml +++ b/reference/mysql/functions/mysql-db-query.xml @@ -1,5 +1,5 @@ - + @@ -25,10 +25,10 @@ stringquery resourcelink_identifierNULL - + mysql_db_query выбирает базу данных и выполняет запрос к ней. - + @@ -37,20 +37,20 @@ database - + Имя базы данных, на которую произойдёт переключение. - + query - + Запрос MySQL. - - + + Данные в запросе должны быть корректно проэкранированы. - + &mysql.linkid.description; @@ -59,12 +59,12 @@ &reftitle.returnvalues; - + Возвращает ресурс результата запроса к MySQL или &false; в случае возникновения ошибки. Функция также возвращает &true;/&false; для INSERT/UPDATE/DELETE запросов для индикации успеха/провала. - + @@ -109,7 +109,7 @@ mysql_free_result($result); &reftitle.notes; - + Учтите, что эта функция НЕ переключает соединение обратно к предыдущей базе данных. Другими словами, вы не можете использовать эту функцию, чтобы временно @@ -118,7 +118,7 @@ mysql_free_result($result); database.table в SQL-запросах или функцию mysql_select_db, вместо использования этой функции. - + diff --git a/reference/mysql/functions/mysql-drop-db.xml b/reference/mysql/functions/mysql-drop-db.xml index c36768101..956bdbd3f 100644 --- a/reference/mysql/functions/mysql-drop-db.xml +++ b/reference/mysql/functions/mysql-drop-db.xml @@ -1,5 +1,5 @@ - + @@ -23,12 +23,12 @@ stringdatabase_name resourcelink_identifierNULL - + mysql_drop_db пытается уничтожить базу данных на сервере, на который ссылается переданный дескриптор соединения. Данная функция устарела, используйте вместо неё mysql_query с запросом DROP DATABASE. - + @@ -37,9 +37,9 @@ database_name - + Имя удаляемой базы данных. - + &mysql.linkid.description; @@ -48,9 +48,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -80,16 +80,16 @@ if (mysql_query($sql, $link)) { &reftitle.notes; - + Эта функция недоступна, если модуль был скомпилирован с клиентской библиотекой MySQL версии 4.x. - + - + &info.deprecated.alias; mysql_dropdb - + diff --git a/reference/mysql/functions/mysql-errno.xml b/reference/mysql/functions/mysql-errno.xml index 13e6f7e8e..179fff907 100644 --- a/reference/mysql/functions/mysql-errno.xml +++ b/reference/mysql/functions/mysql-errno.xml @@ -1,5 +1,5 @@ - + @@ -23,17 +23,17 @@ intmysql_errno resourcelink_identifierNULL - + Возвращает код ошибки последней функции работы с MySQL. - - + + Ошибки работы с MySQL больше не вызывают сообщений в PHP. Вместо этого используйте функцию mysql_errno, чтобы получить код ошибки. Учтите, что функция возвращает код ошибки только последней выполненной функции (исключая mysql_error и mysql_errno). Проверяйте результат работы функции до вызова следующей. - + @@ -45,10 +45,10 @@ &reftitle.returnvalues; - + Возвращает код ошибки последней функции работы с MySQL, или 0 (ноль), если операция выполнена успешно. - + diff --git a/reference/mysql/functions/mysql-error.xml b/reference/mysql/functions/mysql-error.xml index 7587d3684..ad7536e85 100644 --- a/reference/mysql/functions/mysql-error.xml +++ b/reference/mysql/functions/mysql-error.xml @@ -1,5 +1,5 @@ - + @@ -23,7 +23,7 @@ stringmysql_error resourcelink_identifierNULL - + Возвращает текст ошибки выполнения последней функции MySQL. Ошибки работы с MySQL больше не вызывают сообщений в PHP. Вместо этого используйте функцию mysql_error, для @@ -32,7 +32,7 @@ mysql_error и mysql_errno), поэтому убедитесь, что вы вызываете данную функцию до вызова следующей функции MySQL. - + @@ -44,11 +44,11 @@ &reftitle.returnvalues; - + Возвращает текст ошибки выполнения последней функции MySQL, или '' (пустую строку), если операция выполнена успешно. - + diff --git a/reference/mysql/functions/mysql-escape-string.xml b/reference/mysql/functions/mysql-escape-string.xml index 626666a69..939c94084 100644 --- a/reference/mysql/functions/mysql-escape-string.xml +++ b/reference/mysql/functions/mysql-escape-string.xml @@ -1,5 +1,5 @@ - + @@ -23,19 +23,19 @@ stringmysql_escape_string stringunescaped_string - + Функция экранирует unescaped_string таким образом, после чего её можно безопасно использовать в mysql_query. Данная функция устарела. - - + + Функция идентична mysql_real_escape_string, исключая тот факт, что mysql_real_escape_string принимает параметром ещё и идентификатор соединения и экранирует строку с учётом текущей кодировки. mysql_escape_string не делает этого и результат работы не зависит от кодировки, в который вы работаете с БД. - + @@ -44,9 +44,9 @@ unescaped_string - + Экранируемая строка. - + @@ -54,9 +54,9 @@ &reftitle.returnvalues; - + Возвращает экранируемую строку. - + @@ -84,10 +84,10 @@ Escaped string: Zak\'s Laptop &reftitle.notes; - + mysql_escape_string не экранирует символы % и _. - + diff --git a/reference/mysql/functions/mysql-fetch-array.xml b/reference/mysql/functions/mysql-fetch-array.xml index a0bf5bcd3..b190724d3 100644 --- a/reference/mysql/functions/mysql-fetch-array.xml +++ b/reference/mysql/functions/mysql-fetch-array.xml @@ -1,5 +1,5 @@ - + @@ -24,10 +24,10 @@ resourceresult intresult_typeMYSQL_BOTH - + Возвращает массив, соответствующий обработанному ряду результата запроса и сдвигает внутренний указатель данных вперёд. - + @@ -37,12 +37,12 @@ result_type - + Тип возвращаемого массива. Является константой и может принимать следующие значения: MYSQL_ASSOC, MYSQL_NUM и MYSQL_BOTH. - + @@ -50,7 +50,7 @@ &reftitle.returnvalues; - + Возвращает массив строк, соответствующих обработанному ряду результата запроса, или &false;, если рядов больше нет. Тип возвращаемого массива зависит от значения параметра result_type. @@ -61,15 +61,15 @@ mysql_fetch_assoc), а MYSQL_NUM - только численные (аналогично функции mysql_fetch_row). - - + + Если несколько колонок в результате будут иметь одинаковые названия, то будет возвращена последняя колонка. Чтобы получить доступ к другим колонкам с тем же именем, используйте численные индексы массива или псевдонимы в запросе. В случае псевдонимов используйте именно их - вы не сможете использовать настоящие имена колонок. - + @@ -148,12 +148,12 @@ mysql_free_result($result); &reftitle.notes; Производительность - + Важно заметить, что mysql_fetch_array работает незначительно медленнее, чем mysql_fetch_row, в то же время предоставляя намного более удобный доступ к данным. - + &database.field-case; &database.fetch-null; diff --git a/reference/mysql/functions/mysql-fetch-assoc.xml b/reference/mysql/functions/mysql-fetch-assoc.xml index bc878377b..1eb474242 100644 --- a/reference/mysql/functions/mysql-fetch-assoc.xml +++ b/reference/mysql/functions/mysql-fetch-assoc.xml @@ -1,5 +1,5 @@ - + @@ -26,13 +26,13 @@ arraymysql_fetch_assoc resourceresult - + Возвращает ассоциативный массив, соответствующий полученному ряду и сдвигает вперёд внутренний указатель результата. Функция mysql_fetch_assoc аналогична вызову функции mysql_fetch_array со вторым необязательным параметром, равным MYSQL_ASSOC. Функция возвращает только ассоциативный массив. - + @@ -44,11 +44,11 @@ &reftitle.returnvalues; - + Возвращает ассоциативный массив строк, соответствующий полученному ряду, либо &false; если рядов больше нет. - - + + Если два или более столбцов результата имеют одинаковые имена, приоритет будет иметь последний столбец. Для доступа к другому одноимённому столбцу (или столбцам), вам необходимо либо обратиться @@ -56,7 +56,7 @@ mysql_fetch_row либо добавить псевдонимы к нужным столбцам. Для более подробной информации о псевдонимах смотрите описание примера mysql_fetch_array. - + @@ -117,12 +117,12 @@ mysql_free_result($result); &reftitle.notes; Производительность - + Важно отметить, что mysql_fetch_assoc лишь незначительно медленнее, чем mysql_fetch_row, но в то же время предоставляет важную дополнительную информацию. - + &database.field-case; &database.fetch-null; diff --git a/reference/mysql/functions/mysql-fetch-field.xml b/reference/mysql/functions/mysql-fetch-field.xml index ac6b061af..7b272db0c 100644 --- a/reference/mysql/functions/mysql-fetch-field.xml +++ b/reference/mysql/functions/mysql-fetch-field.xml @@ -1,5 +1,5 @@ - + @@ -24,11 +24,11 @@ resourceresult intfield_offset0 - + Возвращает объект, содержащий информацию о колонке. Эту функцию можно использовать для получения информации о полях в переданном результате запроса. - + @@ -38,12 +38,12 @@ field_offset - + Числовое смещение поля. Если смещение не указано, функция возвращает информацию о первой колонке, которая ещё не была обработана этой функцией. Нумерация field_offset начинается с 0. - + @@ -51,10 +51,10 @@ &reftitle.returnvalues; - + Возвращает object, содержащий информацию о колонке. Объект содержит следующие свойства: - + @@ -171,11 +171,11 @@ mysql_free_result($result); &reftitle.notes; &database.field-case; - + Если поля или таблицы имеют дополнительные имена в запросе SQL, то будет возвращены эти дополнительные имена. Исходное имя может быть получено, например, с помощью mysqli_result::fetch_field. - + diff --git a/reference/mysql/functions/mysql-fetch-lengths.xml b/reference/mysql/functions/mysql-fetch-lengths.xml index 1b0f00b4c..6322c3fcd 100644 --- a/reference/mysql/functions/mysql-fetch-lengths.xml +++ b/reference/mysql/functions/mysql-fetch-lengths.xml @@ -1,5 +1,5 @@ - + @@ -23,18 +23,18 @@ arrayfalsemysql_fetch_lengths resourceresult - + Возвращает массив длин для каждого поля, содержащегося в последнем ряду результата, полученном из MySQL. - - + + mysql_fetch_lengths возвращает длины каждого поля, содержащегося в последнем ряду, обработанном функциями mysql_fetch_row, mysql_fetch_assoc, mysql_fetch_array и mysql_fetch_object в массиве, начинающемся с 0. - + @@ -46,9 +46,9 @@ &reftitle.returnvalues; - + Массив (array) длин в случае успешного выполнения&return.falseforfailure;. - + diff --git a/reference/mysql/functions/mysql-fetch-object.xml b/reference/mysql/functions/mysql-fetch-object.xml index 2ce840ab2..d8caaf35e 100644 --- a/reference/mysql/functions/mysql-fetch-object.xml +++ b/reference/mysql/functions/mysql-fetch-object.xml @@ -1,5 +1,5 @@ - + @@ -28,10 +28,10 @@ stringclass_name arrayparams - + Возвращает объект со свойствами, соответствующими колонкам в обработанном ряду и сдвигает внутренний указатель результата вперёд. - + @@ -41,20 +41,20 @@ class_name - + Имя класса. Будет создан экземпляр указанного класса, заполнен свойствами и возвращён. Если не указан, возвращается экземпляр stdClass. - + params - + Необязательный массив (array) параметров, передаваемых в конструктор создаваемого экземпляра class_name. - + @@ -62,11 +62,11 @@ &reftitle.returnvalues; - + Возвращает объект (object) со строковыми свойствами, соответствующими полученному ряду, или &false;, если рядов больше нет. - + @@ -113,20 +113,20 @@ var_dump($obj); &reftitle.notes; Производительность - + В плане скорости эта функция аналогична mysql_fetch_array и почти также быстра, как mysql_fetch_row (разница незначительна). - + - + mysql_fetch_object работает аналогично mysql_fetch_array, с единственным отличием - функция возвращает объект вместо массива. Это, кроме всего прочего, означает, что вы сможете работать с полями только по имени колонок, а не индексов (числа не могут быть свойствами объекта). - + &database.field-case; &database.fetch-null; diff --git a/reference/mysql/functions/mysql-fetch-row.xml b/reference/mysql/functions/mysql-fetch-row.xml index 94d58f624..e7a77c6f8 100644 --- a/reference/mysql/functions/mysql-fetch-row.xml +++ b/reference/mysql/functions/mysql-fetch-row.xml @@ -1,5 +1,5 @@ - + @@ -26,11 +26,11 @@ arraymysql_fetch_row resourceresult - + Возвращает массив с числовыми индексами, содержащий данные обработанного ряда, и сдвигает внутренний указатель результата вперёд. - + @@ -42,16 +42,16 @@ &reftitle.returnvalues; - + Возвращает массив строк с числовыми индексами, содержащий данные обработанного ряда, или &false;, если рядов не осталось. - - + + mysql_fetch_row обрабатывает один ряд результата, на который ссылается переданный указатель. Ряд возвращается в виде массива. Каждая колонка располагается в следующей ячейке массива, начиная с нулевого индекса - + diff --git a/reference/mysql/functions/mysql-field-flags.xml b/reference/mysql/functions/mysql-field-flags.xml index e57a43d83..ae17655b5 100644 --- a/reference/mysql/functions/mysql-field-flags.xml +++ b/reference/mysql/functions/mysql-field-flags.xml @@ -1,5 +1,5 @@ - + @@ -24,12 +24,12 @@ resourceresult intfield_offset - + mysql_field_flags возвращает флаги, связанные с указанным полем. Каждый флаг возвращается как отдельное слово, отделённое от предыдущего пробелом. Полученное значение можно разбить в массив, используя функцию explode. - + @@ -42,10 +42,10 @@ &reftitle.returnvalues; - + Возвращает строку с флагами, связанными с результатом&return.falseforfailure;. - - + + Возвращаются следующие флаги, если ваша версия MySQL их уже поддерживает: "not_null", "primary_key", "unique_key", @@ -53,7 +53,7 @@ "unsigned", "zerofill", "binary", "enum", "auto_increment" и "timestamp". - + @@ -93,10 +93,10 @@ Array &reftitle.notes; - + &info.deprecated.alias; mysql_fieldflags - + diff --git a/reference/mysql/functions/mysql-field-len.xml b/reference/mysql/functions/mysql-field-len.xml index 3da68bd3f..5c704afd6 100644 --- a/reference/mysql/functions/mysql-field-len.xml +++ b/reference/mysql/functions/mysql-field-len.xml @@ -1,5 +1,5 @@ - + @@ -24,9 +24,9 @@ resourceresult intfield_offset - + mysql_field_len возвращает длину указанного поля. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + Длина указанного поля в случае успешного выполнения&return.falseforfailure;. - + @@ -69,10 +69,10 @@ echo $length; &reftitle.notes; - + &info.deprecated.alias; mysql_fieldlen - + diff --git a/reference/mysql/functions/mysql-field-name.xml b/reference/mysql/functions/mysql-field-name.xml index d821caaca..c33d55cd9 100644 --- a/reference/mysql/functions/mysql-field-name.xml +++ b/reference/mysql/functions/mysql-field-name.xml @@ -1,5 +1,5 @@ - + @@ -24,10 +24,10 @@ resourceresult intfield_offset - + mysql_field_name возвращает название колонки с указанным индексом. - + @@ -40,9 +40,9 @@ &reftitle.returnvalues; - + Название поля по указанному индексу в случае успешного выполнения&return.falseforfailure;. - + @@ -87,10 +87,10 @@ password &reftitle.notes; &database.field-case; - + &info.deprecated.alias; mysql_fieldname - + diff --git a/reference/mysql/functions/mysql-field-seek.xml b/reference/mysql/functions/mysql-field-seek.xml index 2ac5a9227..4f9e9910b 100644 --- a/reference/mysql/functions/mysql-field-seek.xml +++ b/reference/mysql/functions/mysql-field-seek.xml @@ -1,5 +1,5 @@ - + @@ -28,12 +28,12 @@ resourceresult intfield_offset - + Перемещает указатель к полю с указанным смещением. Если следующий вызов функции mysql_fetch_field не содержит смещения, то будет возвращено смещение, содержащееся в mysql_field_seek. - + @@ -46,9 +46,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/mysql/functions/mysql-field-table.xml b/reference/mysql/functions/mysql-field-table.xml index 04553b966..a219a5c0a 100644 --- a/reference/mysql/functions/mysql-field-table.xml +++ b/reference/mysql/functions/mysql-field-table.xml @@ -1,5 +1,5 @@ - + @@ -24,9 +24,9 @@ resourceresult intfield_offset - + Возвращает название таблицы, которой принадлежит указанное поле. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + Имя таблицы в случае успешного выполнения. - + @@ -74,10 +74,10 @@ for ($i = 0; $i < mysql_num_fields($result); ++$i) { &reftitle.notes; - + &info.deprecated.alias; mysql_fieldtable - + diff --git a/reference/mysql/functions/mysql-field-type.xml b/reference/mysql/functions/mysql-field-type.xml index 184f90a6d..e8bbcbc40 100644 --- a/reference/mysql/functions/mysql-field-type.xml +++ b/reference/mysql/functions/mysql-field-type.xml @@ -1,5 +1,5 @@ - + @@ -24,11 +24,11 @@ resourceresult intfield_offset - + Функция mysql_field_type аналогична функции mysql_field_name. Аргументы одинаковы, но вместо имени колонки возвращается её тип. - + @@ -41,12 +41,12 @@ &reftitle.returnvalues; - + Поля могут быть следующих типов: "int", "real", "string", "blob" и других, подробно описанных документации MySQL. - + @@ -93,10 +93,10 @@ string type 9 not_null enum &reftitle.notes; - + &info.deprecated.alias; mysql_fieldtype - + diff --git a/reference/mysql/functions/mysql-free-result.xml b/reference/mysql/functions/mysql-free-result.xml index 8b9bffdc2..bd38eea5f 100644 --- a/reference/mysql/functions/mysql-free-result.xml +++ b/reference/mysql/functions/mysql-free-result.xml @@ -1,5 +1,5 @@ - + @@ -23,18 +23,18 @@ boolmysql_free_result resourceresult - + mysql_free_result высвободит всю память, занимаемую результатом, на который ссылается переданный дескриптор result. - - + + mysql_free_result нуждается в вызове только в том случае, если вы всерьёз обеспокоены тем, сколько памяти используют ваши запросы к БД, возвращающие большое количество данных. Вся память, используемая для хранения этих данных автоматически очистится в конце работы скрипта. - + @@ -46,16 +46,16 @@ &reftitle.returnvalues; - + &return.success; - - + + Если в качестве параметра result передан не ресурс, то будет вызвана ошибка уровня E_WARNING. Стоит также заметить, что mysql_query возвращает resource только для запросов SELECT, SHOW, EXPLAIN и DESCRIBE. - + @@ -87,10 +87,10 @@ echo $row['email']; &reftitle.notes; - + &info.deprecated.alias; mysql_freeresult - + diff --git a/reference/mysql/functions/mysql-get-client-info.xml b/reference/mysql/functions/mysql-get-client-info.xml index bf0ec1bbe..f6469becc 100644 --- a/reference/mysql/functions/mysql-get-client-info.xml +++ b/reference/mysql/functions/mysql-get-client-info.xml @@ -1,5 +1,5 @@ - + @@ -26,10 +26,10 @@ stringmysql_get_client_info - + mysql_get_client_info возвращает строку, содержащую версию клиентской библиотеки. - + @@ -39,9 +39,9 @@ &reftitle.returnvalues; - + Версия клиентской библиотеки MySQL. - + diff --git a/reference/mysql/functions/mysql-get-host-info.xml b/reference/mysql/functions/mysql-get-host-info.xml index 648d7c95b..41ce4d0c8 100644 --- a/reference/mysql/functions/mysql-get-host-info.xml +++ b/reference/mysql/functions/mysql-get-host-info.xml @@ -1,5 +1,5 @@ - + @@ -26,10 +26,10 @@ stringfalsemysql_get_host_info resourcelink_identifierNULL - + Описывает тип используемого соединения, указанного переданным дескриптором соединения, включая имя хоста. - + @@ -41,10 +41,10 @@ &reftitle.returnvalues; - + Возвращает строку, описывающую тип используемого соединения, указанного переданным дескриптором соединения&return.falseforfailure;. - + diff --git a/reference/mysql/functions/mysql-get-proto-info.xml b/reference/mysql/functions/mysql-get-proto-info.xml index 70c5f7d0e..9cc9b5150 100644 --- a/reference/mysql/functions/mysql-get-proto-info.xml +++ b/reference/mysql/functions/mysql-get-proto-info.xml @@ -1,5 +1,5 @@ - + @@ -22,9 +22,9 @@ intfalsemysql_get_proto_info resourcelink_identifierNULL - + Возвращает информацию о протоколе MySQL. - + @@ -36,9 +36,9 @@ &reftitle.returnvalues; - + Возвращает используемый протокол MySQL в случае успешного выполнения&return.falseforfailure;. - + diff --git a/reference/mysql/functions/mysql-get-server-info.xml b/reference/mysql/functions/mysql-get-server-info.xml index 19d61cb1e..340f9161f 100644 --- a/reference/mysql/functions/mysql-get-server-info.xml +++ b/reference/mysql/functions/mysql-get-server-info.xml @@ -1,5 +1,5 @@ - + @@ -26,9 +26,9 @@ stringfalsemysql_get_server_info resourcelink_identifierNULL - + Возвращает версию сервера MySQL. - + @@ -40,9 +40,9 @@ &reftitle.returnvalues; - + Возвращает версию сервера MySQL в случае успешного выполнения&return.falseforfailure;. - + diff --git a/reference/mysql/functions/mysql-info.xml b/reference/mysql/functions/mysql-info.xml index a9d5f47b5..579827366 100644 --- a/reference/mysql/functions/mysql-info.xml +++ b/reference/mysql/functions/mysql-info.xml @@ -1,5 +1,5 @@ - + @@ -22,9 +22,9 @@ stringmysql_info resourcelink_identifierNULL - + Возвращает подробную информацию о последнем запросе. - + @@ -36,22 +36,22 @@ &reftitle.returnvalues; - + Возвращает информацию о запросе в случае успешного выполнения, или &false; в случае возникновения ошибки. Смотрите пример ниже для каких запросов возвращается информация и как выглядят возвращаемые значения. Для не перечисленных запросов будет возвращено значение &false;. - + &reftitle.examples; Корректные виды запросов MySQL - + Числа расставлены только для примера -- их значения зависят от результата запроса. - + &reftitle.notes; - + mysql_info возвращает значение не равное &false; для INSERT ... VALUES только в том случае, если в запросе присутствует несколько списков значений. - + diff --git a/reference/mysql/functions/mysql-insert-id.xml b/reference/mysql/functions/mysql-insert-id.xml index 3ee5e958c..53faa8ad6 100644 --- a/reference/mysql/functions/mysql-insert-id.xml +++ b/reference/mysql/functions/mysql-insert-id.xml @@ -1,5 +1,5 @@ - + @@ -23,10 +23,10 @@ intmysql_insert_id resourcelink_identifierNULL - + Возвращает идентификатор, сгенерированный колонкой с AUTO_INCREMENT последним запросом (обычно INSERT). - + @@ -38,12 +38,12 @@ &reftitle.returnvalues; - + Идентификатор, сгенерированный колонкой с AUTO_INCREMENT последним запросом в случае успешного выполнения, 0, если последний запрос не генерирует значение AUTO_INCREMENT value, и &false;, если соединение MySQL не было установлено. - + @@ -70,7 +70,7 @@ printf("Идентификатор последней вставленной з &reftitle.notes; - + mysql_insert_id конвертирует возвращаемый функцией MySQL C API тип значения функции mysql_insert_id() в тип long (называемый int в PHP). @@ -81,21 +81,21 @@ printf("Идентификатор последней вставленной з максимальных значениях целых чисел смотрите в разделе документации, посвящённом целым числам. - + - + Так как mysql_insert_id работает с последним выполненным запросом, вызывайте mysql_insert_id сразу же после запроса, генерирующего новое значение. - + - + Значение в SQL функции MySQL LAST_INSERT_ID() всегда содержит последний сгенерированный ID и не обнуляется между запросами. - + diff --git a/reference/mysql/functions/mysql-list-dbs.xml b/reference/mysql/functions/mysql-list-dbs.xml index ca2477caf..40e21fd42 100644 --- a/reference/mysql/functions/mysql-list-dbs.xml +++ b/reference/mysql/functions/mysql-list-dbs.xml @@ -1,5 +1,5 @@ - + @@ -22,10 +22,10 @@ resourcemysql_list_dbs resourcelink_identifierNULL - + Возвращает указатель на результат, содержащий список баз данных, доступных на указанном сервере. - + @@ -38,13 +38,13 @@ &reftitle.returnvalues; - + Возвращает resource результата в случае успешного выполнения, или &false; в случае возникновения ошибки. Используйте функцию mysql_tablename, чтобы получить данные из результата, или любую другую функцию, работающую с результатами запросов, например mysql_fetch_array. - + @@ -86,10 +86,10 @@ database3 &reftitle.notes; - + &info.deprecated.alias; mysql_listdbs - + diff --git a/reference/mysql/functions/mysql-list-fields.xml b/reference/mysql/functions/mysql-list-fields.xml index 2da65fdaf..f82610d3e 100644 --- a/reference/mysql/functions/mysql-list-fields.xml +++ b/reference/mysql/functions/mysql-list-fields.xml @@ -1,5 +1,5 @@ - + @@ -24,14 +24,14 @@ stringtable_name resourcelink_identifierNULL - + Возвращает информацию о таблице с переданным именем. - - + + Эта функция устарела. Вместо неё рекомендуется использовать mysql_query с SQL-запросом SHOW COLUMNS FROM table [LIKE 'name']. - + @@ -40,17 +40,17 @@ database_name - + Имя опрашиваемой базы данных. - + table_name - + Имя опрашиваемой таблицы. - + &mysql.linkid.description; @@ -59,17 +59,17 @@ &reftitle.returnvalues; - + Дескриптор результата (resource) в случае успешного выполнения, или &false; в случае возникновения ошибки. - - + + Возвращаемый результат может быть обработан с помощью следующих функций: mysql_field_flags, mysql_field_len, mysql_field_name&listendand; mysql_field_type. - + @@ -121,10 +121,10 @@ Array &reftitle.notes; - + &info.deprecated.alias; mysql_listfields - + diff --git a/reference/mysql/functions/mysql-list-processes.xml b/reference/mysql/functions/mysql-list-processes.xml index f122a89c2..9336e61fe 100644 --- a/reference/mysql/functions/mysql-list-processes.xml +++ b/reference/mysql/functions/mysql-list-processes.xml @@ -1,5 +1,5 @@ - + @@ -22,9 +22,9 @@ resourcefalsemysql_list_processes resourcelink_identifierNULL - + Возвращает список текущих процессов на сервере MySQL. - + @@ -36,9 +36,9 @@ &reftitle.returnvalues; - + Дескриптор результата (resource) в случае успешного выполнения&return.falseforfailure;. - + diff --git a/reference/mysql/functions/mysql-list-tables.xml b/reference/mysql/functions/mysql-list-tables.xml index 62439a743..a549f0b06 100644 --- a/reference/mysql/functions/mysql-list-tables.xml +++ b/reference/mysql/functions/mysql-list-tables.xml @@ -1,5 +1,5 @@ - + @@ -23,14 +23,14 @@ stringdatabase resourcelink_identifierNULL - + Функция возвращает список имён таблиц базы данных MySQL. - - + + Функция устарела. Вместо неё рекомендуют использовать функцию mysql_query с запросом SHOW TABLES [FROM db_name] [LIKE 'pattern']. - + @@ -39,9 +39,9 @@ database - + Имя базы данных. - + &mysql.linkid.description; @@ -50,16 +50,16 @@ &reftitle.returnvalues; - + В случае успешного выполнения функция возвращает дескриптор результата (resource)&return.falseforfailure;. - - + + Для работы с результатом запроса вызывают функцию mysql_tablename или другую функцию, которая умеет это делать, например функцию mysql_fetch_array. - + @@ -101,10 +101,10 @@ mysql_free_result($result); &reftitle.notes; - + &info.deprecated.alias; mysql_listtables - + diff --git a/reference/mysql/functions/mysql-num-fields.xml b/reference/mysql/functions/mysql-num-fields.xml index 030546aa6..28efce9d9 100644 --- a/reference/mysql/functions/mysql-num-fields.xml +++ b/reference/mysql/functions/mysql-num-fields.xml @@ -1,5 +1,5 @@ - + @@ -23,9 +23,9 @@ intfalsemysql_num_fields resourceresult - + Возвращает количество полей в результате запроса. - + @@ -37,10 +37,10 @@ &reftitle.returnvalues; - + Возвращает количество полей в результате запроса (resource) в случае успешного выполнения&return.falseforfailure;. - + @@ -67,10 +67,10 @@ echo mysql_num_fields($result); &reftitle.notes; - + &info.deprecated.alias; mysql_numfields - + diff --git a/reference/mysql/functions/mysql-num-rows.xml b/reference/mysql/functions/mysql-num-rows.xml index e53d8c124..696863fa1 100644 --- a/reference/mysql/functions/mysql-num-rows.xml +++ b/reference/mysql/functions/mysql-num-rows.xml @@ -1,5 +1,5 @@ - + @@ -24,13 +24,13 @@ intfalsemysql_num_rows resourceresult - + Возвращает количество рядов результата запроса. Эта команда работает только с запросами SELECT или SHOW, возвращающих актуальный результат запроса. Чтобы получить количество рядов, обработанных функциями INSERT, UPDATE, REPLACE и DELETE, используйте функцию mysql_affected_rows. - + @@ -42,9 +42,9 @@ &reftitle.returnvalues; - + Количество рядов в результате запроса в случае успешного выполнения&return.falseforfailure;. - + @@ -72,17 +72,17 @@ echo "Получено $num_rows рядов\n"; &reftitle.notes; - + При использовании mysql_unbuffered_query функция mysql_num_rows не вернёт корректного значения до тех пор, пока все ряды не будут получены. - + - + &info.deprecated.alias; mysql_numrows - + diff --git a/reference/mysql/functions/mysql-pconnect.xml b/reference/mysql/functions/mysql-pconnect.xml index e430b6a89..a9f1c8fb9 100644 --- a/reference/mysql/functions/mysql-pconnect.xml +++ b/reference/mysql/functions/mysql-pconnect.xml @@ -1,5 +1,5 @@ - + @@ -36,29 +36,29 @@ intclient_flags --> - + Устанавливает постоянное соединение с сервером MySQL. - + - + mysql_pconnect работает аналогично mysql_connect с двумя важными отличиями. - - + + Во-первых, при соединении функция пытается найти уже открытый (постоянный) указатель на тот же сервер с тем же пользователем и паролем. Если он найден, возвращён функцией будет именно он, вместо открытия нового соединения. - - + + Во-вторых, соединение с SQL-сервером не будет закрыто, когда работа скрипта закончится. Вместо этого, оно останется рабочим для будущего использования (mysql_close также не закрывает постоянные соединения, открытые mysql_pconnect). - - + + Соединения такого типа называют 'постоянными'. - + @@ -67,39 +67,39 @@ server - + Сервер MySQL. Может также включать номер порта, например, "hostname:port" или путь к локальному сокету, например, ":/path/to/socket" для локального хоста. - - + + Если директива mysql.default_host не определена (по умолчанию), то по умолчанию используется значение 'localhost:3306' - + username - + Имя пользователя. По умолчанию используется имя пользователя, владеющего серверным процессом. - + password - + Пароль. По умолчанию используется пустая строка. - + client_flags - + Параметр client_flags может быть комбинацией следующих констант: 128 (включает обработку LOAD DATA LOCAL), @@ -107,7 +107,7 @@ MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE и MYSQL_CLIENT_INTERACTIVE. - + @@ -115,29 +115,29 @@ &reftitle.returnvalues; - + Возвращает дескриптор постоянного соединения MySQL в случае успешного выполнения, и &false; в случае возникновения ошибки. - + &reftitle.notes; - + Учтите, что соединения такого типа работают только, если PHP установлен как модуль. За дополнительной информацией обращайтесь к разделу "Постоянные соединения с базами данных". - + - + Использование постоянных соединений может потребовать некоторой настройки Apache и MySQL. Убедитесь, что вы не превысите максимальное число дозволенных соединений в MySQL. - + diff --git a/reference/mysql/functions/mysql-ping.xml b/reference/mysql/functions/mysql-ping.xml index 06b4cb4d6..d5742d692 100644 --- a/reference/mysql/functions/mysql-ping.xml +++ b/reference/mysql/functions/mysql-ping.xml @@ -1,5 +1,5 @@ - + @@ -22,16 +22,16 @@ boolmysql_ping resourcelink_identifierNULL - + Проверяет работает ли соединение с сервером. Если оно утеряно, автоматически предпринимается попытка пересоединения. Эта функция может быть использована в скриптах, работающих на протяжении долгого времени. - + - + Автоматическое восстановление соединения по умолчанию отключено в версиях MySQL >= 5.0.3. - + @@ -44,10 +44,10 @@ &reftitle.returnvalues; - + Возвращает &true;, если соединение в рабочем состоянии и &false; в противном случае. - + diff --git a/reference/mysql/functions/mysql-query.xml b/reference/mysql/functions/mysql-query.xml index b7d799491..d20e84698 100644 --- a/reference/mysql/functions/mysql-query.xml +++ b/reference/mysql/functions/mysql-query.xml @@ -1,5 +1,5 @@ - + @@ -24,12 +24,12 @@ stringquery resourcelink_identifierNULL - + mysql_query посылает один запрос (посылка нескольких запросов не поддерживается) активной базе данных сервера, на который ссылается переданный дескриптор link_identifier. - + @@ -38,13 +38,13 @@ query - + SQL-запрос - - + + Запрос не должен заканчиваться точкой с запятой. Данные в запросе должны быть корректно проэкранированы. - + &mysql.linkid.description; @@ -53,43 +53,43 @@ &reftitle.returnvalues; - + Для запросов SELECT, SHOW, DESCRIBE, EXPLAIN и других запросов, возвращающих результат из нескольких рядов, mysql_query возвращает дескриптор результата запроса (resource), или &false; в случае возникновения ошибки. - - + + Для других типов SQL-запросов, INSERT, UPDATE, DELETE, DROP и других, mysql_query возвращает &true; в случае успешного выполнения и &false; в случае возникновения ошибки. - - + + Полученный дескриптор результата нужно передать в функцию mysql_fetch_assoc или любую другую функцию, работающую с результатами запросов. - - + + Используйте mysql_num_rows для выяснения количества рядов в результате SELECT-запроса или mysql_affected_rows для выяснения количества обработанных рядов запросами DELETE, INSERT, REPLACE и UPDATE. - - + + mysql_query также завершится с ошибкой и вернёт &false;, если у пользователя нет доступа к какой-либо из таблиц, фигурирующих в запросе. - + &reftitle.examples; Неверный запрос - + Следующий запрос составлен неправильно и mysql_query вернёт &false;. - + Верный запрос - + Следующий запрос верен, поэтому mysql_query вернёт resource. - + - + @@ -24,30 +24,30 @@ stringunescaped_string resourcelink_identifierNULL - + Экранирует специальные символы в unescaped_string, принимая во внимание кодировку соединения, таким образом, что результат можно безопасно использовать в SQL-запросе в функции mysql_query. Если вставляются бинарные данные, то к ним так же необходимо применять эту функцию. - - + + mysql_real_escape_string вызывает библиотечную функцию MySQL mysql_real_escape_string, которая добавляет обратную косую черту к следующим символам: \x00, \n, \r, \, ', " и \x1a. - - + + Эта функция должна всегда (за несколькими исключениями) использоваться для того, чтобы обезопасить данные, вставляемые в запрос перед отправкой его в MySQL. - + Безопасность: кодировка символов по умолчанию - + Кодировка символов должна устанавливаться как на сервере, так и с помощью функции mysql_set_charset, чтобы влиять на поведение mysql_real_escape_string. Подробнее описано в разделе кодировка символов. - + @@ -57,9 +57,9 @@ unescaped_string - + Экранируемая строка. - + &mysql.linkid.description; @@ -68,19 +68,19 @@ &reftitle.returnvalues; - + Возвращает строку, в которой экранированы все необходимые символы, или &false; в случае возникновения ошибки. - + &reftitle.errors; - + Запуск этой функции без существующего соединения с MySQL вызовет ошибку уровня E_WARNING. Данную функцию можно запускать только если есть соединение с MySQL. - + @@ -105,10 +105,10 @@ $query = sprintf("SELECT * FROM users WHERE user='%s' AND password='%s'", Пример использования <function>mysql_real_escape_string</function> без наличия соединения - + Этот пример показывает, что произойдёт, если вызвать эту функцию без наличия соединения с MySQL. - + ]]> - + Запрос, который будет отправлен в MySQL: - + - + Это позволит кому угодно войти в систему без пароля. - + &reftitle.notes; - + Функцию mysql_real_escape_string можно использовать только после того, как установлено соединение с MySQL. В противном случае возникнет ошибка уровня E_WARNING, а функция возвратит &false;. Если link_identifier не указан, используется последнее открытое соединение. - + - + Если не пользоваться этой функцией, то запрос становится уязвимым для взлома с помощью SQL-инъекций. - + diff --git a/reference/mysql/functions/mysql-result.xml b/reference/mysql/functions/mysql-result.xml index 85a43f618..037f60195 100644 --- a/reference/mysql/functions/mysql-result.xml +++ b/reference/mysql/functions/mysql-result.xml @@ -1,5 +1,5 @@ - + @@ -29,10 +29,10 @@ introw mixedfield0 - + Возвращает содержимое одного поля из набора результата MySQL. - - + + Работая с большими результатами запросов, следует использовать одну из функций, обрабатывающих сразу целый ряд результата (указаны ниже). Так как эти функции возвращают значение нескольких ячеек сразу, @@ -40,7 +40,7 @@ Кроме того, учтите, что указание численного смещения работает намного быстрее, чем указание колонки, или колонки с таблицей через точку. - + @@ -50,24 +50,24 @@ row - + Номер получаемого ряда из результата. Нумерация рядов начинается с 0. - + field - + Имя или смещение получаемого поля. - - + + Может быть как смещением поля, именем поля, так и именем поля вместе с таблицей (таблица.поле). Если для поля был указан псевдоним ('select foo as bar from...'), используйте его вместо имени самого поля. Если не указан, возвращается первое поле. - + @@ -75,10 +75,10 @@ &reftitle.returnvalues; - + Содержимое одного поля из набора результата MySQL в случае успешного выполнения, или &false; в случае возникновения ошибки. - + @@ -111,10 +111,10 @@ mysql_close($link); &reftitle.notes; - + Вызовы функции mysql_result не должны смешиваться с другими функциями, работающими с результатом запроса. - + diff --git a/reference/mysql/functions/mysql-select-db.xml b/reference/mysql/functions/mysql-select-db.xml index 1dcb6640a..94bc306b4 100644 --- a/reference/mysql/functions/mysql-select-db.xml +++ b/reference/mysql/functions/mysql-select-db.xml @@ -1,5 +1,5 @@ - + @@ -24,12 +24,12 @@ stringdatabase_name resourcelink_identifierNULL - + Выбирает для работы указанную базу данных на сервере, на который ссылается переданный дескриптор соединения. Каждый последующий вызов функции mysql_query будет работать с выбранной базой данных. - + @@ -38,9 +38,9 @@ database_name - + Имя выбираемой базы данных. - + &mysql.linkid.description; @@ -49,9 +49,9 @@ &reftitle.returnvalues; - + &return.success; - + @@ -81,10 +81,10 @@ if (!$db_selected) { &reftitle.notes; - + &info.deprecated.alias; mysql_selectdb - + diff --git a/reference/mysql/functions/mysql-set-charset.xml b/reference/mysql/functions/mysql-set-charset.xml index 0c750c69e..86d529825 100644 --- a/reference/mysql/functions/mysql-set-charset.xml +++ b/reference/mysql/functions/mysql-set-charset.xml @@ -1,5 +1,5 @@ - + @@ -25,9 +25,9 @@ stringcharset resourcelink_identifierNULL - + Устанавливает кодировку по умолчанию для текущего соединения. - + @@ -36,9 +36,9 @@ charset - + Корректное название кодировки. - + &mysql.linkid.description; @@ -47,26 +47,26 @@ &reftitle.returnvalues; - + &return.success; - + &reftitle.notes; - + Данная функция требует MySQL версии 5.0.7 или выше. - + - + Это наиболее предпочитаемый способ для смены кодировки. Использование mysql_query в этих целях (например SET NAMES utf8) не рекомендуется. Смотрите раздел кодировка символов в MySQL для подробной информации. - + diff --git a/reference/mysql/functions/mysql-stat.xml b/reference/mysql/functions/mysql-stat.xml index e8073bdc2..82d62984d 100644 --- a/reference/mysql/functions/mysql-stat.xml +++ b/reference/mysql/functions/mysql-stat.xml @@ -1,5 +1,5 @@ - + @@ -26,9 +26,9 @@ stringmysql_stat resourcelink_identifierNULL - + mysql_stat возвращает текущий статус сервера. - + @@ -40,7 +40,7 @@ &reftitle.returnvalues; - + Возвращает строку с данными аптайма, количества потоков, запросов, количеством открытых таблиц и таблиц с сброшенным внутренним кешем (flush tables), а также количество запросов в секунду. Для получения @@ -48,7 +48,7 @@ SQL-запрос SHOW STATUS. Если передан некорректный link_identifier, то будет возвращён &null;. - + diff --git a/reference/mysql/functions/mysql-tablename.xml b/reference/mysql/functions/mysql-tablename.xml index 9f20fb72f..ecb8a57b8 100644 --- a/reference/mysql/functions/mysql-tablename.xml +++ b/reference/mysql/functions/mysql-tablename.xml @@ -1,5 +1,5 @@ - + @@ -23,14 +23,14 @@ resourceresult inti - + Возвращает имя таблицы из result. - - + + Данная функция устарела. Вместо неё рекомендуется использование mysql_query с SQL-запросом SHOW TABLES [FROM db_name] [LIKE 'pattern']. - + @@ -39,18 +39,18 @@ result - + Дескриптор результата типа resource, полученный из вызова mysql_list_tables. - + i - + Целочисленный индекс (номер ряда/таблицы) - + @@ -58,15 +58,15 @@ &reftitle.returnvalues; - + Имя таблицы в случае успешного выполнения&return.falseforfailure;. - - + + Используйте функцию mysql_tablename для работы с результатом запроса, либо любую другую функцию, способную это делать, например, mysql_fetch_array. - + @@ -93,10 +93,10 @@ mysql_free_result($result); &reftitle.notes; - + Для определения количества таблиц в результате запроса можно использовать функцию mysql_num_rows. - + diff --git a/reference/mysql/functions/mysql-thread-id.xml b/reference/mysql/functions/mysql-thread-id.xml index 25c311ff7..d8ec81a8a 100644 --- a/reference/mysql/functions/mysql-thread-id.xml +++ b/reference/mysql/functions/mysql-thread-id.xml @@ -1,5 +1,5 @@ - + @@ -22,14 +22,14 @@ intfalsemysql_thread_id resourcelink_identifierNULL - + mysql_thread_id возвращает идентификатор текущего потока. Если соединение потеряно и вы пересоединились с помощью mysql_ping, то идентификатор потока изменится. Это означает, что вам не следует получать данный идентификатор и хранить его для дальнейшего использования. Вызывайте функцию тогда, когда он вам нужен. - + @@ -41,9 +41,9 @@ &reftitle.returnvalues; - + Идентификатор потока в случае успешного выполнения&return.falseforfailure;. - + diff --git a/reference/mysql/functions/mysql-unbuffered-query.xml b/reference/mysql/functions/mysql-unbuffered-query.xml index ff04472bb..58cf7e96f 100644 --- a/reference/mysql/functions/mysql-unbuffered-query.xml +++ b/reference/mysql/functions/mysql-unbuffered-query.xml @@ -1,5 +1,5 @@ - + @@ -23,7 +23,7 @@ stringquery resourcelink_identifierNULL - + mysql_unbuffered_query посылает запрос MySQL query без автоматической обработки и буферизации её результата, в отличие от функции mysql_query. @@ -34,7 +34,7 @@ использовании mysql_unbuffered_query с несколькими соединениями MySQL, вы должны указать необязательный параметр link_identifier. - + @@ -43,13 +43,13 @@ query - + Запускаемый SQL-запрос. - - + + Данные в запросе должны быть корректно проэкранированы. - + &mysql.linkid.description; @@ -58,30 +58,30 @@ &reftitle.returnvalues; - + Для SELECT, SHOW, DESCRIBE и EXPLAIN запросов mysql_unbuffered_query возвращает resource в случае успешного выполнения, или &false; в случае возникновения ошибки. - - + + Для остальных типов SQL-запросов, UPDATE, DELETE, DROP и т.д., mysql_unbuffered_query возвращает &true; в случае успеха и &false; в случае возникновения ошибки. - + &reftitle.notes; - + Однако, плюсы использования mysql_unbuffered_query имеют свою цену: вы не можете использовать функции mysql_num_rows и mysql_data_seek с результатом запроса, возвращённым этой функцией, пока не будут получены все ряды. Кроме того, вы должны будете обработать все ряды запроса до отправки нового запроса, используя тот же link_identifier. - + diff --git a/reference/mysql/ini.xml b/reference/mysql/ini.xml index 63a56f225..596970672 100644 --- a/reference/mysql/ini.xml +++ b/reference/mysql/ini.xml @@ -1,5 +1,5 @@ - +
&reftitle.runtime; @@ -99,10 +99,10 @@ int - + Разрешает доступ к локальным файлам, с точки зрения PHP, с помощью инструкций LOAD DATA - + @@ -112,11 +112,11 @@ bool - + Позволять ли постоянные соединения с MySQL. - + @@ -126,9 +126,9 @@ int - + Максимальное количество постоянных соединений c MySQL на один процесс. - + @@ -138,10 +138,10 @@ int - + Максимальное количество соединений с MySQL на один процесс, включая постоянные соединения. - + @@ -151,12 +151,12 @@ bool - + Режим трассировки. Если включена опция mysql.trace_mode, будут отображаться предупреждения при сканировании таблиц/индексов, непустых результирующих наборов (result sets), а также ошибки SQL. (Добавлено в версии PHP 4.3.0) - + @@ -166,7 +166,7 @@ string - + TCP-порт, используемый для соединения с базой данных по умолчанию (если не был указан другой). Если эта директива опущена, порт будет взят из переменной среды MYSQL_TCP_PORT, значения @@ -174,7 +174,7 @@ или константы MYSQL_PORT, указанной при компиляции, в указанном порядке. Win32 использует только константу MYSQL_PORT. - + @@ -184,10 +184,10 @@ string - + Имя сокета по умолчанию, используемого для соединения с локальной базой данных, если не был указан другой. - + @@ -196,10 +196,10 @@ string - + Адрес сервера по умолчанию, используемый для соединения с сервером базы данных, если не указан другой. Не работает в &sqlsafemode;. - + @@ -209,10 +209,10 @@ string - + Имя пользователя по умолчанию, используемое для соединения с сервером базы данных, если не указано другое. Не работает в &sqlsafemode;. - + @@ -222,10 +222,10 @@ string - + Пароль по умолчанию, используемый для соединения с сервером базы данных, если не указан другой. Не работает в &sqlsafemode;. - + @@ -234,10 +234,10 @@ int - + Время ожидания ответа до разрыва соединения в секундах. Linux также использует это значение при ожидании первого ответа от сервера. - + diff --git a/reference/mysql/reference.xml b/reference/mysql/reference.xml index b6a46a053..16f44c16c 100644 --- a/reference/mysql/reference.xml +++ b/reference/mysql/reference.xml @@ -1,7 +1,7 @@ - - + + Функции СУБД MySQL MySQL @@ -9,7 +9,7 @@
&reftitle.notes; - + Большинство функций MySQL принимают link_identifier как последний, опциональный параметр. Если он не указан, то используется последнее открытое @@ -17,7 +17,7 @@ используя параметры, указанные в &php.ini;. В случае неудачи, функции возвращают &false;. &false;. - +
diff --git a/reference/mysql/setup.xml b/reference/mysql/setup.xml index 336440e11..e0f28140c 100644 --- a/reference/mysql/setup.xml +++ b/reference/mysql/setup.xml @@ -1,16 +1,15 @@ - + - - + &reftitle.setup;
&reftitle.required; - + Для использования этих функций PHP должен быть собран с поддержкой MySQL. - + &mysql.alternative.note; @@ -28,12 +27,12 @@
&reftitle.resources; - + Есть два типа ресурсов, используемых в модуле MySQL. Первый является идентификатором соединения для подключения к базе данных, а второй ресурс содержит результат выполнения запроса. - +