PDO::setAttribute — Definir atributos (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
bool PDO::setAttribute (int $atributo, misto $valor)
Defina as propriedades do identificador do banco de dados. Algumas das propriedades comuns disponíveis estão listadas abaixo. Alguns drivers podem usar propriedades específicas adicionais.
PDO::ATTR_CASE : Força os nomes das colunas para o caso especificado.
PDO::CASE_LOWER : Força os nomes das colunas para letras minúsculas.
PDO::CASE_NATURAL : Preserva os nomes das colunas retornados pelo driver do banco de dados.
PDO::CASE_UPPER : Força os nomes das colunas a ficarem em letras maiúsculas.
PDO::ATTR_ERRMODE : relatório de erros.
PDO::ERRMODE_SILENT : Define apenas o código do erro.
PDO::ERRMODE_WARNING : gera um erro E_WARNING
PDO::ERRMODE_EXCEPTION : lança exceções .
PDO::ATTR_ORACLE_NULLS (disponível em todos os drivers, não limitado ao Oracle): Converte strings NULL e vazias.
PDO::NULL_NATURAL : Sem conversão.
PDO::NULL_EMPTY_STRING : Converte string vazia em NULL
.
PDO::NULL_TO_STRING : Converte NULL em uma string vazia.
PDO::ATTR_STRINGIFY_FETCHES : Converte valores em strings ao extrair. Requer bool .
PDO::ATTR_STATEMENT_CLASS : Define a classe de instrução fornecida pelo usuário derivada de PDOStatement. Não pode ser usado com instâncias persistentes de PDO. Requer array(string nome da classe, array(parâmetros de construtor misto)) .
PDO::ATTR_TIMEOUT : Especifica o número de segundos para o tempo limite. Nem todos os drivers suportam esta opção, o que significa que pode haver diferenças de driver para driver. Por exemplo, o SQLite espera por esse valor antes de desistir de adquirir um bloqueio gravável, mas outros drivers podem interpretar esse valor como um intervalo de tempo limite de conexão ou leitura. Requer tipo int.
PDO::ATTR_AUTOCOMMIT (disponível em OCI, Firebird e MySQL): Se deve submeter automaticamente cada instrução individual.
PDO::ATTR_EMULATE_PREPARES habilita ou desabilita a emulação de instruções preparadas. Alguns drivers não têm suporte ou têm suporte limitado para pré-processamento local. Use esta configuração para forçar o PDO a sempre emular instruções preparadas (se TRUE
) ou tente usar instruções nativas preparadas (se FALSE
). Se o driver não conseguir preparar com êxito a consulta atual, ele sempre recorrerá à simulação de instruções preparadas. Requer tipo bool .
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY (disponível no MySQL): Use consultas em buffer.
PDO::ATTR_DEFAULT_FETCH_MODE : Define o modo de busca padrão. Uma descrição do modo pode ser encontrada na documentação do PDOStatement::fetch() .
Retorna TRUE em caso de sucesso ou FALSE em caso de falha.