Esta classe é baseada no PDO, que é uma extensão do PHP que permite aos desenvolvedores criar um código portável, de modo a atender a maioria das bases de dados mais populares. Sendo o MySQL, PostgreSQL, Oracle, MS SQL Server, Sybase.
E agora a partir da versão 2.6, também oferencendo suporte ao banco de dados CUBRID. O mais novo sistema de gerenciamento de banco de dados altamente otimizado para aplicações Web. Mais informações em: http://bit.ly/CUBRID
O PDO4You provê uma camada abstrata de acesso a dados, que independentemente de qual base de dados você esteja utilizando, sempre poderá usar os mesmos métodos para emitir consultas e buscar dados.
O padrão de projeto Singleton foi adotado para otimizar a conexão, garantindo uma única instância do objeto de conexão por base de dados.
Vantagens em sua utilização:
- Abstração de conexão
- Proteção contra SQL Injection
- Métodos CRUD pré-definidos
- Múltiplas conexões por base de dados
- Instrução SQL compacta, usando notação JSON
- Tratamento de erros com Stack Trace
<?php
// Apenas um arquivo é necessário para carregar toda a biblioteca
require_once('PDO4You.load.php');
?>
PDO4You.load.php
: arquivo responsável pelo carregamento dos arquivos necessários ao funcionamento da lib PDO4You.
PDO4You.class.php
: contém a implementação do objeto PDO de conexão.
PDO4You.config.php
: arquivo de configuração inicial, de acesso ao servidor e base de dados.
PDO4You.library.php
: contém um autoloading de classes e pode ser usado como biblioteca de funções úteis ao sistema.
settings.ini
: contém as definições para cada adaptador de conexão com a base de dados.
Execute o método abaixo para verificar se o servidor tem suporte a um driver PDO específico de sua base de dados. Os drivers suportados serão exibidos na tela.
<?php
// O método abaixo exibe todos os drivers instalados e que são suportados pelo servidor
PDO4You::getAvailableDrivers();
?>
Para habilitar algum driver não instalado, localize o arquivo php.ini, abra e procure por "extension=" sem as aspas, depois descomente as linhas a seguir conforme sua base de dados de preferência, removendo no início de cada linha o "ponto-e-vírgula" e após mudanças, reinicie o servidor.
extension=php_pdo.dll
extension=php_pdo_mysql.dll
extension=php_pdo_pgsql.dll
;extension=php_pdo_cubrid.dll
;extension=php_pdo_mssql.dll
;extension=php_pdo_oci.dll
;extension=php_pdo_oci8.dll
;extension=php_pdo_sqlite.dll
Para abstrair nossos mecanismos de acesso aos dados, usamos um DSN (Data Source Name = Nome de Fonte de Dados) que armazena as informações necessárias para se iniciar uma comunicação com outras fontes de dados, tais como: tipo de tecnologia, nome do servidor ou localização, nome da base de dados, usuário, senha e outras configurações adicionais. Isso facilita a troca de acesso à base de dados que sofrerem migração.
<?php
// Principais meios de se iniciar uma instância de conexão
# PADRÃO
PDO4You::getInstance(); // Os dados de acesso já foram definidos no arquivo de configuração inicial
// Conectando-se a outras fontes de dados através de um DSN
# MySQL
PDO4You::getInstance('nome_da_instancia', 'mysql:host=localhost;dbname=pdo4you;port=3306', 'user', 'pass');
# PostgreSQL
PDO4You::getInstance('nome_da_instancia', 'pgsql:host=localhost;dbname=pdo4you;port=5432', 'user', 'pass');
# CUBRID
PDO4You::getInstance('nome_da_instancia', 'cubrid:host=localhost;dbname=pdo4you;port=33000', 'user', 'pass');
?>
O termo CRUD em inglês se refere as 4 operações básicas em uma base de dados e significam: Create(INSERT), Retrieve(SELECT), Update(UPDATE) e Destroy(DELETE)
Instruções SQL de consulta:
PDO4You::select()
: retorna um array indexado pelo nome da coluna. Equivale a PDO::FETCH_ASSOC
PDO4You::selectNum()
: retorna um array indexado pela posição numérica da coluna. Equivale a PDO::FETCH_NUM
PDO4You::selectObj()
: retorna um objeto com nomes de coluna como propriedades. Equivale a PDO::FETCH_OBJ
PDO4You::selectAll()
: retorna um array indexado pelo nome e pela posição numérica da coluna. Equivale a PDO::FETCH_BOTH
Abaixo seguem exemplos de como realizar estas operações.
<?php
// Iniciando uma instância de conexão. O padrão de conexão é não-persistente
PDO4You::getInstance();
// Definindo uma comunicação persistente com a base de dados
PDO4You::setPersistent(true);
// Selecionando registros na base de dados
PDO4You::select('SELECT * FROM books LIMIT 2');
// Selecionando registros e definindo qual instância de conexão será utilizada
PDO4You::select('SELECT * FROM books LIMIT 2', 'nome_da_instancia');
// Query de consulta
$sql = 'SELECT * FROM books LIMIT 2';
// Selecionando registros com FETCH_ASSOC
$result = PDO4You::select($sql);
// Selecionando registros com FETCH_NUM
$result = PDO4You::selectNum($sql);
// Selecionando registros com FETCH_OBJ
$result = PDO4You::selectObj($sql);
// Selecionando registros com FETCH_BOTH
$result = PDO4You::selectAll($sql);
// Selecionando todos os registros
$result = PDO4You::select('SELECT * FROM books');
// Obtendo o total de linhas afetadas pela operação
$total = PDO4You::rowCount();
// Exibindo o resultado da consulta
echo '<pre><h3>Resultado da consulta:</h3> ' , print_r($result, true) , '</pre>';
?>
Os métodos insert(), update() e delete() da classe PDO4You estão aninhadas entre transações, sendo elas beginTransaction() e commit(). Isto garante que o sistema consiga reverter uma operação mal sucedida e todas as alterações feitas desde o início de uma transação.
Um erro grave na execução resulta em invocar o rollBack(), desfazendo toda a operação. Consequentemente será lançada uma Exception, rastreando o caminho de todas as classes e métodos envolvidos na operação, agilizando em ambiente de "produção" o processo de debug e com isso, assegurando a base de dados do risco de se tornar instável.
No MySQL o suporte a transações está disponível em tabelas do tipo InnoDB.
As instruções SQL da classe PDO4You (insert, update e delete) fazem agora o uso de notação JSON, um novo formato de se escrever querys que por sua vez possui convenções muito semelhante às linguagens como Python, Ruby, C++, Java, JavaScript. A nova sintaxe adotada pela classe é bem mais bonita e concisa, que a usada por Arrays. Além de compacta, as instruções possuem a capacidade de operar ao mesmo tempo, em diferentes tabelas da mesma base de dados.
Abaixo seguem trechos de exemplo na prática.
<?php
// Query
$json = '
{
query : [
{
table: "users" ,
values: { mail: "pdo4you@gmail.com" }
}
]
}
';
// A variável $result armazena como retorno do método, um array com o número de linhas afetadas por operação de inserção
$result = PDO4You::insert($json);
// Logo após a inserção, utilize o método PDO4You::lastId() para obter o ID da última operação de inserção na base de dados
$lastInsertId = PDO4You::lastId();
// Se necessário, informe o nome da variável de sequência, solicitado em algumas base de dados
$lastInsertId = PDO4You::lastId('table_id_seq');
?>
<?php
// Query
$json = '
{
query : [
{
table: "users" ,
values: { mail: "mail_1@domain.com" }
},{
table: "users" ,
values: { mail: "mail_2@domain.com" }
},{
table: "books" ,
values: { title: "title", author: "author" }
}
]
}
';
// A variável $result armazena um array com o número de linhas afetadas por operação de inserção
$result = PDO4You::insert($json);
?>
<?php
// Query
$json = '
{
query : [
{
table: "users" ,
values: { mail: "mail_1@domain.com" } ,
where: { id: 2 }
},{
table: "users" ,
values: { mail: "mail_2@domain.com" } ,
where: { id: 3 }
},{
table: "books" ,
values: { title: "new-title", author: "new-author" } ,
where: { id: 1 }
}
]
}
';
// A variável $result armazena um array com o número de linhas afetadas por operação de atualização
$result = PDO4You::update($json);
?>
<?php
// Query
$json = '
{
query : [
{
table: "users" ,
where: { id: 2 }
},{
table: "users" ,
where: { id: 5 }
},{
table: "users" ,
where: { id: 10 }
},{
table: "books" ,
where: { id: 10 }
}
]
}
';
// A variável $result armazena um array com o número de linhas afetadas por operação de exclusão
$result = PDO4You::delete($json);
?>