Constantes predefinidas

As constantes abaixo são definidas por esta extensão e só estarão disponíveis quando a extensão tiver sido compilada no PHP ou tiver sido carregada dinamicamente em tempo de execução.

MYSQLI_READ_DEFAULT_GROUP (int)

Lê opções do grupo nomeado em my.cnf ou no arquivo especificado com MYSQLI_READ_DEFAULT_FILE.

MYSQLI_READ_DEFAULT_FILE (int)

Lê opções do arquivo de opções informado ao invés de my.cnf.

MYSQLI_OPT_CAN_HANDLE_EXPIRED_PASSWORDS (int)

Indica ao servidor que o cliente consegue lidar com o modo "caixa de areia" para senhas expiradas. Pode ser usada com mysqli_options().

MYSQLI_OPT_LOAD_DATA_LOCAL_DIR (int)

Se habilitada, esta opção especifica o diretório a partid do qual o carregamento de dados LOCAL no lado do cliente é permitido em instruções LOAD DATA LOCAL.

MYSQLI_OPT_CONNECT_TIMEOUT (int)

Limite de tempo de conexão em segundos.

MYSQLI_OPT_READ_TIMEOUT (int)

Limite de tempo do resultado da execução do comando, em segundos. Disponível a partir do PHP 7.2.0.

MYSQLI_OPT_LOCAL_INFILE (int)

Habilita o comando LOAD LOCAL INFILE.

MYSQLI_OPT_INT_AND_FLOAT_NATIVE (int)

Converte colunas de inteiros e floats de volta para números PHP. Válido apenas para mysqlnd.

MYSQLI_OPT_NET_CMD_BUFFER_SIZE (int)

O tamanho do buffer interno de comando/rede. Válido apenas para mysqlnd.

MYSQLI_OPT_NET_READ_BUFFER_SIZE (int)

Máximo tamanho de porção de leitura em bytes ao ler o corpo de um pacote de comando MySQL. Válido apenas para mysqlnd.

MYSQLI_OPT_SSL_VERIFY_SERVER_CERT (int)

MYSQLI_INIT_COMMAND (int)

Comando a executar ao se conectar ao servidor MySQL. Será automaticamente re-executado na reconexão.

MYSQLI_CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS (int)

Indica ao servidor que o cliente consegue lidaro com o modo "caixa de areia" para senhas expiradas. Pode ser usada com mysqli_real_connect().

MYSQLI_CLIENT_FOUND_ROWS (int)

Retorna o número de linhas correspondentes, e não o número de linhas afetadas.

MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT (int)

Verifica o certificado do servidor.

MYSQLI_CLIENT_SSL (int)

Usa SSL (protocolo criptografado). Esta opção não deve ser definida por aplicações; ela é definida internamente na biblioteca cliente MySQL.

MYSQLI_CLIENT_COMPRESS (int)

Usa protocolo de compressão.

MYSQLI_CLIENT_INTERACTIVE (int)

Permite interactive_timeout segundos (ao invés de wait_timeout segundos) de inatividade antes de fechar a conexão. A variável wait_timeout da sessão do cliente será definida para o valor da variável interactive_timeout da sessão.

MYSQLI_CLIENT_IGNORE_SPACE (int)

Permite espaços depois de nomes de função. Considera todos os nomes de função como palavras reservadas.

MYSQLI_CLIENT_NO_SCHEMA (int)

Não permite a sintaxe db_name.tbl_name.col_name.

MYSQLI_CLIENT_MULTI_QUERIES

Permite múltiplas consultas separadas por ponto-e-vírgula em uma única chamada a mysqli_query().

MYSQLI_STORE_RESULT (int)

Para uso em conjuntos de resultados com buffer. Tem o valor de 0.

MYSQLI_STORE_RESULT_COPY_DATA (int)

A partir do PHP 8.1, esta constante não tem mais efeito. Antes do PHP 8.1, esta constante é usada para copiar resultados do buffer interno do mysqlnd para as variáveis PHP buscadas. Por padrão, o mysqlnd usará uma lógica de referência para evitar de copiar e duplicar os resultados mantidos em memória. Para certos resultados, por exemplo para conjuntos com muitas linhas pequenas, o método de cópia pode reduzir o uso total de memória porque as variáveis do PHP que mantêm o resultado podem ser liberadas mais cedo. Disponível somente com mysqlnd. Descontinuada a partir do PHP 8.4.0.

MYSQLI_USE_RESULT (int)

Para uso em conjuntos de resultados sem buffer. Tem o valor de 1.

MYSQLI_ASSOC (int)

Colunas são retornadas no array com os nomes dos campos nas chaves.

MYSQLI_NUM (int)

Colunas são retornadas no array com índices enumerados.

MYSQLI_BOTH (int)

Colunas são retornadas no array com índice tanto numérico quanto com nomes dos campos.

MYSQLI_NOT_NULL_FLAG (int)

Indica que um campo é definido como NOT NULL.

MYSQLI_PRI_KEY_FLAG (int)

O campo é parte de um índice primário.

MYSQLI_UNIQUE_KEY_FLAG (int)

O campo é parte de um índice exclusivo.

MYSQLI_MULTIPLE_KEY_FLAG (int)

O campo é parte de um índice.

MYSQLI_BLOB_FLAG (int)

O campo é definido como BLOB.

MYSQLI_UNSIGNED_FLAG (int)

O campo é definido como UNSIGNED.

MYSQLI_ZEROFILL_FLAG (int)

O campo é definido como ZEROFILL.

MYSQLI_AUTO_INCREMENT_FLAG (int)

O campo é definido como AUTO_INCREMENT.

MYSQLI_TIMESTAMP_FLAG (int)

O campo é definido como TIMESTAMP.

MYSQLI_SET_FLAG (int)

O campo é definido como SET.

MYSQLI_NUM_FLAG (int)

O campo é definido como NUMERIC.

MYSQLI_PART_KEY_FLAG (int)

O campo é parte de um multi-índice.

MYSQLI_GROUP_FLAG (int)

O campo é parte de GROUP BY.

MYSQLI_NO_DEFAULT_VALUE_FLAG (int)

Uma coluna não tem cláusula DEFAULT em sua definição. Isto não se aplica a colunas NULL ou AUTO_INCREMENT porque tais colunas têm um valor padrão de NULL e um valor padrão implícito, respectivamente.

MYSQLI_TYPE_DECIMAL (int)

O campo é definido como DECIMAL.

MYSQLI_TYPE_NEWDECIMAL (int)

Campo de precisão matemática DECIMAL ou NUMERIC.

MYSQLI_TYPE_BIT (int)

O campo é definido como BIT.

MYSQLI_TYPE_TINY (int)

O campo é definido como TINYINT.

MYSQLI_TYPE_SHORT (int)

O campo é definido como SMALLINT.

MYSQLI_TYPE_LONG (int)

O campo é definido como INT.

MYSQLI_TYPE_FLOAT (int)

O campo é definido como FLOAT.

MYSQLI_TYPE_DOUBLE (int)

O campo é definido como DOUBLE.

MYSQLI_TYPE_NULL (int)

O campo é definido como DEFAULT NULL.

MYSQLI_TYPE_TIMESTAMP (int)

O campo é definido como TIMESTAMP.

MYSQLI_TYPE_LONGLONG (int)

O campo é definido como BIGINT.

MYSQLI_TYPE_INT24 (int)

O campo é definido como MEDIUMINT.

MYSQLI_TYPE_DATE (int)

O campo é definido como DATE.

MYSQLI_TYPE_TIME (int)

O campo é definido como TIME.

MYSQLI_TYPE_DATETIME (int)

O campo é definido como DATETIME.

MYSQLI_TYPE_YEAR (int)

O campo é definido como YEAR.

MYSQLI_TYPE_NEWDATE (int)

O campo é definido como DATE.

MYSQLI_TYPE_INTERVAL (int)

Sinônimo de MYSQLI_TYPE_ENUM. Removida a partir do PHP 8.4.0.

MYSQLI_TYPE_ENUM (int)

O campo é definido como ENUM.

MYSQLI_TYPE_SET (int)

O campo é definido como SET.

MYSQLI_TYPE_TINY_BLOB (int)

O campo é definido como TINYBLOB.

MYSQLI_TYPE_MEDIUM_BLOB (int)

O campo é definido como MEDIUMBLOB.

MYSQLI_TYPE_LONG_BLOB (int)

O campo é definido como LONGBLOB.

MYSQLI_TYPE_BLOB (int)

O campo é definido como BLOB.

MYSQLI_TYPE_VAR_STRING (int)

O campo é definido como VARCHAR.

MYSQLI_TYPE_STRING (int)

O campo é definido como CHAR ou BINARY.

MYSQLI_TYPE_CHAR (int)

O campo é definido como TINYINT. Para CHAR, veja MYSQLI_TYPE_STRING.

MYSQLI_TYPE_GEOMETRY (int)

O campo é definido como GEOMETRY

MYSQLI_TYPE_JSON (int)

O campo é definido como JSON. Válido apenas para mysqlnd e MySQL 5.7.8 ou acima.

MYSQLI_TYPE_VECTOR (int)

O campo é definido como VECTOR.

MYSQLI_NEED_DATA

Há mais dados disponíveis para vincular a variáveis.

MYSQLI_ENUM_FLAG (int)

O campo é definido como ENUM.

MYSQLI_BINARY_FLAG (int)

O campo é definido como BINARY.

MYSQLI_CURSOR_TYPE_FOR_UPDATE (int)

Removida a partir do PHP 8.4.0.

MYSQLI_CURSOR_TYPE_NO_CURSOR (int)

MYSQLI_CURSOR_TYPE_READ_ONLY (int)

MYSQLI_CURSOR_TYPE_SCROLLABLE (int)

Removida a partir do PHP 8.4.0.

MYSQLI_STMT_ATTR_CURSOR_TYPE (int)

MYSQLI_STMT_ATTR_PREFETCH_ROWS (int)

Removida a partir do PHP 8.4.0.

MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH (int)

MYSQLI_SET_CHARSET_NAME (int)

MYSQLI_REPORT_INDEX (int)

Reporta se nenhum índice ou um índice ruim foi usado em uma consulta.

MYSQLI_REPORT_ERROR (int)

Reporta erros de chamadas a funções mysqli.

MYSQLI_REPORT_STRICT (int)

Lança uma exceção mysqli_sql_exception para erros ao invés de gerar alertas.

MYSQLI_REPORT_ALL (int)

Define todas as opções ligadas (reportar tudo).

MYSQLI_REPORT_OFF (int)

Desliga a reportagem de erros.

MYSQLI_DEBUG_TRACE_ENABLED (int)

É definido para 1 se a funcionalidade mysqli_debug() estiver habilitada.

MYSQLI_SERVER_PUBLIC_KEY (int)

MYSQLI_REFRESH_GRANT (int)

Atualiza a tabela de permissões. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_LOG (int)

Descarrega os registros, como na execução da declaração SQL FLUSH LOGS. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_TABLES (int)

Descarrega o cache de tabelas, como na execução da declaração SQL FLUSH TABLES. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_HOSTS (int)

Descarrega o cache de servidores, como na execução da declaração SQL FLUSH HOSTS. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_REPLICA (int)

Apelido da constante MYSQLI_REFRESH_SLAVE. Disponível a partir do PHP 8.1.0. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_STATUS (int)

Redefine as variáveis de estado, como na execução da declaração SQL FLUSH STATUS. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_THREADS (int)

Descarrega o cache de threads. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_SLAVE (int)

Em um servidor de replicação escravo: redefine a informação do servidor principal, e reinicia o escravo. É como executar a declaração SQL RESET SLAVE. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_MASTER (int)

Em um servidor de replicação principal: remove os arquivos de registro binários listados no índice de registro binário, e trunca o arquivo de índice. É como executar a declaração SQL RESET MASTER. Descontinuada a partir do PHP 8.4.0.

MYSQLI_REFRESH_BACKUP_LOG (int)

Fecha e reabre os arquivos de registro reservas. Descontinuada a partir do PHP 8.4.0.

MYSQLI_TRANS_COR_AND_CHAIN (int)

Adiciona "AND CHAIN" a mysqli_commit() ou mysqli_rollback().

MYSQLI_TRANS_COR_AND_NO_CHAIN (int)

Adiciona "AND NO CHAIN" a mysqli_commit() ou mysqli_rollback().

MYSQLI_TRANS_COR_RELEASE (int)

Adiciona "RELEASE" a mysqli_commit() ou mysqli_rollback().

MYSQLI_TRANS_COR_NO_RELEASE (int)

Adiciona "NO RELEASE" a mysqli_commit() ou mysqli_rollback().

MYSQLI_TRANS_START_READ_ONLY (int)

Inicia a transação como em "START TRANSACTION READ ONLY" com mysqli_begin_transaction().

MYSQLI_TRANS_START_READ_WRITE (int)

Inicia a transação como em "START TRANSACTION READ WRITE" com mysqli_begin_transaction().

MYSQLI_TRANS_START_WITH_CONSISTENT_SNAPSHOT (int)

Inicia a transação como em "START TRANSACTION WITH CONSISTENT SNAPSHOT".

MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT (int)

Requer MySQL 5.6.5 e acima.

MYSQLI_IS_MARIADB (bool)

Informa se a extensão mysqli foi construída com uma biblioteca cliente MariaDB. Disponível a partir do PHP 8.1.2.

MYSQLI_ASYNC (int)

A consulta é realizada de forma assíncrona e nenhum resultado é retornado imediatamente. Disponível somente com mysqlnd.

MYSQLI_ON_UPDATE_NOW_FLAG (int)

Se um campo for atualizado é obtido o valor do horário atual.