Расширение 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.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_* констант смотрите в разделе конфигурационные изменения.
Краткое разъяснение конфигурационных директив.
- mysqli.max_links integer
-
Максимальное число соединений 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-выражения