21.9.2.1. Установка/Конфигурирование

21.9.2.1.1. Требования

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

21.9.2.1.2. Установка

Для того, чтобы скомпилировать, просто используйте --with-mysql[=DIR] параметр конфигурации, где дополнительное [DIR] точки к каталогу установки MySQL.

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

Если требуется установить mysql расширение наряду с mysqli расширением, необходимо пользоваться той же самой клиентской библиотекой, чтобы избежать любых конфликтов.

21.9.2.1.2.1. Установка на Системах Linux

Отметьте: [DIR] путь к клиентским файлам библиотеки MySQL (заголовки и библиотеки), который может быть загружен с MySQL.

Таблица 21.37. время компиляции ext/mysql поддерживает матрицу

Версия PHP	Значение по умолчанию	Сконфигурируйте Опции: mysqlnd	Сконфигурируйте Опции: `libmysqlclient`	Журнал изменений
4.x.x	libmysqlclient	Не Доступный	`--without-mysql` отключить	MySQL, включенный по умолчанию, клиентские библиотеки MySQL связываются
5.0.x, 5.1.x, 5.2.x	libmysqlclient	Не Доступный	`--with-mysql=[DIR]`	MySQL больше не включается по умолчанию, и клиентские библиотеки MySQL являются связанным nolonger
5.3.x	libmysqlclient	`--with-mysql=mysqlnd`	`--with-mysql=[DIR]`	mysqlnd теперь доступен
5.4.x	mysqlnd	`--with-mysql`	`--with-mysql=[DIR]`	mysqlnd является теперь значением по умолчанию

21.9.2.1.2.2. Установка на Windows Systems

21.9.2.1.2.2.1. PHP 4

Расширение MySQL PHP компилируется в PHP.

21.9.2.1.2.2.2. PHP 5.0.x, 5.1.x, 5.2.x

MySQL больше не включается по умолчанию, таким образом, php_mysql.dll DLL должен быть включен в php.ini. Кроме того, PHP нуждается в доступе к клиентской библиотеке MySQL. Файл называют libmysql.dll включается в распределение Windows PHP и для PHP, чтобы говорить с MySQL, этот файл должен быть доступным системам Windows PATH. См. FAQ, названный, "Как делают я добавляю свой каталог PHP к PATH на Windows" для информации о том, как сделать это. Хотя копируя libmysql.dll к системному каталогу Windows также работает (потому что системный каталог находится по умолчанию в системе PATH), это не рекомендуется.

Как с включением любому расширению PHP (такой как php_mysql.dll), направляющий extension_dir PHP должен быть установлен в каталог, где расширения PHP располагаются. См. также Инструкции по установке Windows Manual. Пример extension_dir значение для PHP 5 c:\php\ext

Отметить

Если, запуская веб-сервер ошибка, подобная следующему, происходит: "Unable to load dynamic library './php_mysql.dll'", это то, потому что php_mysql.dll и/или libmysql.dll не может быть найден системой.

21.9.2.1.2.2.3. PHP 5.3.0 +

MySQL Native Driver включается по умолчанию. Включать php_mysql.dll, но libmysql.dll больше не требуется или используется.

21.9.2.1.2.3. MySQL Installation Notes

Предупреждение

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

Отметить

Если Вы нуждаетесь в наборах символов кроме латыни (значение по умолчанию), необходимо установить внешний (не связанный) libmysqlclient со скомпилированной поддержкой набора символов.

21.9.2.1.3. Конфигурация времени выполнения

На поведение этих функций влияют настройки в php.ini.

Таблица 21.38. MySQL Configuration Options

Имя	Значение по умолчанию	Изменчивый	Журнал изменений
mysql.allow_local_infile	"1"	PHP_INI_SYSTEM
mysql.allow_persistent	"1"	PHP_INI_SYSTEM
mysql.max_persistent	"-1"	PHP_INI_SYSTEM
mysql.max_links	"-1"	PHP_INI_SYSTEM
mysql.trace_mode	"0"	PHP_INI_ALL	Доступный начиная с PHP 4.3.0.
mysql.default_port	НУЛЬ	PHP_INI_ALL
mysql.default_socket	НУЛЬ	PHP_INI_ALL	Доступный начиная с PHP 4.0.1.
mysql.default_host	НУЛЬ	PHP_INI_ALL
mysql.default_user	НУЛЬ	PHP_INI_ALL
mysql.default_password	НУЛЬ	PHP_INI_ALL
mysql.connect_timeout	"60"	PHP_INI_ALL	PHP_INI_SYSTEM в PHP <= 4.3.2. Доступный начиная с PHP 4.3.0.

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

mysql.allow_local_infile целое число: Позвольте получать доступ, с точки зрения PHP, локальных файлов с операторами LOAD DATA
mysql.allow_persistent булев: Позволить ли персистентные соединения с MySQL.
mysql.max_persistent целое число: Максимальное количество персистентных соединений MySQL для каждого процесса.
mysql.max_links целое число: Максимальное количество соединений MySQL для каждого процесса, включая персистентные соединения.
mysql.trace_mode булев: Режим трассировки. Когда mysql.trace_mode включается, предупреждения для представляют в виде таблицы/индексируют сканирования, не свободные наборы результатов, и Ошибки SQL будут выведены на экран. (Представленный в PHP 4.3.0)
mysql.default_port строка: Номер порта TCP значения по умолчанию, чтобы использовать, соединяясь с сервером базы данных, если никакой другой порт не определяется. Если никакое значение по умолчанию не будет определено, то порт будет получен из MYSQL_TCP_PORT переменная окружения, mysql-tcp запись в /etc/services или время компиляции MYSQL_PORT постоянный, в том порядке. Win32 будет только использовать MYSQL_PORT постоянный.
mysql.default_socket строка: Сокет значения по умолчанию называет, чтобы использовать, соединяясь с локальным сервером базы данных, если никакое другое имя сокета не определяется.
mysql.default_host строка: Сервер значения по умолчанию размещает, чтобы использовать, соединяясь с сервером базы данных, если никакой другой узел не определяется. Не применяется в безопасном режиме SQL.
mysql.default_user строка: Имя пользователя значения по умолчанию, чтобы использовать, соединяясь с сервером базы данных, если никакое другое имя не определяется. Не применяется в безопасном режиме SQL.
mysql.default_password строка: Пароль значения по умолчанию, чтобы использовать, соединяясь с сервером базы данных, если никакой другой пароль не определяется. Не применяется в безопасном режиме SQL.
mysql.connect_timeout целое число: Соедините тайм-аут в секундах. На Linux этот тайм-аут также используется для того, чтобы ожидать первого ответа от сервера.

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

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