array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mysqli.configuration.php', 1 => 'Configurações em Execução', 2 => 'Configurações em Execução', ), 'up' => array ( 0 => 'mysqli.setup.php', 1 => 'Instalação/Configuração', ), 'prev' => array ( 0 => 'mysqli.installation.php', 1 => 'Instalação', ), 'next' => array ( 0 => 'mysqli.persistconns.php', 1 => 'A extensão mysqli e conexões persistentes', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysqli/ini.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Configurações em Execução

O comportamento destas funções é afetado pelas configurações do php.ini.

Opções de configuração do MySQLi
Nome Padrão Modificável Registro de Alterações
mysqli.allow_local_infile "0" INI_SYSTEM Antes do PHP 7.2.16 e 7.3.3 o padrão era "1".
mysqli.local_infile_directory   INI_SYSTEM Disponível desde o 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 Removido no PHP 8.2.0
mysqli.rollback_on_cached_plink "0" INI_SYSTEM  

Para maiores detalhes e definições das constantes INI_* acima, veja o capítulo sobre mudanças de configuração.

Aqui está uma breve explicação das diretivas de configuração.

mysqli.allow_local_infile bool

Permite acessar, direto do PHP, arquivos locais com comandos LOAD DATA

mysqli.local_infile_directory string

Permite restringir o carregamento de LOCAL DATA para arquivos localizados neste diretório.

mysqli.allow_persistent bool

Habilita a possibilidade de criar conexões persistentes usando mysqli_connect().

mysqli.max_persistent int

Número máximo de conexões simultâneas que podem ser estabelecidas. Definir como 0 para ilimitadas.

O número máximo de conexões MySQL por processo.

mysqli.default_port int

O número da porta TCP padrão para usar ao conectar ao servidor de banco de dados se não for especificada outra porta. Se não for especificado um padrão, então a porta será obtida da variável de ambiênte MYSQL_TCP_PORT, a entrada mysql-tcp em /etc/services ou a constante em tempo de compilação MYSQL_PORT, nesta ordem. Em Win32 será usada apenas a constante MYSQL_PORT.

mysqli.default_socket string

O nome padrão do socket para usar ao conectar com um servidor de banco de dados local, se não for especificado outro nome de socket.

mysqli.default_host string

O servidor padrão para usar ao conectar com o servidor de banco de dados se não for especificado um servidor. Não se aplica em

mysqli.default_user string

O nome de usuário padrão para usar ao conectar com o servidor de banco de dados. Não se aplica em

mysqli.default_pw string

A senha padrão para usar ao conectar ao servidor de banco de dados se não for especificado outra senha. Não se aplica em

mysqli.reconnect int

Reconectar automaticamente ao perder a conexão.

Nota: Esta configuração do php.ini é ignorada pelo driver mysqlnd, e foi removida no PHP 8.2.0.

Se essa opção for ativada, o fechamento de uma conexão persistente fará o rollback de todas as transações pendentes dessa conexão antes que ela seja colocada de volta no pool de conexão persistente. Caso contrário, as transações pendentes serão revertidas apenas quando a conexão for reutilizada ou quando for realmente fechada.

Usuários não podem modificar MYSQL_OPT_READ_TIMEOUT via chamada de API ou configuração em tempo de execução. Note que se fosse possível haveria diferenças entre como a libmysqlclient e os fluxos iriam interpretar o valor de MYSQL_OPT_READ_TIMEOUT.