O comportamento destas funções é afetado pelas configurações do php.ini.
| 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_infileintPermite acessar, direto do PHP, arquivos locais com comandos LOAD DATA
mysqli.local_infile_directorystringPermite restringir o carregamento de LOCAL DATA para arquivos localizados neste diretório.
mysqli.allow_persistentintHabilita a possibilidade de criar conexões persistentes usando mysqli_connect().
mysqli.max_persistentintNúmero máximo de conexões simultâneas que podem ser estabelecidas. Definir como 0 para ilimitadas.
mysqli.max_linksintO número máximo de conexões MySQL por processo.
mysqli.default_portint 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_socketstringO 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_hoststringO 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_userstringO nome de usuário padrão para usar ao conectar com o servidor de banco de dados. Não se aplica em
mysqli.default_pwstringA 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.reconnectintReconectar 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.
mysqli.rollback_on_cached_plinkboolSe 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 streams iriam interpretar o valor de MYSQL_OPT_READ_TIMEOUT.