array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'mysqli.configuration.php', 1 => 'Настройка во время выполнения', 2 => 'Настройка во время выполнения', ), 'up' => array ( 0 => 'mysqli.setup.php', 1 => 'Установка и настройка', ), 'prev' => array ( 0 => 'mysqli.installation.php', 1 => 'Установка', ), 'next' => array ( 0 => 'mysqli.persistconns.php', 1 => 'Модуль mysqli и постоянные соединения', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mysqli/ini.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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

Параметры конфигурации MySQLi
Имя По умолчанию Место изменения Список изменений
mysqli.allow_local_infile "0" INI_SYSTEM До PHP 7.2.16 и 7.3.3 значение по умолчанию равнялось "1".
mysqli.local_infile_directory   INI_SYSTEM Доступно с PHP 8.1.0.
mysqli.allow_persistent "1" INI_SYSTEM  
mysqli.max_persistent "-1" INI_SYSTEM  
mysqli.max_links "-1" INI_SYSTEM  
mysqli.default_port "3306" INI_ALL  
mysqli.default_socket NULL INI_ALL  
mysqli.default_host NULL INI_ALL  
mysqli.default_user NULL INI_ALL  
mysqli.default_pw NULL INI_ALL  
mysqli.reconnect "0" INI_SYSTEM Опцию удалили с PHP 8.2.0
mysqli.rollback_on_cached_plink "0" INI_SYSTEM  

Другие детали и определения констант семейства INI_* приводит раздел об изменениях конфигурации.

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

mysqli.allow_local_infile bool

Разрешает доступ к локальным с точки зрения PHP файлам через инструкции LOAD DATA.

mysqli.local_infile_directory string

Разрешает ограничить загрузку LOAD DATA файлами, которые лежат в заданном каталоге.

mysqli.allow_persistent int

Включает возможность создавать постоянные соединения функцией mysqli_connect().

mysqli.max_persistent int

Максимальное количество постоянных соединений. Для неограниченного количества устанавливают значение 0.

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

mysqli.default_port int

TCP-порт по умолчанию для соединения с сервером баз данных, если другое значение явно не указали. PHP получит значение в следующем порядке: из переменной среды окружения 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.reconnect int

Автоматически восстанавливать соединение при его потере.

Замечание: Драйвер "mysqlnd" игнорирует настройку и её удалили в PHP 8.2.0.

Если этот параметр включён, закрытие постоянного соединения откатит любые ожидающие транзакции этого соединения, прежде чем оно будет возвращено в пул постоянных соединений. В противном случае ожидающие соединения будут откатываться только тогда, когда соединение будет повторно использовано или когда оно будет фактически закрыто.

Пользователям нельзя устанавливать значение MYSQL_OPT_READ_TIMEOUT через API-вызовов или установку конфигурационных значений во время работы скрипта. Обратите внимание, что если бы установку разрешили, библиотека libmysqlclient и потоки по-разному обрабатывали бы значение MYSQL_OPT_READ_TIMEOUT.