11111
<p>Функции СУБД MySQL
<p><a href="function.muscat-setup.html">Пред.</a>
<p><a href="function.mysql-affected-rows.html">След.</a><A NAME="ref.mysql"></a>
<h1>LXXXII. Функции СУБД MySQL</h1>
<p><A NAME="AEN95100"></a>
<h1><A NAME="mysql.intro">Введение</a></h1>
<p>- Расширение позволяет вам работать с СУБД MySQL. За информацией о MySQL обращайтесь к <a href="http://www.mysql.com/">http://www.mysql.com/</a>.
<p>- Документация MySQL находится по адресу <a href="http://dev.mysql.com/doc/">http://dev.mysql.com/doc/</a>.
<h1><A NAME="mysql.requirements">Требования</a></h1>
<p>- Чтобы работать с функциями, вы должны скомпилировать PHP с поддержкой MySQL.
<h1><A NAME="mysql.installation">Установка</a></h1>
<p>- Используя директиву --with-mysql[=DIR] вы можете включить в PHP поддержку СУБД MySQL.
<p>- В PHP4, директива --with-mysql включена по умолчанию. Чтобы отключить её, используйте директиву конфигурации --without-mysql. Кроме того, в PHP4, при включении директивы без указания пути к папке установки MySQL, PHP будет использовать встроенную библиотеку MySQL-клиента. В Windows специальные DLL отсутствуют, клиент всегда встроен в PHP4. При использовании приложений использующих MySQL (к примеру, auth-mysql) не стоит использовать встроенную библиотеку -- укажите путь к папке установки MySQL, что будет выглядеть примерно так: --with-mysql=/path/to/mysql. Это заставит PHP использовать библиотеку, установленную MySQL, что позволит избежать любых конфликтов.
<p>- В PHP5 поддержка MySQL больше не включена по умолчанию, кроме того в нём отсутствует встроенная библиотека-клиент. Подробнее о причине можно прочитать в <a href="faq.databases.html#faq.databases.mysql.php5">- FAQ</a>.
<p>- Расширение работает с MySQL версий >= 4.1.0, но не эксплуатирует всю возможную функциональность этих версий. Для этого используйте <a href="ref.mysqli.html">MySQLi</a>.
<table>
<tr><td>Внимание
<tr><td>- Сбои в работе PHP могут иметь место при загрузке совместно этого расширения и расширения для работы с библиотекой GNU Recode. За дополнительной информацией обращайтесь к разделу о расширении для <a href="ref.recode.html">recode</a>.
</table>
<p>Замечание: Если вам требуется поддержка кодировок (отличных от latin, установленной по умолчанию), вам придётся установить внешнюю библиотеку, скомпилированную с их поддержкой.
<h1><A NAME="mysql.configuration">Настройка во время выполнения</a></h1>
<p>-Поведение этих функций зависит от установок в php.ini.
<p><A NAME="AEN95137"></a>
<p>Таблица 1. Директивы конфигурации MySQL
<table>
<tr><th>Имя<th>Значение по умолчанию<th>Область изменения
<tr><td>mysql.allow_persistent<td>"On"<td>PHP_INI_SYSTEM
<tr><td>mysql.max_persistent<td>"-1"<td>PHP_INI_SYSTEM
<tr><td>mysql.max_links<td>"-1"<td>PHP_INI_SYSTEM
<tr><td>mysql.default_port<td>NULL<td>PHP_INI_ALL
<tr><td>mysql.default_socket<td>NULL<td>PHP_INI_ALL
<tr><td>mysql.default_host<td>NULL<td>PHP_INI_ALL
<tr><td>mysql.default_user<td>NULL<td>PHP_INI_ALL
<tr><td>mysql.default_password<td>NULL<td>PHP_INI_ALL
<tr><td>mysql.connect_timeout<td>"0"<td>PHP_INI_SYSTEM
</table>
<p>За дальнейшей информацией и значениями PHP_INI_* констант обращайтесь к <a href="function.ini-set.html">ini_set()</a>.
<p>Краткое разъяснение конфигурационных
<p>директив.
<p><A NAME="ini.mysql.allow-persistent"></a>mysql.allow_persistent логическое
<p>- Позволять ли <a href="features.persistent-connections.html">постоянные соединения</a> с MySQL.
<p><A NAME="ini.mysql.max-persistent"></a>mysql.max_persistent целое
<p>Максимальное количество постоянных соединений на 1 процесс.
<p><A NAME="ini.mysql.max-links"></a>mysql.max_links целое
<p>- Максимальное количество соединений с MySQL на 1 процесс, включая постоянные соединения.
<p><A NAME="ini.mysql.default-port"></a>mysql.default_port строка
<p>- TCP-порт, используемый для соединения с базой данных по умолчанию (если не был указан другой). Если эта директива опущена, порт будет взят из переменной среды MYSQL_TCP_PORT, значения mysql-tcp в /etc/services или константы MYSQL_PORT, указанной при компиляции, в указанном порядке. Win32 использует только константу MYSQL_PORT.
<p><A NAME="ini.mysql.default-socket"></a>mysql.default_socket строка
<p>- Тип сокета, используемого для соединения с локальной базой данных, если не был указан другой.
<p><A NAME="ini.mysql.default-host"></a>mysql.default_host строка
<p>- Адрес сервера, используемый для соединения с базой данных, если не указан другой. Не работает в <a href="features.safe-mode.html#ini.safe-mode">безопасном режиме</a>.
<p><A NAME="ini.mysql.default-user"></a>mysql.default_user строка
<p>- Имя пользователя, используемое для соединения с базой данных, если не указано другое. Не работает в <a href="features.safe-mode.html#ini.safe-mode">безопасном режиме</a>.
<p><A NAME="ini.mysql.default-password"></a>mysql.default_password строка
<p>- Пароль, используемый для соединения с базой данных, если не указан другой. Не работает в <a href="features.safe-mode.html#ini.safe-mode">безопасном режиме</a>.
<p><A NAME="ini.mysql.connect-timeout"></a>mysql.connect_timeout целое
<p>- Время ожидания овета до разрыва соединения в секундах. Linux также использует это значение при ожидании первого ответа от сервера.
<h1><A NAME="mysql.resources">Типы ресурсов</a></h1>
<p>- Модуль MySQL исползует два дополнительных типа указателей. 1-й является указателем на соединение с базой данных, второй указывает на ресурс, содержащий результат запроса.
<h1><A NAME="mysql.constants">Предопределенные константы</a></h1>
<p>-Перечисленные ниже константы определены данным расширением и могут быть
<p>доступны только в том случае, если PHP был собран с
<p>поддержкой этого расширения или же в том случае, если
<p>данное расширение подгружается во время выполнения.
<p>- Начиная с PHP4.3.0 можно указать дополнительные флаги для функций <a href="function.mysql-connect.html">mysql_connect()</a> и <a href="function.mysql-pconnect.html">mysql_pconnect()</a> functions. Предопределены следующие константы:
<p><A NAME="AEN95258"></a>
<p>Таблица 2. MySQL константы
<table>
<tr><th>константа<th>описание
<tr><td>MYSQL_CLIENT_COMPRESS<td>использовать протокол сжатия
<tr><td>MYSQL_CLIENT_IGNORE_SPACE<td>Позволяет вставлять пробелы после имён функций
<tr><td>MYSQL_CLIENT_INTERACTIVE<td>Ждать interactive_timeout секунд (виесто wait_timeout) бездействия, до закрытия соединения.
</table>
<p>- Функция <a href="function.mysql-fetch-array.html">mysql_fetch_array()</a> использует константы для определения типа возвращаемого массива. Предопределены следующие константы:
<p><A NAME="AEN95277"></a>
<p>Таблица 3. Константы выборки MySQL
<table>
<tr><th>константа<th>описание
<tr><td>MYSQL_ASSOC<td>- Результат возвращается в ассоциативном массиве с индексами под именами колонок.
<tr><td>MYSQL_BOTH<td>- Результат возвращается в массиве, содержащем как численные индексы, так и индексы под именами колонок.
<tr><td>MYSQL_NUM<td>- Результат возвращается в массиве, содержащем численные индексы. Индексы стартуют с 0 (0 содержит первую колонку).
</table>
<h1><A NAME="mysql.examples">Примеры</a></h1>
<p>- Этот пример показывает, как соединиться с базой данных, выполнить запрос, распечатать результат и отсоединиться.
<table>
<tr><td><A NAME="AEN95297"></a>
<p>Пример 1. Пример работы с MySQL
<table>
<tr><td><code>
<p>&lt;?
<p>/*Соединяемся, выбираем базу данных*/
<p>$link = mysql_connect("mysql_host", "mysql_user", "mysql_password")
<p>or die("Could not connect : " . mysql_error());
<p>print "Connected successfully";
<p>mysql_select_db("my_database") or die("Could not select database");
<p>/*Выполняем SQL-запрос*/
<p>$query = "SELECT * FROM my_table";
<p>$result = mysql_query($query) or die("Query failed : " . mysql_error());
<p>/*Выводим результаты в html*/
<p>print "&lt;table>\n";
<p>while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {
<p>print "\t&lt;tr>\n";
<p>foreach ($line as $col_value) {
<p>print "\t\t&lt;td>$col_value&lt;/td>\n";
<p>}
<p>print "\t&lt;/tr>\n";
<p>}
<p>print "&lt;/table>\n";
<p>/*Освобождаем память от результата*/
<p>mysql_free_result($result);
<p>/*Закрываем соединение*/
<p>mysql_close($link);
<p>?>
</code>
</table>
</table>
<p>Содержание
<p><a href="function.mysql-affected-rows.html">mysql_affected_rows</a> -- Возвращает число затронуиых прошлой операцией рядов.
<p><a href="function.mysql-change-user.html">mysql_change_user</a> -- Изменяет пользователя для указанного соединения.
<p><a href="function.mysql-client-encoding.html">mysql_client_encoding</a> -- Возвращает кодировку соединения
<p><a href="function.mysql-close.html">mysql_close</a> -- Закрывает соединение с сервером MySQL
<p><a href="function.mysql-connect.html">mysql_connect</a> -- Открывает соединение с сервером MySQL
<p><a href="function.mysql-create-db.html">mysql_create_db</a> -- Создаёт базу данных MySQL
<p><a href="function.mysql-data-seek.html">mysql_data_seek</a> -- Перемещает внутренний указатель в результате запроса
<p><a href="function.mysql-db-name.html">mysql_db_name</a> -- Возвращает название базы данных
<p><a href="function.mysql-db-query.html">mysql_db_query</a> -- Переключается к указанной базе данных и посылает запрос
<p><a href="function.mysql-drop-db.html">mysql_drop_db</a> -- Уничтожает базу данных MySQL
<p><a href="function.mysql-errno.html">mysql_errno</a> -- Возвращает численный код ошибки выполнения последней операции с MySQL
<p><a href="function.mysql-error.html">mysql_error</a> -- Возвращает строку ошибки последней операции с MySQL.
<p><a href="function.mysql-escape-string.html">mysql_escape_string</a> -- Экранирует SQL спец-символы для mysql_query.
<p><a href="function.mysql-fetch-array.html">mysql_fetch_array</a> -- Обрабатывает ряд результата запроса, возвращая ассоциативный массив, численный массив или оба.
<p><a href="function.mysql-fetch-assoc.html">mysql_fetch_assoc</a> -- Обрабатывает ряд результата запроса и возвращает ассоциативный массив.
<p><a href="function.mysql-fetch-field.html">mysql_fetch_field</a> -- Возвращает информацию о колонке из результата запроса в виде объекта.
<p><a href="function.mysql-fetch-lengths.html">mysql_fetch_lengths</a> -- Возвращает длину каждого поля в результате.
<p><a href="function.mysql-fetch-object.html">mysql_fetch_object</a> -- Обрабатывает ряд результата запроса и возвращает объект
<p><a href="function.mysql-fetch-row.html">mysql_fetch_row</a> -- Орабатывает ряд результата запроса и возвращает неассоциативный массив.
<p><a href="function.mysql-field-flags.html">mysql_field_flags</a> -- Возвращает флаги указанного поля результата запроса.
<p><a href="function.mysql-field-len.html">mysql_field_len</a> -- Возвращает длину указанного поля.
<p><a href="function.mysql-field-name.html">mysql_field_name</a> -- Возвращает название указанной колонки результата запроса.
<p><a href="function.mysql-field-seek.html">mysql_field_seek</a> -- Устанавливает внутренний указатель поля на переданное смещение.
<p><a href="function.mysql-field-table.html">mysql_field_table</a> -- Возвращает название таблицы, которой принадлежит указанное поле.
<p><a href="function.mysql-field-type.html">mysql_field_type</a> -- Возвращает тип указанного поля результата запроса.
<p><a href="function.mysql-free-result.html">mysql_free_result</a> -- Освобождает память от результата запроса
<p><a href="function.mysql-get-client-info.html">mysql_get_client_info</a> -- Возвращает данные о MySQL-клиенте
<p><a href="function.mysql-get-host-info.html">mysql_get_host_info</a> -- Возвращает информацию о соединении с MySQL
<p><a href="function.mysql-get-proto-info.html">mysql_get_proto_info</a> -- Возвращает информацию о протоколе MySQL
<p><a href="function.mysql-get-server-info.html">mysql_get_server_info</a> -- Возвращает информацию о сервере MySQL
<p><a href="function.mysql-info.html">mysql_info</a> -- Возвращает информацию о последнем запросе
<p><a href="function.mysql-insert-id.html">mysql_insert_id</a> -- Возвращает ID, сгенерированный при последнем INSERT-запросе.
<p><a href="function.mysql-list-dbs.html">mysql_list_dbs</a> -- Возвращает список баз данных, доступных на сервере.
<p><a href="function.mysql-list-fields.html">mysql_list_fields</a> -- Возвращает список колонок таблицы
<p><a href="function.mysql-list-processes.html">mysql_list_processes</a> -- Возвращает список процессов MySQL
<p><a href="function.mysql-list-tables.html">mysql_list_tables</a> -- Возвращает список таблиц базы данных MySQL
<p><a href="function.mysql-num-fields.html">mysql_num_fields</a> -- Возвращает количество полей результата запроса
<p><a href="function.mysql-num-rows.html">mysql_num_rows</a> -- Возвращает количество рядов результата запроса
<p><a href="function.mysql-pconnect.html">mysql_pconnect</a> -- Устанавливает постоянное соединение с сервером MySQL.
<p><a href="function.mysql-ping.html">mysql_ping</a> -- Проверяет соединение с сервером и пересоединяется при необходимости
<p><a href="function.mysql-query.html">mysql_query</a> -- Посылает запрос MySQL
<p><a href="function.mysql-real-escape-string.html">mysql_real_escape_string</a> -- Экранирует специальные символы в строке, используемой в SQL-запросе, принмимая во внимание кодировку соединения.
<p><a href="function.mysql-result.html">mysql_result</a> -- Возвращает данные результата запроса
<p><a href="function.mysql-select-db.html">mysql_select_db</a> -- Выбирает базу данных MySQL
<p><a href="function.mysql-stat.html">mysql_stat</a> -- Возвращает текущий статус сервера
<p><a href="function.mysql-tablename.html">mysql_tablename</a> -- Возвращает имя таблицы, содержащей указанное поле
<p><a href="function.mysql-thread-id.html">mysql_thread_id</a> -- Возвращает ID текущего потока
<p><a href="function.mysql-unbuffered-query.html">mysql_unbuffered_query</a> -- Посылает MySQL SQL-запрос без авто-обработки результата и её буфферизации.
<p><a href="function.muscat-setup.html">Пред.</a>
<p><a href="index.html">Начало</a>
<p><a href="function.mysql-affected-rows.html">След.</a>
<p>muscat_setup
<p><a href="funcref.html">Уровень выше</a>
<p>mysql_affected_rows
22222
<div style="text-align:right;position:fixed;bottom:3px;right:3px;width:100%;z-index:999999;cursor:pointer;line-height:0;display:block;"><a target="_blank" href="https://www.freewebhostingarea.com" title="Free Web Hosting with PHP5 or PHP7"><img alt="Free Web Hosting" src="https://www.freewebhostingarea.com/images/poweredby.png" style="border-width: 0px;width: 180px; height: 45px; float: right;"></a></div>