Acervo.estudos
Trilhas Enviar material Entrar
mapa · Intermediário

4.3 MySQL no projeto

Criação do banco sistema_php e da tabela usuarios para a API: utf8mb4, collation, UNIQUE, TIMESTAMP automático e um usuário MySQL próprio com privilégios mínimos.

por @julio · rev. 23 set · 4 telas

sistema_php e a tabela usuarios

O banco da API

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
CREATE DATABASE IF NOT EXISTS sistema_php
    CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
USE sistema_php;

CREATE TABLE IF NOT EXISTS usuarios (
    id        INT AUTO_INCREMENT PRIMARY KEY,
    nome      VARCHAR(100) NOT NULL,
    email     VARCHAR(120) NOT NULL UNIQUE,
    criado_em TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);

INSERT INTO usuarios (nome, email) VALUES
    ('Ana Souza',      'ana.souza@ifrs.edu.br'),
    ('Bruno Carvalho', 'bruno.carvalho@ifrs.edu.br');

A aula usa utf8mb4_general_ci, que funciona. No MySQL 8 o padrão é utf8mb4_0900_ai_ci, baseada numa versão mais nova do Unicode. Os dois nomes terminam em ci (case-insensitive) e ignoram acentos.

Como o texto é guardado e comparado

Charset e collation

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
SELECT 'Joao' = 'JOÃO' COLLATE utf8mb4_general_ci;  -- 1 (igual)
SELECT 'Joao' = 'JOÃO' COLLATE utf8mb4_0900_ai_ci;  -- 1 (igual)
SELECT 'Joao' = 'JOÃO' COLLATE utf8mb4_0900_as_ci;  -- 0 (acento conta)

⚠ A página original descreve utf8mb4_general_ci como a collation que compara "ignorando diferenças entre maiúsculas e minúsculas". Ela também ignora acentos: 'Joao' = 'JOÃO' é verdadeiro.

⚠ O banco é criado em utf8mb4, mas o Database.php da aula 4.2 conecta com charset=utf8 (utf8mb3). Com essa conexão, inserir um nome com emoji falha com 1366 Incorrect string value. Use charset=utf8mb4 no DSN.

Não conecte a API como root

Um usuário do banco só para a aplicação

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
CREATE USER 'app_php'@'localhost' IDENTIFIED BY 'uma-senha-forte';
GRANT SELECT, INSERT, UPDATE, DELETE ON sistema_php.* TO 'app_php'@'localhost';
<?php
// config/database.php (no .gitignore)
return [
    'dsn'  => 'mysql:host=localhost;dbname=sistema_php;charset=utf8mb4',
    'user' => 'app_php',
    'pass' => 'uma-senha-forte',
];

No Linux e no macOS, host localhost faz o driver usar o socket Unix; se a conexão falhar, troque por 127.0.0.1 (TCP) e confira a porta (port=3306 no DSN).

Teste antes de seguir

Revisão rápida

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
Qual a diferença entre charset e collation?

Charset define como os caracteres são gravados (utf8mb4); collation define como são comparados e ordenados (maiúsculas, acentos).

Com utf8mb4_0900_ai_ci, WHERE nome = 'jose' encontra "José"?

Sim: a collation ignora maiúsculas (ci) e acentos (ai).

Que erro o MySQL dá ao inserir um e-mail repetido nessa tabela, e como a API deve responder?

Erro 1062 (Duplicate entry). A API deve capturar e responder 409 Conflict.

Por que não usar root na aplicação?

Porque root tem poder total no servidor. Um usuário só com SELECT, INSERT, UPDATE e DELETE no banco da aplicação limita o dano de um vazamento ou de um bug.

← Voltar ao curso