Manual do PHP
Anterior |  | Próxima

# LXXVI. mSQL

# Introdução

Estas funções permitem acessar servidores de banco de dados mSQL. Maiores informações sobre o mSQL podem ser encontradas em http://www.hughes.com.au/.

# Instalação

Para ter estas funções disponíveis, você deve compilar o PHP com suporte ao msql usando a opção --with-msql[=DIR]. DIR é o diretório base da instalação do msql, cujo padrão é `/usr/local/msql3`.

> Nota para os usuários de Note to Win32 Users: Para ativar este módulo no ambiente Windows, você deve copiar `msql.dll` apartir da pasta DLL do pacote PHP/Win32 para a pasta SYSTEM32 no seu computador com windows. (Ex: `C:\WINNT\SYSTEM32` ou `C:\WINDOWS\SYSTEM32`)

# Configurações em execução

O comportamento dessas funções podem ser modificado pelas configurações do `php.ini`.

Tabela 1. Opções de configuração do mSQL

Nome | Padrão | Modificável
--- | --- | ---
msql.allow_persistent | "On" | PHP_INI_SYSTEM
msql.max_persistent | "-1" | PHP_INI_SYSTEM
msql.max_links | "-1" | PHP_INI_SYSTEM

Para maiores detalhes e definições das constantes PHP_INI_* veja ini_set().

Breve descrição das diretivas de configuração.

msql.allow_persistent boolean

  Quando permitir conexões persistentes mSQL.

msql.max_persistent integer

  O número máximo de conexões persistentes mSQL por processo.

msql.max_links integer

  O número máximo de conexões mSQL por processo, incluindo as conexões persistentes.

# Tipos Resource

Existem dois tipos de recursos usados no módulo mSQL. O primeiro é o identificador de conexão para a conexão com o banco de dados, e o segundo é um recurso que guarda o resultado de uma consulta.

# 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.

`MSQL_ASSOC` (integer)

`MSQL_NUM` (integer)

`MSQL_BOTH` (integer)

# Exemplos

Este exemplo simples mostra como conectar, realizar uma consulta, mostrar as linhas do resultado e disconectar do banco de dados mSQL.

Exemplo 1. Exemplo de uso do mSQL
`<?php /* Conectando, selecionando o banco de dados */ $link = msql_connect('localhost', 'username', 'password') or die('Could not connect : ' . msql_error($link)); msql_select_db('database') or die('Could not select database', $link); /* Realizando a consulta SQL */ $query = 'SELECT * FROM my_table'; $result = msql_query($query, $link) or die('Query failed : ' . msql_error($link)); /* Mostrando os resultados em HTML */ echo "<table>\n"; while ($row = msql_fetch_array($result, MSQL_ASSOC)) { echo "\t<tr>\n"; foreach ($row as $col_value) { echo "\t\t<td>$col_value</td>\n"; } echo "\t</tr>\n"; } echo "</table>\n"; /* Liberando o conjunto de resultados */ msql_free_result($result); /* Fecha a conexão */ msql_close($link); ?>`

Anterior | Principal | Próxima
msession_unlock | Acima | msql_affected_rows