sqlsrv_configure
Altera as configurações de opções de registro em log e de tratamento de erros.
Sintaxe
sqlsrv_configure( string $setting, mixed $value )
Parâmetros
$setting: o nome da configuração a ser alterada. Veja na tabela abaixo uma lista de configurações.
$value: o valor a ser aplicado à configuração especificada no parâmetro $setting . Os valores possíveis para esse parâmetro dependem da configuração especificada. A tabela a seguir apresenta as possíveis combinações:
| Setting | Valores possíveis para o parâmetro $value (inteiro equivalente entre parênteses) | Valor padrão |
|---|---|---|
| ClientBufferMaxKBSize1 | Um número não negativo até o limite de memória do PHP. Zero e números negativos não são permitidos. |
10240 KB |
| LogSeverity2 | SQLSRV_LOG_SEVERITY_ALL (-1) SQLSRV_LOG_SEVERITY_ERROR (1) SQLSRV_LOG_SEVERITY_NOTICE (4) SQLSRV_LOG_SEVERITY_WARNING (2) |
SQLSRV_LOG_SEVERITY_ERROR (1) |
| LogSubsystems2 | SQLSRV_LOG_SYSTEM_ALL (-1) SQLSRV_LOG_SYSTEM_CONN (2) SQLSRV_LOG_SYSTEM_INIT (1) SQLSRV_LOG_SYSTEM_OFF (0) SQLSRV_LOG_SYSTEM_STMT (4) SQLSRV_LOG_SYSTEM_UTIL (8) |
SQLSRV_LOG_SYSTEM_OFF (0) |
| WarningsReturnAsErrors3 | true (1) ou false (0) | true (1) |
Valor de retorno
Se sqlsrv_configure for chamado com uma configuração ou valor sem suporte, a função retornará false. Caso contrário, a função retornará true.
Comentários
(1) Para saber mais sobre as consultas do lado do cliente, confira Tipos de cursor (SQLSRV Driver).
(2) Para saber mais sobre o registro de atividades em log, confira Logging Activity.
(3) Para obter mais informações sobre a configuração do tratamento de erros e avisos, confira Como: configurar o tratamento de erro e de avisos usando o driver SQLSRV.
Consulte Também
Referência da API do driver SQLSRV
Guia de programação do Microsoft Drivers para PHP para SQL Server