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

NomePadrãoModificá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);

?>

Índice
msql_affected_rows -- Retorna o número de registros afetados pela última consulta
msql_close -- Fecha uma conexão mSQL
msql_connect -- Abre uma conexão mSQL
msql_create_db -- Cria um banco de dados mSQL
msql_createdb -- Apelido para msql_create_db()
msql_data_seek -- Move o ponteiro interno dos registros
msql_db_query -- Send mSQL query
msql_dbname -- Retorna o nome do banco de dados mSQL atual
msql_drop_db -- Exclui um banco de dados mSQL
msql_error -- Retorna a mensagem de erro da última chamada a msql
msql_fetch_array -- Obtém um registro como uma matriz
msql_fetch_field -- Retorna informação sobre um campo
msql_fetch_object -- Obtem uma linha como um objeto
msql_fetch_row -- Retorna uma linha como uma matriz numerada
msql_field_flags -- Get field flags
msql_field_len -- Get field length
msql_field_name -- Get field name
msql_field_seek -- Estabelece o índice do campo
msql_field_table -- Get table name for field
msql_field_type -- Get field type
msql_fieldflags -- Apelido para msql_field_flags()
msql_fieldlen -- Apelido para msql_field_len()
msql_fieldname -- Apelido para msql_field_name()
msql_fieldtable -- Apelido para msql_field_table()
msql_fieldtype -- Apelido para msql_field_type()
msql_free_result -- Libera o resultado de uma consulta da memória
msql_list_dbs -- Lista os banco de dados mSQL no servidor
msql_list_fields -- Lista os campos de uma tabela
msql_list_tables -- Lista as tabelas em um banco de dados mSQL
msql_num_fields -- Retorna o número de campos em um resultado
msql_num_rows -- Retorna o número de registros em um resultado
msql_numfields -- Apelido para msql_num_fields()
msql_numrows -- Alias of msql_num_rows()
msql_pconnect -- Abre uma conexão mSQL persistente
msql_query -- Envia uma consulta
msql_regcase -- Apelido para sql_regcase()
msql_result -- Retorna dados do resultado
msql_select_db -- Seleciona um banco de dados mSQL
msql_tablename -- Alias of msql_result()
msql -- Apelido para msql_db_query()