Spec-Zone .ru
спецификации, руководства, описания, API

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

Copyright 1997-2012 PHP Documentation Group.

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

Copyright 1997-2012 PHP Documentation Group.

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

21.9.2.1.2. Установка

Copyright 1997-2012 PHP Documentation Group.

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

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

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

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

Copyright 1997-2012 PHP Documentation Group.

Отметьте: [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

Copyright 1997-2012 PHP Documentation Group.

21.9.2.1.2.2.1. PHP 4

Copyright 1997-2012 PHP Documentation Group.

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

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

Copyright 1997-2012 PHP Documentation Group.

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 +

Copyright 1997-2012 PHP Documentation Group.

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

21.9.2.1.2.3. MySQL Installation Notes

Copyright 1997-2012 PHP Documentation Group.

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

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

Отметить

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

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

Copyright 1997-2012 PHP Documentation Group.

На поведение этих функций влияют настройки в 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. Типы ресурсов

Copyright 1997-2012 PHP Documentation Group.

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