Version: 1.0 – Release
Type: Class
Category: Databases
License: Artistic License
Description: Classe de manipulao de banco de dados MySQL via PHP
<?PHP
/*
=====================================================================
dbMySQL Class
=====================================================================
Nome:
dbMySQL Class - Classe de Conexo e Manipulao de dados
Autor:
Rodrigo do N Maciel <[email protected]>
Descricao:
Classe documentada de manipulacao de dados com MySQL
Referencia de todas as funcoes PHP4/MySQL
Uso:
Salve todo esse cdigo (juntamente com este cabealho)
em um arquivo chamado * class.dbMySQl.php * e o inclua
em seu diretrio de include_path ou na raiz de seu site.
*** No final do arquivo encontra-se um exemplo de como
efetuar uma Conexo/Consulta com esta classe.
Report Bug:
Por favor, reporte qualquer bugs encontrado para meu endereo de
e-Mail : [email protected].
Se voce criar um Fix/Patch para este bug, envie para o e-Mail
citado acima, para que eu possa incorporar neste script e com os
devidos crditos.
Historico da Versao:
1.0 03/08/2004 - Release Inicial
=====================================================================
Copyright (C) 2004 Rodrigo do N Maciel
=====================================================================
*/
/**
* @desc Classe dbMySQL
* Metodos de acesso ao MySQL
*
* @author Rodrigo do N maciel <[email protected]>
* @copyright Copyright (C) 2004 Rodrigo do N Maciel
*
* @package kernel
* @subpackage core
*/
class dbMySQL{
var $result;
/**
* @desc Abre um link no host como o usurio especificado com a senha.
*
* @param string $hostname Hostname do MySQL
* @param string $username Usurio do MySQL
* @param string $password Senha do Usurio do MySQL
*
* @return resource
*/
function Connect($hostname, $username, $password){
$this->hostname = $hostname;
$this->username = $username;
$this->password = $password;
return @mysql_connect($this->hostname, $this->username, $this->password) or die(mysql_errno());
}
/**
* @desc Abre uma conexo persistente com o banco de dados. Todos os argumentos so opcionais.
* Tenha cuidado - mysql_close e o trmino do script no fecharo a conexo.
*
* @param string $hostname Hostname do MySQL
* @param string $username Usurio do MySQL
* @param string $password Senha do Usurio do MySQL
*
* @return resource
*/
function pConnect($hostname, $username, $password){
$this->hostname = $hostname;
$this->username = $username;
$this->password = $password;
return @mysql_pconnect($this->hostname, $this->username, $this->password) or die(mysql_errno());
}
/**
* @desc Cria um novo Banco de Dados MySQL no host associado com o link aberto mais prximo.
*
* @param string $database Banco de Dados
*
* @return bool
*/
function dbCreate($database){
$this->database = $database;
return @mysql_create_db($this->database, $this->link_id);
}
/**
* @desc Seleciona um novo Banco de Dados MySQL no host associado.
*
* @param string $database Banco de Dados
*
* @return bool
*/
function dbSelect($database){
$this->database = $database;
return @mysql_select_db($this->database);
}
/**
* @desc Exclui ("dropa") o banco de dados MySQL especificado.
*
* @param string $database Banco de Dados
* @param resource $conexao Resource #ID da Conexao
*
* @return bool
*/
function dbDrop($database, $conexao){
$this->database = $database;
$this->conexao = $conexao;
return @mysql_drop_db($this->database, $this->conexao);
}
/**
* @desc Alterna o usurio do MySQL para um link aberto.
*
* @param string $username Usurio do MySQL
* @param string $password Senha do Usuario do MySQL
* @param resource $conexao Resource #ID da Conexao
*
* @return bool
*/
function ChangeUser($username, $password, $conexao){
$this->username = $username;
$this->password = $password;
$this->conexao = $conexao;
return @mysql_change_user($this->username, $this->password, $this->conexao);
}
/**
* @desc Fecha o link identificado (normalmente desnecessrio).
*
* @param resource $conexao Resource #ID da Conexao
*
* @return bool
*/
function dbClose($conexao){
$this->conexao = $conexao;
return @mysql_close($this->conexao);
}
/**
* @desc Envia uma consulta ao banco de dados.
*
* @param string $sql_query String SQL Query
*
* @return resource
*/
function Query($sql_query){
$this->sql_query = $sql_query;
$this->resultado = @mysql_query($this->sql_query) or die (mysql_errno());
return $this->resultado;
}
/**
* @desc Envia uma consulta ao banco de dados especifico.
*
* @param string $database Banco de Dados
* @param string $sql_query String SQL Query
*
* @return bool
*/
function dbQuery($database, $sql_query){
$this->database = $database;
$this->sql_query = $sql_query;
$this->resultado = @mysql_db_query($this->database, $this->sql_query) or die (mysql_errno());
return $this->resultado;
}
/**
* @desc Utilize depois de uma consulta INSERT, UPDATE ou DELETE no para verificar o nmero de linhas alteradas.
*
* @param resource $conexao Resource #ID da Conexao
*
* @return int
*/
function AffectedRows($conexao){
$this->conexao = $conexao;
return @mysql_affected_rows($this->conexao);
}
/**
* @desc Move o ponteiro interno de linha para nmero especificado de linha.
* Utiliza uma funo de busca para retornar os dados dessa linha.
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $numero_da_linha Numero da Linha a ser encontrada
*
* @return bool
*/
function DataSeek($resultado, $numero_da_linha){
$this->resultado = $resultado;
$this->linha = $numero_da_linha;
return @mysql_data_seek($this->resultado, $this->linha);
}
/**
* @desc Busca conjunto de resultados como array associativo.
* O tipo de resultado pode ser MYSQL_ASSOC, MYSQL_NUM ou MYSQL_BOTH (padro).
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return array
*/
function FetchArray($resultado){
$this->resultado = $resultado;
return @mysql_fetch_array($this->resultado);
}
/**
* @desc Retorna informaes sobre um campo como um objeto.
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $deslocamento_do_campo Deslocamento do Campo
*
* @return object
*/
function FetchField($resultado, $deslocamento_do_campo){
$this->resultado = $resultado;
$this->deslocamento_do_campo = $deslocamento_do_campo;
return @mysql_fetch_field($this->resultado, $this->deslocamento_do_campo);
}
/**
* @desc Retorna o comprimento de cada campo em um conjunto de resultados
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return array
*/
function FetchLengths($resultado){
$this->resultado = $resultado;
return @mysql_fetch_lengths($this->resultado);
}
/**
* @desc Busca o conjunto de resultados como um objeto.
* O tipo de resultado pode ser MYSQL_ASSOC, MYSQL_NUM ou MYSQL_BOTH (padro).
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return array
*/
function FetchObject($resultado){
$this->resultado = $resultado;
return @mysql_fetch_object($this->resultado);
}
/**
* @desc Busca o conjunto de rasultados como um array.
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return array
*/
function FetchRow($resultado){
$this->resultado = $resultado;
return @mysql_fetch_row($this->resultado);
}
/**
* @desc Retorna flags associadas com campo enumerado. Ex.: NOT NULL, AUTO_INCREMENT, BINARY).
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $deslocamento_do_campo Deslocamento do Campo
*
* @result string
*/
function FieldFlags($resultado, $deslocamento_do_campo){
$this->resultado = $resultado;
$this->deslocamento = $deslocamento_do_campo;
return @mysql_field_flags($this->resultado, $this->deslocamento);
}
/**
* @desc Retorna o comprimento do campo enumerado.
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $deslocamento_do_campo Deslocamento do Campo
*
* @return int
*/
function FieldLen($resultado, $deslocamento_do_campo){
$this->resultado = $resultado;
$this->deslocamento = $deslocamento_do_campo;
return @mysql_field_len($this->resultado, $this->deslocamento);
}
/**
* @desc Retorna o nome do campo enumeraxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $indice_do_campo Indice do Campo
*
* @return string
*/
function FieldName($resultado, $indice_do_campo){
$this->resultado = $resultado;
$this->indice = $indice_do_campo;
return @mysql_field_name($this->resultado, $this->indice);
}
/**
* @desc Retorna o nome do campo enumerado. Utilizado com mysql_fetch_field.
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $deslocamento_do_campo Deslocamento do Campo
*
* @return bool
*/
function FieldSeek($resultado, $deslocamento_do_campo){
$this->resultado = $resultado;
$this->deslocamento = $deslocamento_do_campo;
return @mysql_field_name($this->resultado, $this->deslocamento_do_campo);
}
/**
* @desc Retorna o nome da tabela do campo especificado.
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $deslocamento_do_campo Deslocamento do Campo
*
* @return string
*/
function FieldTable($resultado, $deslocamento_do_campo){
$this->resultado = $resultado;
$this->deslocamento = $deslocamento_do_campo;
return @mysql_field_seek($this->resultado, $this->deslocamento);
}
/**
* @desc Retorna o tipo de deslocamento de campo. Ex.: TINYINT, BLOB, VARCHAR).
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $deslocamento_do_campo Deslocamento do Campo
*
* @return string
*/
function FieldType($resultado, $deslocamento_do_campo){
$this->resultado = $resultado;
$this->deslocamento = $deslocamento_do_campo;
return @mysql_field_type($this->resultado, $this->deslocamento);
}
/**
* @desc Retorna ponteiro de resultados do banco de dados no mysql. Utilizado com mysql_table_name.
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return resource
*/
function ListDbs($resultado){
$this->resultado = $resultado;
return @mysql_list_dbs($this->resultado);
}
/**
* @desc Retorna o ID do resultado para utilizao nas funes mysql_field, sem realizar uma consulta real.
*
* @param string $database Banco de Dados
* @param string $tabela Tabela de Dados
* @param resource $resultado Resultado de uma SQL Query
*
* @return resource
*/
function ListFields($database, $tabela, $resultado){
$this->database = $database;
$this->tabela = $tabela;
$this->resultado = $resultado;
return @mysql_list_fields($this->database, $this->tabela, $this->resultado);
}
/**
* @desc Retorna ponteiro de resultado das tabelas no banco de dados. Utilizado com mysql_table_name.
*
* @param string $database Banco de Dados
* @param resource $resultado Resultado de uma SQL Query
*
* @return
*/
function ListTables($database){
$this->database = $database;
return @mysql_list_tables($this->database);
}
/**
* @desc Libera memria utilizada pelo conjunto de resultados (normalmente desnecessrio).
*
* @param resource $resultado Resultado de uma SQL Query
*/
function FreeResult($resultado){
$this->resultado = $resultado;
return @mysql_free_result($this->resultado);
}
/**
* @desc Retorna o ID de AUTO_INCREMENTED de INSERT ou FALSE se a insero falhou ou
* se a ltima consulta no era uma insero.
*
* @param resource $conexao Resource #ID da Conexao
*
* @return int
*/
function InsertID($conexao){
$this->conexao = $conexao;
return @mysql_insert_id($this->conexao);
}
/**
* @desc Retorna o ID de erro.
*
* @param resource $conexao Resource #ID da Conexao
*
* @return int
*/
function MyErrno($conexao){
$this->conexao = $conexao;
return @mysql_errno($this->conexao);
}
/**
* @desc Retorna um mensagem de erro de texto.
*
* @param resource $conexao Resource #ID da Conexao
*
* @return string
*/
function MyError($conexao){
$this->conexao = $conexao;
return @mysql_error($this->conexao);
}
/**
* @desc Retorna resultado de campo nico. O identificador de campo pode ser :
* deslocamento de campo (0);
* nome de campo (nome);
* nome de tabela de ponto (campo.tabela)
*
* @param int $resultado Resultado de uma SQL Query
* @param int $id_de_campo ID do Campo
* @param int $id_da_coluna ID da Coluna
*
* @return mixed
*/
function MyResult($resultado, $id_do_campo, $id_da_coluna){
$this->resultado = $resultado;
$this->id_campo = $id_do_campo;
$this->id_coluna = $id_da_coluna;
return @mysql_result($this->resultado, $this->id_coluna, $this->id_campo);
}
/**
* @desc Retorna o nmero de de campos em um conjunto de resultados
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return int
*/
function NumFields($resultado){
$this->resultado = $resultado;
return @mysql_num_fields($this->resultado);
}
/**
* @desc Retorna o nmero de linhas em um conjunto de resultados.
*
* @param resource $resultado Resultado de uma SQL Query
*
* @return int
*/
function NumRows($resultado){
$this->resultado = $resultado;
return @mysql_num_rows($this->resultado);
}
/**
* @desc Utilizado com qualquer funo mysql_list para retornar o valor referenciado por um ponteiro de resultado.
*
* @param resource $resultado Resultado de uma SQL Query
* @param int $coluna ID da Coluna
*
* @return mixed
*/
function TableName($resultado, $coluna){
$this->resultado = $resultado;
$this->coluna = $coluna;
return @mysql_table_name($this->resultado, $this->coluna);
}
}
/*
... Exemplo
require('class.dbMySQL.php');
$db = new dbMySQL();
$link_id = $db->Connect($DB_HOSTNAME, $DB_USERNAME, $DB_PASSWORD);
if ($link_id){
$db->dbSelect($DB_DATABASE);
}
$rSet = $db->Query("SELECT * FROM login WHERE login.user='$user' AND login.pass='$senha'");
if ($db->NumRows($rSet) > 0){
$row = $db->FetchObject($rSet);
$_SESSION['user'] = $row->user;
$_SESSION['nome'] = $row->nome;
header("Location: pagina_dos_usuarios_autenticados.php");
}else{
echo "Usurio/Senha invlidos";
}
... Fim de Exemplo
*/
?>
