PHP PDO: Como se conectar ao banco de dados

O PDO (PHP Data Objects) define uma interface de conex�o a banco de dados leve e consistente para PHP. H� a possibilidade de utilizaç�o de diversos drivers de conex�o que implementam a interface do PDO para v�rios tipos de bancos de dados.

Como o PDO representa uma camada de abstraç�o de acesso aos dados, as mesmas funç�es utilizadas para manipular dados ou recuperar informaç�es do banco ser�o as mesmas, independentemente do banco de dados que esteja sendo usado.

Figura 1: PDO em PHP

Existem tr�s API�s de conex�o com o banco de dados em PHP, s�o elas:

mysql: Pacote de funç�es para acesso ao MySQL, foi descontinuado no PHP7.
mysqli: Extens�o da API mysql com suporte a funcionalidades adicionadas a vers�es posteriores ao MySQL 4.1 - http://www.mysql.com/
PDO - PHP Data Objects: Interface para acesso a dados do PHP.

Saiba mais sobre o PDO

O PDO � uma API robusta que pode ser usada, independentemente do driver que voc� estiver usando.

Muitas pessoas ficam um pouco intimidadas em usar o PDO de in�cio, n�o por se tratar de uma API dif�cil de usar, muito pelo contr�rio, pois � muito f�cil de usar, mas sim porque a API mysql � muito f�cil de usar e as pessoas acabam se acostumando com ela.

Mas vamos ver como realmente � f�cil de us�-la.

Conex�o ao banco de dados

Primeiro vamos ver como se conectar usando o PDO. N�s vamos criar uma nova inst�ncia de classe e especificar o driver que vamos usar, no caso o mysql, o nome do banco de dados, nome de usu�rio e senha.

<?php
$conn = new PDO('mysql:host=localhost;dbname=meuBancoDeDados', $username, $password);
?>

Listagem 2.�Criando conex�o com PDO

Como vimos na�Listagem 2, tamb�m � muito simples se conectar usando o PDO, mas como em toda conex�o, � preciso tratar os erros, para se caso aconteça algum erro na conex�o, mostrar isso ao usu�rio.

Para isso vamos usar o try..catch, usado nas linguagens orientada a objetos.

<?php
try {
  $conn = new PDO('mysql:host=localhost;dbname=meuBancoDeDados', $username, $password);
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch(PDOException $e) {
    echo 'ERROR: ' . $e->getMessage();
}
?>

Listagem 3.�Tratando erros na conex�o

O erro padr�o do PDO � o PDO::ERRMODE_SILENT, mas no nosso c�digo usamos o PDO::ERRMODE_EXCEPTION e abaixo vou listar as opç�es que temos:

PDO::ERRMODE_SILENT
PDO::ERRMODE_WARNING
PDO::ERRMODE_EXCEPTION

Saiba mais sobre como conectar MySQL com PHP

Fetch

Agora vamos fazer começar a utilizar o select com PDO, buscando determinados resultados. Existem duas formas b�sicas de se fazer isso: Consultando e Executando e s�o essas duas que iremos analisar mais pra frente.

<?php 
/*
 * M�todo de conex�o sem padr�es
 */

$name = 'Ricardo'; 
 
try {
    $conn = new PDO('mysql:host=localhost;dbname=meuBancoDeDados', $username, $password);
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 
    $data = $conn->query('SELECT * FROM minhaTabela WHERE nome = ' . $conn->quote($name));
 
    foreach($data as $row) {
        print_r($row); 
    }
} catch(PDOException $e) {
    echo 'ERROR: ' . $e->getMessage();
}

 ?>

Listagem 4.�Conectando com banco de dados usando PDO

Embora isso funcione, observe que ainda estamos escapando manualmente os dados do usu�rio com o m�todo PDO::quote. Pense nisso como m�todo, mais ou menos, o equivalente ao mysql_real_escape_string; no PDO.

Em situaç�es, quando voc� est� vinculado aos dados fornecidos pelo usu�rio para uma consulta SQL, � fortemente aconselh�vel que voc�, em vez usar isso, use prepared statements.

Dito isto, se suas consultas SQL n�o s�o dependentes de dados do formul�rio, o m�todo de consulta � uma escolha �til, e torna o processo de loop atrav�s dos resultados t�o f�cil como uma instruç�o foreach.

<?php 
/*
 * Melhor pr�tica usando Prepared Statements
 * 
 */
 
$id = 5;
try {
    $conn = new PDO('mysql:host=localhost;dbname=meuBancoDeDados', $username, $password);
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);    
     
    $stmt = $conn->prepare('SELECT * FROM minhaTabela WHERE id = :id');
    $stmt->execute(array('id' => $id));
 
    while($row = $stmt->fetch()) {
        print_r($row);
    }
} catch(PDOException $e) {
    echo 'ERROR: ' . $e->getMessage();
}

 ?>

Listagem 5.�Usando Prepared Statements

Neste exemplo, estamos usando o m�todo de preparo para, literalmente, preparar a consulta, antes de os dados do usu�rio forem anexados. Com esta t�cnica, o SQL Injection � praticamente imposs�vel, porque os dados n�o nunca s�o inseridos na consulta SQL em si.

Observe que, em vez disso, usamos par�metros nomeados (:id) para especificar espaços reservados.

N�s executamos a consulta, ao passar uma matriz, que cont�m os dados que devem ser vinculados a esses espaços reservados.

$stmt->execute(array('id' => $id));

Um suplente, mas perfeitamente aceit�vel abordagem, seria usar o m�todo bindParam, assim:

Uma forma alternativa mas que � perfeitamente aceit�vel e que pode ser usada sem medo por quem quiser usar, � usar o m�todo bindParam, ficando dessa forma:

$stmt->bindParam(':id', $id, PDO::PARAM_INT);
$stmt->execute();

Listagem 6.�Usando o m�todo bindParam

Depois de chamar o m�todo execute, existem diferentes maneiras de receber os dados: uma matriz (o padr�o), um objeto, etc. No exemplo acima, a resposta padr�o �: PDO:: FETCH_ASSOC, o que pode ser facilmente substitu�da caso seja necess�rio.

while($row = $stmt->fetch(PDO::FETCH_OBJ)) {
    print_r($row);
}

Listagem 7.�Especificando a interaç�o

No c�digo acima, especificamos que n�s queremos interagir com o result set da melhor maneira orientada a objetos. Abaixo irei listar algumas das opç�es dispon�veis para essa interaç�o.

PDO :: FETCH_ASSOC: Retorna uma matriz.
PDO :: FETCH_BOTH: Retorna uma matriz, indexada pelo nome da coluna e 0-indexados.
PDO :: FETCH_BOUND: Retorna TRUE e atribui os valores das colunas no seu conjunto de resultados para as vari�veis PHP que estavam amarradas.
PDO :: FETCH_CLASS: Retorna uma nova inst�ncia da classe especificada.
PDO :: FETCH_OBJ: Retorna um objeto an�nimo, com nomes de propriedades que correspondem �s colunas.

Mas existe um problema ainda com o que fizemos at� agora no c�digo, n�s n�o estamos dando feedback nenhum para o usu�rio se, por exemplo, quando nenhum resultado for retornado.

No c�digo abaixo iremos consertar essa falta de feedback e dar um retorno ao usu�rio.

<?php 

$stmt->execute(array('id' => $id));
 
# Pega um array contendo todos os resultados
$result = $stmt->fetchAll();
 
# Se um ou mais resultados forem retornados... 
if ( count($result) ) {
    foreach($result as $row) {
        print_r($row);
    }
} else {
    echo "Nenhum resultado retornado.";
}

 ?>

Listagem 8.�Retornando feedback ao usu�rio

Dessa forma, nosso c�digo completo pode ser visto na�Listagem 9.

<?php 

$id = 5;
try {
  $conn = new PDO('mysql:host=localhost;dbname=meuBancoDeDados', $username, $password);
  $stmt = $conn->prepare('SELECT * FROM minhaTabela WHERE id = :id');
  $stmt->execute(array('id' => $id));
 
  $result = $stmt->fetchAll();
 
  if ( count($result) ) { 
    foreach($result as $row) {
      print_r($row);
    }   
  } else {
    echo "Nennhum resultado retornado.";
  }
} catch(PDOException $e) {
    echo 'ERROR: ' . $e->getMessage();
}

 ?>

Listagem 9.�C�digo completo do exemplo

Neste artigo aprendemos a se conectar a um banco de dados MySQL utilizando a API PDO do PHP para isso, tamb�m vimos como fazer um select com prepared statement.

Espero que tenham gostado e at� o pr�ximo artigo.

PHP PDO: Como se conectar ao banco de dados

Nesse artigo iremos ver como funciona a nova API mais usada de conexão com banco de dados em PHP, o PDO e também veremos como se conectar ao banco de dados e retornar registros usando Prepared Statement.

Conex�o ao banco de dados

Fetch

Artigos relacionados