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, MS SQL Server, Sybase, Oracle.
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.
- 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.
// (dependendo do diretório onde você instalar o PDO4You,
// pode ser necessário inserí-lo antes do nome do arquivo PDO4You.load.php )
require_once("PDO4You.load.php");
?>PDO4You.load.php: contém a função para carregamento inteligente de todos os arquivos necessários para o funcionamento da lib PDO4You.
PDOConfig.class.php: contém a interface de configuração inicial, de acesso ao servidor e base de dados.
PDO4You.class.php: possui a implementação do objeto PDO4You de conexão Singleton, estendendo a extensão PDO do PHP.
PDOLibrary.php: possui um autoloading de classes e pode ser usado como biblioteca de funções úteis ao sistema.
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 getAvailableDrivers, 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_mssql.dll
;extension=php_pdo_oci.dll
;extension=php_pdo_oci8.dll
;extension=php_pdo_sqlite.dllPara abstrair nossos mecanismos de acesso aos dados, usamos um DSN ou 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. O uso do DSN é opcional.
# MySQL
PDO4You::getInstance(); // PADRÃO - Os dados de acesso já foram definidos na interface
PDO4You::getInstance('database'); // Instanciando e definindo uma outra base de dados que será utilizada
// Conectando-se a outras fontes de dados, através de um DSN.
# MySQL
PDO4You::getInstance('database', 'mysql:host=localhost;port=3306;', 'root', 'pass');
# PgSQL
PDO4You::getInstance('database', 'pgsql:host=localhost;', 'root', 'pass');
# MS SQL
PDO4You::getInstance('database', 'mssql:host=localhost;', 'root', '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(): Obtém registros como um array indexado pelo nome da coluna. Equivale a PDO::FETCH_ASSOC
PDO4You::selectNum(): Obtém registros como um array indexado pelo número da coluna. Equivale a PDO::FETCH_NUM
PDO4You::selectObj(): Obtém registros como um objeto com nomes de coluna como propriedades. Equivale a PDO::FETCH_OBJ
PDO4You::selectAll(): Obtém registros como um array indexado tanto pelo nome como pelo número 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 é persistente.
PDO4You::getInstance();
// Para definir um tipo de comunicação persistente ou não-persistente, utilize o método abaixo passando um valor booleano.
PDO4You::setPersistent(false);
// Selecionando registros na base de dados
PDO4You::select('SELECT * FROM books LIMIT 2');
// Selecionando registros e definindo qual instância de base de dados será utilizada
PDO4You::select('SELECT * FROM books LIMIT 2', 'bookstore');
// 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
// SQL query
$sql = '
{
query : [
{
table: "users" ,
values: { mail: "[email protected]" }
}
]
}
';
// 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($sql);
// Logo após a inserção, utilize o método lastId(), para recuperar o ID da última operação de inserção na base de dados
$lastInsertId = PDO4You::lastId();
// Se estiver usando o driver pgsql(Postgres), será necessário informar o nome da seqüência para obter o ID, que por padrão foi definido como "_id_seq"
$lastInsertId = PDO4You::lastId('_id_seq');
?><?php
// SQL query
$sql = '
{
query : [
{
table: "users" ,
values: { mail: "[email protected]" }
},{
table: "users" ,
values: { mail: "[email protected]" }
},{
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($sql);
?><?php
// SQL query
$sql = '
{
query : [
{
table: "users" ,
values: { mail: "[email protected]" } ,
where: { id: 2 }
},{
table: "users" ,
values: { mail: "[email protected]" } ,
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($sql);
?><?php
// SQL query
$sql = '
{
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($sql);
?>