Forum und email
Справочник функций
PHP Manual

Расширение MySQL (Improved)

Введение

Расширение mysqli позволяет вам получить доступ к функциональности, которую предоставляет MySQL версии 4.1 и выше. Больше информации о сервере баз данных MySQL вы можете получить по адресу » https://www.mysql.com/.

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

Некоторые части данной документации включены из руководства по MySQL с разрешения MySQL AB.

Требования

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

Note: Расширение mysqli разработано для работы с MySQL версии 4.1.3 и выше. Для работы с более старыми версиями, обратитесь к документации к расширению MySQL.

Установка

Для установки расширения mysqli для PHP, используйте конфигурационную директиву --with-mysqli=mysql_config_path/mysql_config, гдеmysql_config_path - путь к утилите mysql_config, которая поставляется с MySQL версии 4.1 и больше.

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

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

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

MySQLi Параметры конфигурации
Имя Значение по-умолчанию Область изменения История изменений
mysqli.max_links "-1" PHP_INI_SYSTEM Доступен начиная с PHP 5.0.0.
mysqli.default_port "3306" PHP_INI_ALL Доступен начиная с PHP 5.0.0.
mysqli.default_socket NULL PHP_INI_ALL Доступен начиная с 5.0.0.
mysqli.default_host NULL PHP_INI_ALL Доступен начиная с PHP 5.0.0.
mysqli.default_user NULL PHP_INI_ALL Доступен начиная с PHP 5.0.0.
mysqli.default_pw NULL PHP_INI_ALL Доступен начиная с PHP 5.0.0.

Дальнейшие детали и определения PHP_INI_* констант смотрите в разделе конфигурационные изменения.

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

Максимальное число соединений MySQL на процесс.

mysqli.default_port string

TCP порт, используемый по умолчанию для соединения с сервером баз данных если другое значение явно не указано. Если значение по умолчанию не указано, оно будет получено из переменной среды окружения MYSQL_TCP_PORT, директивы mysql-tcp в файле /etc/services или константы MYSQL_PORT, которая задаётся во время компиляции, в указанном порядке. Win32 использует только константу MYSQL_PORT.

mysqli.default_socket string

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

mysqli.default_host string

Имя сервера, которое используется если имя не было указано явно. Это имя не используется в безопасном режиме.

mysqli.default_user string

Имя пользователя по умолчанию, используемое если имя не было указано явно. Игнорируется в безопасном режиме.

mysqli.default_pw string

Пароль по умолчанию, используемый если пароль не был явно указан. Игнорируется в безопасном режиме.

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

mysqli

Представляет соединение между PHP и базой данных MySQL.

Конструктор

  • mysqli - конструктор нового объекта mysqli

Методы

  • autocommit - включает или выключает автофиксацию изменений базы данных

  • change_user - изменение пользователя для выбранного соединения с базой данных

  • character_set_name - возвращает кодировку по-умолчанию (default character set) для соединения с базой данных

  • close - закрывает открытое ранее соединение

  • commit - фиксирует текущую транзакцию

  • connect - открывает новое соединение с сервером баз данных MySQL

  • debug - выполняет операции по отладке

  • dump_debug_info - возвращает отладочную информацию

  • get_client_info - возвращает версию клиента

  • get_host_info - возвращает используемый тип соединения

  • get_server_info - возвращает информацию о сервере MySQL

  • get_server_version - возвращает версию сервера MySQL

  • init - инициализирует объект mysqli

  • info - получает информацию о последнем выполненном запросе

  • kill - требует от сервера убить mysql-поток

  • multi_query - выполняет множественный запрос

  • more_results - проверяет наличие дополнительных результатов в выполняемом мульти-запросе

  • next_result - получает следующий результат в выполняемом мульти-запросе

  • options - устанавливает опции

  • ping - проверяет соединение с сервером или переподключается, если соединение недоступно

  • prepare - подготавливает SQL-запрос

  • query - выполняет запрос

  • real_connect - создает соединение с сервером MySQL

  • escape_string - экранирует спецсимволы в строке для использования в SQL-выражениях

  • rollback - откат текущей транзакции

  • select_db - выбирает базу данных по-умолчанию

  • set_charset - устанавливает кодировку клиента по-умолчанию

  • ssl_set - устанавливает параметры ssl

  • stat - получает текущее состояние системы

  • stmt_init - инициализирует выражение для использования с mysqli_stmt_prepare

  • store_result - получает набор данных от последнего запроса

  • thread_safe - возвращает информацию о том, собран ли клиент с поддеркой надежных потоков

  • use_result - получает небуферизованный набор данных из последнего запроса

Свойства

  • affected_rows - получает количество затронутых рядов предыдущей MySQL-операцией

  • client_info - возвращает версию MySQL-клиента в виде строки

  • client_version - возвращает версию MySQL-клиента в целочисленном виде

  • errno - возвращает номер ошибки для последнего вызова функции

  • error - возвращает строку, содержащую текст ошибки для последнего вызова функции

  • field_count - возвращает количество колонок в последней выборке

  • host_info - возвращает строку с представлением используемого типа соединения

  • info - возвращает информацию о последнем выполненном запросе

  • insert_id - возвращает автоматически созданный id, использованый в последнем запросе

  • protocol_version - возвращает версию использованного протокола MySQL

  • server_info - возвращает строку, которая содержит номер версии сервера

  • server_version - возвращает целочисленный номер версии сервера

  • sqlstate - возвращает строку, содержащую код ошибки SQLSTATE для последней ошибки

  • thread_id - возвращает ID потока для текущего соединения

  • warning_count - возвращает количество предупреждений (warnings), сгенерированных во время выполнения последнего SQL-выражения

mysqli_stmt