Constantes pré-definidas
As contantes 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çõesLOAD 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 dewait_timeout
segundos) de inatividade antes de fechar a conexão. A variávelwait_timeout
da sessão do cliente será definida para o valor da variávelinteractive_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 contante é usada para copiar resultados
do buffer interno do
mysqlnd
para as variáveis PHP buscadas. Por padrão, omysqlnd
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 commysqlnd
. 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 colunasNULL
ouAUTO_INCREMENT
porque tais colunas têm um valor padrão deNULL
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
ouNUMERIC
. -
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
ouBINARY
. -
MYSQLI_TYPE_CHAR
(int) -
O campo é definido como
TINYINT
. ParaCHAR
, vejaMYSQLI_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_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
-
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.