CRUD Introdução a PDO

[Omar~ 87]

A pouco mais de um ano desde a data dessa postagem venho frequentando aqui o iMasters, e vejo que um vasta soma de dúvidas das pessoas é como conectar acessar, editar etc... dados em um banco sql.

Então resolvi criar esse guia uma vez que até o momento não encontrei conteúdo similar aqui para dar uma introdução ao PDO. Voltado para quem está não tem noção alguma sobre pdo e quer fazer a manipulação de tabelas sql.

Será um guia bem básico voltado no procedural, pois o alvo não é ensinar a programar e sim introduzir o leitor na PDO.

 

• Mas o que é PDO? Extensão orientada a objetos para manipulação de banco de dados

P : PHP

D : Data

O : Object

E como saber se meu sistema suporta PDO?

Essa extensão foi introduzida no php a partir da versão 5.1, mas é possível saber se a mesma está instalada ou não:

Spoiler

<?php
if (extension_loaded('pdo')) {
    echo ('Sim podemos usar PDO!!!');
} else {
    echo ('Ops! Nosso PHP está faltando coisa porque será eim?');
}

 

 

• Mas o que é CRUD? As 4 operações principais de manipulação de banco de dados

C : Create - criar dados

R : Read - ler dados

U : Update - alterar dados

D : Delete - apagar dados

 

• Quais programas preciso para seguir esse guia?

Primeiramente você deve possuir um sistema apache + SQL ou mariaDB instalado (Sugiro é que busque pelo Xampp)

Um navegador de web (Sugiro Mozilla Firefox)

Um editor de texto ou IDE (Sugiro o NetBeans IDE só a versão PHP e HTML já é o suficiente para desenvolvimento web)

 

 

 

 

Então vamos botar a mão na maça!

 

Para nosso primeiro passo então vamos criar uma banco de dados e uma tabela para que possa-mos utilizar em nossos testes, uma bem genérica e simples mesmo.
Abra um editor de texto aí (sugiro que tenha o notepad++) e crie um novo arquivo assim: tabela.sql, colando o texto abaixo no arquivo.
Não se esqueça que o nome do arquivo deve se terminado em .SQL

CREATE DATABASE crudpdo DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci; -- Cria o banco de dados

USE crudpdo; -- Acessa o banco de dados para criar a tabela

CREATE TABLE `usuarios` (
  `usuario_id` int(11) NOT NULL AUTO_INCREMENT,
  `nome` varchar(50),
  `sobre_nome` varchar(50),
  `login` varchar(50),
  `senha` text,
  PRIMARY KEY (`usuario_id`)
);

Citar

*Nota: Com PDO é possível criar/editar/apagar banco de dados também, mas isso é outra história que não se aplica ao nosso CRUD aqui.

 

Criado o arquivo abra importe esse arquivo, se você usa o PhpMyAdmim(localhost/phpmyadmim), ao abri-lo procure por um input (IMPORTAR)
Feito o processo corretamente você pode perceber que um novo banco de dados apareceu "crudpdo" e dentro dele uma tabela "usuarios", não se preocupe por nossa tabela está vazia iremos povoá-la com o decorrer desse guia.
 

Simples não? Agora que temos nossa tabela, vamos enfim estabelecer a conexão com ela pois para podemos fazer as manipulações temos que conectar.
Criamos então algumas variáveis que vão nos ajudar a modificar o acesso de forma mais rápida no futuro caso queiramos fazer isso.
 

$host = '127.0.0.1'; // Endereço do banco de dados (Nosso exemplo é o ambiente local)
$db = 'crudpdo'; // Banco de dados que criamos em nosso arquivo SQL
$usuario = 'root'; // Nome do usuário de acesso ao banco de dados
$senha = ''; // Se você intalou o xampp por exemplo ele possui um usuário global (root) sem senha

 

Vamos lançar um exceção para descobrir se a conexão foi realizada, para isso usaremos o bloco try. E caso houver erro armazenamos o erro na variável $erro

 

try {
} catch (PDOException $erro) {
echo ('Erro na conexão: ' . $erro->getMessage());
}

 

Então criamos um objeto da PDO esse objeto será $con
Nesse objeto instanciamos a classe pdo

$con = new PDO($dsn, $user, $pass, $options);

 

Perceba como funciona a PDO:

• $dsn > Contém as informações do drive que será usado na conexão e o banco de dados usado para conectar
• $user > Contém a informação do login do usuário que pode acessar a tabela
• $pass > Contém a informação da senha do usuário
• $options >Pode comportar uma série de fatores, por isso usamos uma array para definir essa entrada, aqui eu só vou tratar a codificação de caracteres, talvez em um post futuro possa a vim falar sobre silenciar o console, modelador de acesso etc...

 

Veja como fica nossa conexão:

Spoiler

<?php
$host = '127.0.0.1';
$db = 'crudpdo';
$usuario = 'root';
$senha = '';

try {
    $dsn = "mysql:host={$host}; dbname={$db}";
    $options = [PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES UTF8'];

    $con = new PDO($dsn, $usuario, $senha, $options);

    } catch (PDOException $erro) {
        echo ('Erro na conexão: ' . $erro->getMessage());
}

 

 

 

E como sabemos se deu certo?

Primeiramente se não conseguir conectar nossa exceção será lançada como erro e mostrará os motivos do erro assim como expliquei acima pelo uso do bloco try
Mas se quiser-mos depurar usamos isso:
var_dump($con);
deve aparecer algo parecido a isso se acessarmos o arquivo pelo navegador
object(PDO)#1 (0) { }

 

 

 

• C - Create/INSERT

- Certo, certo que tal agora tentar-mos inserir algo em nossa tabela? Vamos?!
Já que vamos inserir um registro criaremos uma nova intância da pdo reaproveitando o objeto da conexão
$insert = $con->prepare
 

Nesse momento começamos o prepared statements
Então devo informa o que é para fazer

• INSERT INTO > insira dentro de
• Informo o nome da tabela no nosso exemplo é "usuarios"
• Informo as colunas da tabela separadas por virgula que no caso é "nome, sobre_nome, login, senha"
• Passo os valores preparados ":name, :upname, :login, :pass" os nomes devem começar com :"dois-pontos" e serem separados por virgula. É crucial que não erre na ordem, pois esses serão os valores inseridos em ordem com que você definiu as colunas, enquanto ao nomes você pode usar sua criatividade, só não aconselho usar caracteres especiais ou nomes muito longos.

 

Ficando assim minha query

$insert = $con->prepare('INSERT INTO usuarios (nome, sobre_nome, login, senha) VALUES (:nome, :upname, :login, :pass)');

 

Por fim mandamos executar "dando nome aos gados"
 

$insert->execute([
    'nome' => 'Chaves',
    'upname' => 'Kiko',
    'login' => 'Madruga',
    'pass' => 'Florinda'
]);

 

Então pedimos a contagem do registro para saber se tudo ocorreu bem.

if ($insert->rowCount()) {
    echo ('Dados Registrados');
} else {
    echo ('Nenhum registro inserido');
}

 

Citar

*Nota: Para maior depuração você pode usar o bloco try para pedir que a PDO informe o erro através de Exception assim como foi feito na conexão.

 

 

Veja como ficou meu arquivo com a conexão e com o insert:

Spoiler

<?php
$host = '127.0.0.1';
$db = 'crudpdo';
$usuario = 'root';
$senha = '';

try {
    $dsn = "mysql:host={$host}; dbname={$db}";
    $options = [PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES UTF8'];

    $con = new PDO($dsn, $usuario, $senha, $options);
} catch (PDOException $erro) {
    echo ('Erro na conexão: ' . $erro->getMessage());
}

$insert = $con->prepare('INSERT INTO usuarios (nome, sobre_nome, login, senha) VALUES (:nome, :upname, :login, :pass)');
$insert->execute([
    'nome' => 'Chaves',
    'upname' => 'Kiko',
    'login' => 'Madruga',
    'pass' => 'Florinda'
]);
if ($insert->rowCount()) {
    echo ('Dados Registrados');
} else {
    echo ('Nenhum registro inserido');
}

 

 

 

Ah!! Mas aí você me pergunta: "Que diacho é isso" toda vez que eu atualizo a página ou acesso o mesmo registro é inserido novamente!
Isso já são outros carnavais, aqui nós só estamos vendo a execução, enquanto a validação e checagens fica para a próxima... 
 

• R - Read/SELECT

 

Já que temos um registro ou mais, não sei quantas vezes você fez nossa brincadeira acima^^, então vamos ler esse(s) registro(s) agora.
Para fazer um select fazemos da mesma forma que no insert, a única coisa que você deve ficar atento quando for executar as querys é com o prepared, onde o que você faz é só tirar os valores da execução, passado-os para outra camada mais protegida, o que já nos trás alguma segurança contra injeção de código.

 

Criamos então nosso prepared para leitura

$select = $con->prepare("SELECT * FROM usuarios WHERE nome = :username AND login = :userlogin");

 

Nesse caso estou fazendo um select em todos dos dados da tabela usuarios (SELECT * FROM usuarios) mas eu só quero os resultados que contenham o (nome & login) "Obeserve como é passada a referência da busca"

 

Uma vez com a query preparada executamos passando o statements, através de uma array

$select->execute([':username' => 'Chaves', ':userlogin' => 'Madruga']);

 

Veja que os valores buscados são os valores do cadastro, logo então esses dados existem.
Agora eu tenho que escolher como eu quero receber esses dados pois eles sempre serão recebidos como array. E como quero essa array?
Optei por utilizar uma array associativa por ser de mais fácil entendimento para iniciantes.
Apesar que gosto de retornar os valores já em objetos, assim fica mais prático de se reaproveitar.

$resultado = $select->fetchAll(PDO::FETCH_ASSOC);

 

Antes de mostrar os resultados eu tenho que saber se realmente existem resultados para mostrar, para basta que mandemos a PDO contar quantos registros ela encontrou usando rowCount()

Citar

*NOTA: rowCunt. Sempre vai retornar um INTERGER com a quantidade de registros obtidos através da query

Então dentro dessa condição se existir eu percorro a array e vou exibindo os dados

if ($select->rowCount()) {
    foreach ($resultado as $valores) {
        echo ("<b>Nome:</b> {$valores['nome']}<br />"
             . "<b>Sobre-Nome:</b> {$valores['sobre_nome']}<br />"
             . "<b>Login:</b> {$valores['login']}<br />"
             . "<b>Senha:</b> {$valores['senha']}");
    }
}

 

Olha como ficou minha leitura:
 

Spoiler

<?php
$host = '127.0.0.1';
$db = 'crudpdo';
$usuario = 'root';
$senha = '';

try {
    $dsn = "mysql:host={$host}; dbname={$db}";
    $options = [PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES UTF8'];

    $con = new PDO($dsn, $usuario, $senha, $options);
} catch (PDOException $erro) {
    echo ('Erro na conexão: ' . $erro->getMessage());
}

$select = $con->prepare('SELECT * FROM usuarios WHERE nome = :username AND login = :userlogin');
$select->execute([':username' => 'Chaves', ':userlogin' => 'Madruga']);
$resultado = $select->fetchAll(PDO::FETCH_ASSOC);

if ($select->rowCount()) {
    foreach ($resultado as $valores) {
        echo ("<b>Nome:</b> {$valores['nome']}<br />"
             . "<b>Sobre-Nome:</b> {$valores['sobre_nome']}<br />"
             . "<b>Login:</b> {$valores['login']}<br />"
             . "<b>Senha:</b> {$valores['senha']}");
    }
} else {
    echo ('Nada encontrado com a query executada');
}

 

 

 

 

 

• U - Update/UPDATE

 

 

Bom agora que já inserimos, e fizemos a leitura vamos ao modificar

 

Então criamos nossa query preparada

$update = $con->prepare('UPDATE usuarios SET nome = :username, login = :userlogin WHERE usuario_id = :userid');

 

Note que só estou a alterar o nome e o login de uma tabela(os dados devem ser separados por virgula)
Seguindo após o WHERE eu busco o local para alterar pela coluna usuario_id
 

Passamos o statements

$update->execute(['username' => 'Chapolin', 'userlogin' => 'Chiquinha', 'userid' => 1]);

 

Citar

*Nota: veja que no statements 'userid' eu usei um INTERGER pois essa coluna na tabela é desse tipo. A PDO possui métodos para averiguar o que é STRING e o que é INTERGER, procure a respeito sobre PDO::PARAM_STR e PDO::PARAM_INT
Resolvi não abordar esse assunto aqui porque o guia é para iniciantes, e isso depende de um certo conhecimento no uso da PDO.

 

Então o usuário que se chamava chaves agora vai ser modificado para Chapolin e seu login que era Madruga vai ser Chiquinha
Para saber se foi modificados usamos também o rowCount()
 

Veja como ficou o meu update:

Spoiler

<?php
$host = '127.0.0.1';
$db = 'crudpdo';
$usuario = 'root';
$senha = '';

try {
    $dsn = "mysql:host={$host}; dbname={$db}";
    $options = [PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES UTF8'];

    $con = new PDO($dsn, $usuario, $senha, $options);
} catch (PDOException $erro) {
    echo ('Erro na conexão: ' . $erro->getMessage());
}

$update = $con->prepare('UPDATE usuarios SET nome = :username, login = :userlogin WHERE usuario_id = :userid');
$update->execute(['username' => 'Chapolin', 'userlogin' => 'Chiquinha', 'userid' => 1]);

if ($update->rowCount()) {
    echo ('Dados modificados');
} else {
    echo ('Nada foi modificado');
}

 

 

 

 

 

• D - Delete/DELETE

 

Agora por fim vamos deletar os dados no banco.
O mais simples de todo crud
 

Preparamos

$delete = $con->prepare('DELETE FROM usuarios WHERE usuario_id = :userid');

 

Executamos

$delete->execute(['userid' => 3]);

Hunnn.....? Se eu estou apenas buscando um ID porque criar uma array? Pelo simples fato que assim como nos outros exemplos acima, se você quiser atacar vários registros ao mesmo tempo.

 

Veja como ficou meu delete:

Spoiler

<?php
$host = '127.0.0.1';
$db = 'crudpdo';
$usuario = 'root';
$senha = '';

try {
    $dsn = "mysql:host={$host}; dbname={$db}";
    $options = [PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES UTF8'];

    $con = new PDO($dsn, $usuario, $senha, $options);
} catch (PDOException $erro) {
    echo ('Erro na conexão: ' . $erro->getMessage());
}

$delete = $con->prepare('DELETE FROM usuarios WHERE usuario_id = :userid');
$delete->execute(['userid' => 1]);

 

 

 

Adicionais

 

 

Se você percebeu, tentei falar e mostrar o mais básico e simples o possível, a PDO de forma peculiar possui diversos métodos e técnicas de acesso e edição de databases, além vários truques de segurança.

 

O ideal é acompanha-lo junto a orientação a objetos. Em todos os exemplos tive que ficar criando a conexão e enchendo o arquivo da mesma coisa repetitivamente. Não seria mais prático ter uma classe só para conectar, daí quando e precisar da conexão é só chamar?

A mesma coisa vale para insert, select, update e delete. Não é mais fácil criar uma classe que faz tudo e quando precisar realizar tal coisa consiga em uma única linha porque já está pronto?

Veja esse exemplo de uma classe que usa a PDO para fazer select

Spoiler

<?php
class Select extends Connect {

    /** @Attr: Armazena a tabela */
    private $selectTable;

    /** @Attr: Armazena os valores */
    private $selectFields;

    /** @Attr: Armazena a syntax da query */
    private $selectSyntax;

    /** @Attr: Armazena a conexão */
    private $selectConn;

    /** @Attr: Armazena se houve sucesso na incerssão */
    private $selectData;

    /** @Attr: Armazena o erro para personalizar a saída */
    private $selectError;

    /**
     * ************************************************
     * @Method: Recebe os dados para ler.
     * @Param ($table) : Tabela para ler.
     * @Param ($fields) : Campos para ler.
     * @Param ($statements) : Valores para ler.
     * @Note: (LIMIT/OFFSET) São opcionais.
     * ************************************************
     */
    public function selectQuery($table, $fields = null, $statements = null) {
        if (!empty($statements)) {
            parse_str($statements, $this->selectFields);
        }
        $this->selectTable = 'SELECT * FROM ' . $table . (isset($fields) ? ' WHERE ' . $fields : null);
        $this->selectExecute();
    }

    /**
     * ************************************************
     * @Method: Para leitura de múltipas tabelas
     * simultâneas com uso de "INNER_JOIN / LEFT_JOIN".
     * @Param ($Query) : Tabela para ler.
     * @Param ($statements) : Valores para ler.
     * @Note: (LIMIT/OFFSET) São opcionais.
     * ************************************************
     */
    public function selectQueryFull($Query, $statements = null) {
        $this->selectTable = (string) $Query;
        if (!empty($statements)) {
            parse_str($statements, $this->selectFields);
        }
        $this->selectExecute();
    }

    /**
     * ************************************************
     * @Method: Informa quantos resultados que foram
     * encontrados.
     * @Return: (INT) Quantidade de registros
     * ************************************************
     */
    public function selectCount() {
        return ($this->selectSyntax->rowCount());
    }

    /**
     * ************************************************
     * @Method: Informa os resultados que foram
     * encontrados.
     * @Return: (ARRAY/BOLL) Resultados em String/NULL
     * ************************************************
     */
    public function selectResult() {
        return ($this->selectData);
    }
    
    /**
     * ************************************************
     * @Method: Informa erros de consulta.
     * @Return: (STRING/BOLL) Resultado em a partir de
     * PDOException - String/NULL
     * ************************************************
     */
    public function selectError() {
        return ($this->selectError);
    }

    /**
     * ************************************************
     * @Method: Constroi a Syntax para query.
     * Altomaticamente detecta o uso de vinculos
     * atribuitivos de resultado (LIMIT/OFFSET) e
     * trata os mesmos como INTEGER.
     * ************************************************
     */
    private function selectConstruct() {
        if ($this->selectFields) {
            foreach ($this->selectFields as $type => $value) {
                if ($type == 'limit' || $type == 'offset') {
                    $value = (int) $value;
                }
                $this->selectSyntax->bindValue(":{$type}", $value, (is_int($value) ? PDO::PARAM_INT : PDO::PARAM_STR));
            }
        }
    }

    /**
     * ************************************************
     * @Method: Inicia a conexão e faz o
     * Prepare Statements.
     * ************************************************
     */
    private function selectConnect() {
        $this->selectConn = parent::callConnect();
        $this->selectSyntax = $this->selectConn->prepare($this->selectTable);
        $this->selectSyntax->setFetchMode(PDO::FETCH_OBJ);
    }

    /**
     * ************************************************
     * @Method: Executa os métodos e obtem os
     * resultados.
     * @Return: (EXCEPTION) TRUE or FALSE
     * ************************************************
     */
    private function selectExecute() {
        $this->selectConnect();
        try {
            $this->selectConstruct();
            $this->selectSyntax->execute();
            $this->selectData = $this->selectSyntax->fetchAll();
        } catch (PDOException $error) {
            $this->selectData = null;
            $this->selectError = "Erro ao ler dados: {$error->getMessage()} {$error->getCode()}";
        }
    }

}

 

 

Hora! Mas isso é muito coisa para fazer um simples select! (Todo mundo que não conhece as boas da orientação a objetos pensa assim)

Bem essa classe não faz só um simples select, com ela é possível passar qualquer tipo de leitura do banco de forma bem prática.

Spoiler

$read = new Select();
$read->selectQuery("crudpdo", "nome = :datalogin", "datalogin=Chaves");

 

 

 

 

Bem eu fico por aqui, como disse o guia era só um "basicão" para introdução a PDO. espero que tenham apreciado a leitura, e que tenha sido de ajuda isso. Mas se não apreciou nem ajudou fico grato por ter lido.

 

Comentários, criticas... Fiquem a vontade