Введение

Расширение позволяет вам работать с СУБД MySQL. За информацией о MySQL обращайтесь к http://www.mysql.com/.

Документация MySQL находится по адресу http://dev.mysql.com/doc/.

Требования

Чтобы работать с функциями, вы должны скомпилировать PHP с поддержкой MySQL.

Установка

Используя директиву --with-mysql[=DIR] вы можете включить в PHP поддержку СУБД MySQL.

В PHP 4, директива --with-mysql включена по умолчанию. Чтобы отключить её, используйте директиву конфигурации --without-mysql. Кроме того, в PHP 4, при включении директивы без указания пути к папке установки MySQL, PHP будет использовать встроенную библиотеку MySQL-клиента. В Windows специальные DLL отсутствуют, клиент всегда встроен в PHP4. При использовании приложений использующих MySQL (к примеру, auth-mysql) не стоит использовать встроенную библиотеку -- укажите путь к папке установки MySQL, что будет выглядеть примерно так: --with-mysql=/path/to/mysql. Это заставит PHP использовать библиотеку, установленную MySQL, что позволит избежать любых конфликтов.

В PHP 5 поддержка MySQL больше не включена по умолчанию, кроме того в нём отсутствует встроенная библиотека-клиент. Подробнее о причине можно прочитать в FAQ.

Расширение работает с MySQL версий >= 4.1.0, но не эксплуатирует всю возможную функциональность этих версий. Для этого используйте MySQLi.

Настройка во время выполнения

Поведение этих функций зависит от установок в php.ini.

За дальнейшей информацией и значениями PHP_INI_* констант обращайтесь к ini_set().

Краткое разъяснение конфигурационных директив.

Типы ресурсов

Модуль MySQL исползует два дополнительных типа указателей. Первый является указателем на соединение с базой данных, второй указывает на ресурс, содержащий результат запроса.

Предопределенные константы

Перечисленные ниже константы определены данным расширением и могут быть доступны только в том случае, если PHP был собран с поддержкой этого расширения или же в том случае, если данное расширение подгружается во время выполнения.

Начиная с PHP 4.3.0 можно указать дополнительные флаги для функций mysql_connect() и mysql_pconnect() functions. Предопределены следующие константы:

Функция mysql_fetch_array() использует константы для определения типа возвращаемого массива. Предопределены следующие константы:

Примеры

Этот пример показывает, как соединиться с базой данных, выполнить запрос, распечатать результат и отсоединиться.

Пример 1. Пример работы с MySQL <?php      /* Соединяемся, выбираем базу данных */      $link = mysql_connect("mysql_host", "mysql_user", "mysql_password")          or die("Could not connect : " . mysql_error());      print "Connected successfully";      mysql_select_db("my_database") or die("Could not select database");      /* Выполняем SQL-запрос */      $query = "SELECT * FROM my_table";      $result = mysql_query($query) or die("Query failed : " . mysql_error());      /* Выводим результаты в html */      print "<table>\n";      while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {          print "\t<tr>\n";          foreach ($line as $col_value) {              print "\t\t<td>$col_value</td>\n";          }          print "\t</tr>\n";      }      print "</table>\n";      /* Освобождаем память от результата */      mysql_free_result($result);      /* Закрываем соединение */      mysql_close($link); ?>