[edit] Last updated: Mon, 01 Nov 2010

XCI. 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);



?>

Í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 the name of the specified field in a result
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()

add a note User Contributed Notes mSQL

acroyear at io dot com 15-May-2000 02:11


To those porting code from w3-msql/lite to php, a few functions are different or missing (aside from the fact that the order of arguments is reversed and the other signatures are different...not good design work, imho, or was it built for msql 1.x?  At any rate, conformity with the C and Lite API should have been maintained.).





The lite/C function msqlStoreResult() is automatically done in msql_query() and msql().  


msql_fetch_field() doesn't give you the field length value (unlike msqlFetchField()).  You have to call msql_fieldlen() to get that.





msqlEncode() is missing.  The functionality (which is needed for pretty much ALL SQL based rdbms's) is in addSlashes() in the String library.

add a note