Microsoft SQL Server
Introdução
Estas funções permitem a você acessar um banco de dados do MS SQL Server.
Dependências
Requerimentos para as plataformas Win32.
A extensão requer que as ferramentas de cliente do MS SQL sejam instaladas no sistema onde o PHP esta instalado. As ferramentas de cliene podem ser instaladas apartir do CD do MS SQL Server ou copiando ntwdblib.dll de \winnt\system32 da máquina do servidor \winnt\system32 na máquina do PHP. Copiar ntwdblib.dll irá somente prover acesso através de named pipes. Configuração do cliente irá requerer a instalação de todas as ferramentas.
Requerimentos para as plataformas Unix/Linux.
Para usar a extensão MSSQL no Unix/Linux, você primeiramente precisa compilar e instalar a biblioteca FreeTDS. Código fonte e instruções de instalação estão disponíveis na página de FreeTDS: » https://www.freetds.org/
Nota: No Windows, é usado a DBLIB da Microsoft. Funções que retornam um nome de coluna estão baseadas na função dbcolname() na DBLIB. DBLIB foi desenvolvida para o SQL Server 6.x aonde o limite do identificador é 30. Por esta razão, o limite de tamanho da coluna é 30 caracteres. Nas plataformas onde o FreeTDS é usado(Linux), isto não é um problema.
Instalação
A extensão MSSQL é ativada se adicionando extension=php_mssql.dll no php.ini.
Para que estas funções funcionem, você tem que compilar o PHP com --with-mssql[=DIR], aonde DIR é o diretório de instalação do FreeTDS. E FreeTDS deve ser compilado usando --enable-msdblib.
Configurações em execução
O comportamento dessas funções podem ser modificado pelas configurações do php.ini.
| Nome | Padrão | Modificável | Changelog |
|---|---|---|---|
| mssql.allow_persistent | "1" | PHP_INI_SYSTEM | |
| mssql.max_persistent | "-1" | PHP_INI_SYSTEM | |
| mssql.max_links | "-1" | PHP_INI_SYSTEM | |
| mssql.min_error_severity | "10" | PHP_INI_ALL | |
| mssql.min_message_severity | "10" | PHP_INI_ALL | |
| mssql.compatability_mode | "0" | PHP_INI_ALL | |
| mssql.connect_timeout | "5" | PHP_INI_ALL | |
| mssql.timeout | "60" | PHP_INI_ALL | Disponível desde o PHP 4.1.0. |
| mssql.textsize | "-1" | PHP_INI_ALL | |
| mssql.textlimit | "-1" | PHP_INI_ALL | |
| mssql.batchsize | "0" | PHP_INI_ALL | Disponível desde o PHP 4.0.4. |
| mssql.datetimeconvert | "1" | PHP_INI_ALL | Disponível desde o PHP 4.2.0. |
| mssql.secure_connection | "0" | PHP_INI_SYSTEM | Disponível desde o PHP 4.3.0. |
| mssql.max_procs | "-1" | PHP_INI_ALL | Disponível desde o PHP 4.3.0. |
Tipos Resource
Constantes pré-definidas
As contantes abaixo são definidas por esta extensão e somente estarão disponíveis quando a extensão foi compilada com o PHP ou carregada dinamicamente durante a execução.
Índice
- mssql_bind — Adiciona um parâmetro a um stored procedure ou a um remote stored procedure
- mssql_close — Fecha a conexão com o servidor MS SQL
- mssql_connect — Abre uma conexão com o servidor MS SQL
- mssql_data_seek — Move o ponteiro interno da linha
- mssql_execute — Executa uma stored procedure num banco de dados de um servidor MS SQL
- mssql_fetch_array — Retorna uma linha como uma matriz associativa, matriz numérica ou ambas
- mssql_fetch_assoc — Retorna uma matriz associativa da linha atual do conjunto de resultados especificado por result_id
- mssql_fetch_batch — Retorna o próximo lote de registros
- mssql_fetch_field — Retorna informação sobre o campo
- mssql_fetch_object — Devolve a linha como um objeto
- mssql_fetch_row — Retorna uma matriz enumerada
- mssql_field_length — Retorna o tamanho de um campo
- mssql_field_name — Retorna o nome de um campo
- mssql_field_seek — Estabelece o índice do campo
- mssql_field_type — Retorna o tipo de um campo
- mssql_free_result — Limpa o resultado da memória
- mssql_free_statement — Libera comando da memória
- mssql_get_last_message — Retorna a ultima mensagem do servidor
- mssql_guid_string — Converte um 16 byte binary GUID para uma string
- mssql_init — Inicializa um stored procedure ou um remote stored procedure
- mssql_min_error_severity — Estabelece a menor severidade a erros
- mssql_min_message_severity — Estabelece a menor severidade a mensagens
- mssql_next_result — Move o ponteiro interno do resultado para o próximo resultado
- mssql_num_fields — Retorna o número de campos em um resultado
- mssql_num_rows — Retorna o número de linhas em um resultado
- mssql_pconnect — Abre uma conexão persistente com MS SQL
- mssql_query — Envia uma query ao MS SQL
- mssql_result — Retorna dados do resultado
- mssql_rows_affected — Retorna o número de registros afetados pela query
- mssql_select_db — Seleciona um banco de dados do MS SQL