No desenvolvimento moderno, as APIs RESTful se tornaram um padrão para comunicação entre aplicações. Essas interfaces facilitam a interoperabilidade e a flexibilidade em diversas plataformas. Este tutorial foi desenvolvido para guiá-lo na criação de uma API RESTful usando PHP e MySQL, com foco na implementação completa das operações CRUD (Criar, Ler, Atualizar, Excluir).
Compreendendo a Abordagem RESTful
Antes de nos aprofundarmos na implementação técnica, é essencial entender o que RESTful realmente significa. As APIs REST usam HTTP para executar operações, respeitando verbos como GET, POST, PUT e DELETE. Isso não apenas padroniza as ações dentro de uma API, mas também adiciona simplicidade e facilidade de uso.
Ao contrário de outras arquiteturas, como SOAP, as APIs REST são normalmente mais leves e menos complexas de implementar. Seu design é baseado em recursos representados por URLs exclusivas.
Estrutura do Projeto
Nosso aplicativo consistirá em vários arquivos que gerenciarão diferentes partes do código:
| Arquivo | Função |
|---|---|
| db.php | Lida com conexões com o MySQL. |
| api.php | Ponto de entrada principal para lidar com solicitações HTTP. |
| model.php | Lógica de negócios e acesso ao banco de dados. |
| index.php | Página principal do cliente web (opcional). |
Configurando o Ambiente
Certifique-se de ter um servidor web como Apache ou Nginx configurado junto com PHP e MySQL. Você pode usar soluções como XAMPP, WAMP ou LAMP, dependendo do seu sistema operacional. Além disso, certifique-se de ter um IDE ou editor de texto como o Visual Studio Code ou o Sublime Text configurado corretamente para escrever seu código.
Conectando ao MySQL
Crie um arquivo chamado db.php. Este arquivo será onde estabeleceremos a conexão com nosso banco de dados:
<?php
$host = localhost;
$db = api_database;
$user = root;
$pass = ;
$charset = utf8mb4;
$dsn = "mysql:host=$host;dbname=$db;charset=$charset";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
?>
Criação de modelo RESTful
Crie um arquivo model.php. Aqui cuidaremos de todas as interações com nosso banco de dados. Certifique-se de incluir funções para cada operação CRUD:
<?php
// Buscar todos os registros
function getAllItems($pdo) {
$stmt = $pdo->query(SELECT * FROM items);
return $stmt->fetchAll();
}
// Funções adicionais para criar, atualizar e excluir registros
?>
Manipulando solicitações com api.php
Nosso arquivo principal, api.php, será responsável por manipular as solicitações HTTP recebidas, direcionando-as ao modelo apropriado para processamento:
<?php
// Código para manipular GET, POST, PUT, DELETE
// Com base no HTTP recebido verbo, encaminhar para as funções apropriadas
?>
Ao concluir essas etapas, você terá uma API funcional usando PHP e MySQL que segue os princípios RESTful. Isso não apenas melhora a organização do código, mas também facilita a expansão futura caso você decida integrar camadas adicionais, como autenticação ou validações avançadas.