Como construir um backend para PHP?

40min
Introdução
Neste tutorial, você aprenderá como construir um backend para PHP usando o Back4App para alimentar uma aplicação web dinâmica no lado do servidor. 
Focaremos na integração de serviços chave do Back4App, como gerenciamento de banco de dados, Funções de Cloud Code, APIs REST e GraphQL, autenticação de usuários e consultas em tempo real. 
Seguindo estas etapas, você criará um backend seguro, escalável e robusto que pode usar em seus projetos PHP.
Também veremos por que o Back4App acelera o desenvolvimento de backend em comparação a construir tudo do zero, para que você possa economizar tempo e esforço. 
Você descobrirá como implementar segurança avançada, agendar tarefas com Cloud Jobs e conectar integrações externas com webhooks, tudo isso enquanto confia na infraestrutura do Back4App.
Ao final, você estará pronto para expandir este backend básico do lado do servidor em uma configuração completa de produção, ou integrar APIs de terceiros e lógica personalizada para uso no mundo real.
Pré-requisitos
Para completar este tutorial, você precisará:
Uma conta Back4app e um novo projeto Back4App
Introdução ao Back4app.
Se você não tiver uma conta, crie uma gratuitamente e siga o guia para preparar seu novo projeto.
Ambiente básico de desenvolvimento PHP
Você pode configurá-lo localmente com PHP instalado ou usar um ambiente de hospedagem que suporte PHP.
Documentação Oficial do PHP.﻿
Suporte a cURL ou uma maneira de enviar requisições HTTP
A maioria das instalações do PHP inclui cURL por padrão.
Instalando cURL (Documentos Oficiais).﻿
Familiaridade com os fundamentos de aplicações web
Entender HTTP, scripting do lado do servidor e conceitos básicos de banco de dados será útil.
Certifique-se de ter esses pré-requisitos em ordem antes de mergulhar nos passos abaixo. Ter seu projeto Back4App configurado e um ambiente PHP pronto facilitará o acompanhamento.
Passo 1 – Configurando o Projeto Back4App
Criar um Novo Projeto
O primeiro passo para construir seu backend do lado do servidor no Back4App é criar um novo projeto. Se você ainda não fez isso, siga estes passos:
Faça login na sua conta Back4App.
Clique no botão “Novo App” no seu painel do Back4App.
Dê um nome ao seu app (por exemplo, “PHP-Backend-Tutorial”).
﻿
Uma vez criado, seu novo projeto Back4App aparecerá no painel. Este projeto será a base para os próximos passos de configuração.
Conectar ao Back4App via REST API
Como estamos trabalhando com PHP sem um SDK específico do Parse, vamos depender das APIs REST e GraphQL do Back4App para comunicação. Você precisará das seguintes credenciais do seu painel do Back4App:
ID da Aplicação
Chave da API REST
URL do Parse Server (geralmente https://parseapi.back4app.com)
Você pode encontrar isso navegando até as Configurações do App ou a seção Segurança e Chaves.
﻿
Em PHP, você pode realizar requisições HTTP usando cURL ou outras bibliotecas. Abaixo está um exemplo curto de como enviar uma requisição POST para o Back4App:
PHP
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array(
  'title' => 'Buy groceries',
  'isCompleted' => false
);
$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'X-Parse-Application-Id: YOUR_APPLICATION_ID',
  'X-Parse-REST-API-Key: YOUR_REST_API_KEY',
  'Content-Type: application/json'
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

echo $result; // Print API response
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array(
  'title' => 'Buy groceries',
  'isCompleted' => false
);
$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'X-Parse-Application-Id: YOUR_APPLICATION_ID',
  'X-Parse-REST-API-Key: YOUR_REST_API_KEY',
  'Content-Type: application/json'
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

echo $result; // Print API response
﻿
Este trecho demonstra como conectar sua aplicação PHP ao seu backend do Back4App. Modifique o YOUR_APPLICATION_ID, YOUR_REST_API_KEY, e outros parâmetros para corresponder às suas próprias chaves. Ao fazer isso, seu código do lado do servidor pode ler e gravar dados em seu novo projeto.
Passo 2 – Configurando o Banco de Dados
Criando um Modelo de Dados
Com seu projeto Back4App pronto, é hora de estruturar seu banco de dados. Um modelo de dados define como os dados da sua aplicação web são organizados. Por exemplo, você pode armazenar tarefas ou postagens de blog em classes.
Vá para a seção “Banco de Dados” no seu painel do Back4App.
Crie uma nova classe (por exemplo, “Todo”) com campos como título (String) e estáCompleto (Boolean).
Criar Nova Classe
﻿
O Back4App permite que você crie colunas para vários tipos de dados, incluindo String, Número, Booleano, Ponteiro, Relação, Arquivo, e outros. Você também pode permitir que o esquema seja criado automaticamente quando você salva um objeto pela primeira vez a partir do seu script PHP.
Criar Coluna
﻿
Criando um Modelo de Dados Usando o Agente de IA
O Agente de IA da Back4App pode automatizar a criação de modelos de dados:
Abra o Agente de IA no Painel.
Forneça uma descrição como “Por favor, crie um novo aplicativo ToDo no Back4App com um esquema de classe completo.”
Deixe o Agente de IA criar o esquema do banco de dados para você.
﻿
Esse recurso pode economizar seu tempo e manter seu aplicativo do lado do servidor consistente.
Lendo e Escrevendo Dados (REST API)
Para salvar um novo objeto na sua Todo classe usando REST, você pode enviar uma solicitação POST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
Em PHP, você faria algo semelhante com cURL. Por exemplo:
PHP
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array('title' => 'Buy groceries', 'isCompleted' => false);
// ... (same cURL setup as before)
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array('title' => 'Buy groceries', 'isCompleted' => false);
// ... (same cURL setup as before)
﻿
Para consultar todos os itens existentes Todo :
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  https://parseapi.back4app.com/classes/Todo
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  https://parseapi.back4app.com/classes/Todo
﻿
Lendo e Escrevendo Dados (API GraphQL)
Back4App também suporta GraphQL. Você pode inserir ou recuperar dados enviando consultas ou mutações GraphQL para:
Text
https://parseapi.back4app.com/graphql
https://parseapi.back4app.com/graphql
﻿
Inserir (Mutação):
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
Consulta:
GraphQL
query {
  todos {
    edges {
      node {
        objectId
        title
        isCompleted
      }
    }
  }
}
query {
  todos {
    edges {
      node {
        objectId
        title
        isCompleted
      }
    }
  }
}
﻿
Trabalhando com Consultas Ao Vivo (opcional)
Se você precisar de atualizações em tempo real em sua aplicação web, considere Consultas Ao Vivo. Ative Consultas Ao Vivo no seu painel do Back4App, e então use uma abordagem WebSocket do seu ambiente PHP (ou um cliente separado) para se inscrever em mudanças. Embora seja mais comum em clientes JavaScript, você pode configurar sockets separados em PHP, se necessário. Para detalhes, veja a Documentação de Consultas Ao Vivo do Back4App.﻿
Passo 3 – Aplicando Segurança com ACLs e CLPs
Visão Geral
ACLs (Listas de Controle de Acesso) e CLPs (Permissões de Nível de Classe) protegem seus dados controlando quem pode ler ou escrever objetos. Isso protege seu backend de acessos não autorizados.
﻿
Passo a Passo
Defina Permissões de Nível de Classe (CLPs) no painel do Banco de Dados. Você pode restringir leitura/escrita pública ou exigir autenticação.
Configure ACLs em cada objeto se você precisar de controle mais granular. Uma ACL pode especificar acesso de leitura/escrita para um usuário ou função específica.
Para mais detalhes, veja Diretrizes de Segurança do App.﻿
Passo 4 – Escrevendo Funções de Código em Nuvem
Por que Código em Nuvem
O Código em Nuvem permite que você execute JavaScript do lado do servidor para tarefas como lógica de negócios, gatilhos ou validações, sem precisar configurar seu próprio servidor. Dessa forma, você pode manter certo código oculto, realizar transformações de dados e mais.
Função de Exemplo
Uma função simples de Código em Nuvem que calcula o comprimento do texto:
JS
// main.js
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
Esta função pode ser invocada a partir do seu script PHP usando REST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
﻿
Implantação
Você pode implantar o Cloud Code via o Back4App CLI ou o Painel do Back4App.
Módulos NPM
Se você precisar de bibliotecas extras, instale-as com npm e importe-as no seu Cloud Code. Isso é útil para integrações avançadas do lado do servidor.
Passo 5 – Configurando a Autenticação
Ativar Autenticação
Por padrão, seu projeto Back4App tem autenticação de usuário via a Parse.User classe. Você pode controlar se os usuários devem verificar seu e-mail ou apenas fazer login via nome de usuário/senha.
Cadastrar, Fazer Login, Sair (REST)
Criar um usuário:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "alice","password": "secret123","email": "alice@example.com"}' \
  https://parseapi.back4app.com/users
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "alice","password": "secret123","email": "alice@example.com"}' \
  https://parseapi.back4app.com/users
﻿
Fazer login de um usuário existente:
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
﻿
Login Social
Logins sociais (Google, Apple, Facebook) são possíveis configurando fluxos OAuth. Para instruções, consulte os Documentos de Login Social.﻿
Passo 6 – Gerenciamento de Armazenamento de Arquivos
Configurando o Armazenamento de Arquivos
Você pode enviar arquivos através do REST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@/path/to/myImage.jpg" \
  https://parseapi.back4app.com/files/myImage.jpg
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@/path/to/myImage.jpg" \
  https://parseapi.back4app.com/files/myImage.jpg
﻿
A resposta JSON contém uma URL de arquivo. Você pode armazenar essa URL em suas classes para referenciar o arquivo enviado.
Exemplo
Bash
{
  "name": "myImage.jpg",
  "url": "https://myapp.back4app.io/files/myImage.jpg"
}
{
  "name": "myImage.jpg",
  "url": "https://myapp.back4app.io/files/myImage.jpg"
}
﻿
Considerações de Segurança
Você pode permitir uploads de arquivos apenas de usuários autenticados ou de certos papéis. Configure as regras de upload de arquivos nas configurações do servidor.
Passo 7 – Verificação de Email e Redefinição de Senha
Visão Geral
A verificação de email garante que apenas endereços de email válidos sejam usados. As redefinições de senha permitem que os usuários recuperem suas contas de forma segura.
Configuração do Painel
No Painel do Back4App, vá para Configurações do App > Email.
Ative a verificação de email e configure seus modelos desejados.
Ative a redefinição de senha para que os usuários possam recuperar contas.
Implementação
Uma vez ativado, as inscrições de usuários acionam um e-mail de verificação. Você também pode solicitar redefinições de senha usando:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@example.com"}' \
  https://parseapi.back4app.com/requestPasswordReset
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@example.com"}' \
  https://parseapi.back4app.com/requestPasswordReset
﻿
Passo 8 – Agendando Tarefas com Cloud Jobs
O que os Cloud Jobs fazem
Os Cloud Jobs permitem que você automatize tarefas como remover dados antigos ou enviar e-mails regulares. Você pode escrevê-los em seu main.js e agendá-los no painel do Back4App.
Exemplo
JS
// main.js
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
// main.js
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
﻿
Implante este código no Back4App.
Agende o trabalho no Painel sob Configurações do App > Configurações do Servidor > Tarefas em Segundo Plano.
Agendando um Trabalho na Nuvem
﻿
Passo 9 – Integrando Webhooks
Definição
Webhooks permitem que você envie requisições HTTP para outros serviços quando eventos ocorrem, como a criação de um novo registro em suas classes do Back4App. Isso é útil para integrações externas, incluindo plataformas de pagamento, ferramentas de marketing por e-mail ou notificações do Slack.
Configuração
Abra o Webhooks painel no seu painel do Back4App > Mais > WebHooks.
Adicione um novo Webhook com a URL do endpoint onde você deseja enviar os dados do evento.
Escolha os gatilhos (por exemplo, criação, atualização ou exclusão de objeto).
Adicionando um Webhook
﻿
Você também pode definir webhooks em Cloud Code gatilhos, fazendo requisições HTTP com módulos Node.js como axios.
BeforeSave WebHook
﻿
Passo 10 – Explorando o Painel de Administração do Back4App
O Back4App Admin App é uma interface centrada em modelos que permite a usuários não técnicos ou administradores gerenciar dados sem escrever código. Oferece uma experiência de manuseio de dados mais intuitiva do que o painel padrão do Parse.
Onde Encontrá-lo
Ativar o App de Administração indo para App Dashboard > Mais > App de Administração.
Clique em “Ativar App de Administração” e configure suas credenciais de administrador.
Escolha um subdomínio para acessar o App de Administração.
Ativar App de Administração
﻿
﻿
Faça login com suas novas credenciais de administrador para começar a gerenciar registros de banco de dados, contas de usuário, funções e mais.
﻿
Conclusão
Neste tutorial, você aprendeu como construir um backend do lado do servidor para sua PHP aplicação web usando o Back4App. Você configurou um banco de dados seguro, aproveitou recursos em tempo real, definiu lógica personalizada no Cloud Code e explorou autenticação de usuários, armazenamento de arquivos e tarefas agendadas. Você também viu como webhooks e o Painel de Administração podem se integrar a serviços externos e simplificar a gestão de dados.
Com essa base em vigor, você tem um backend flexível e escalável que pode ser estendido conforme necessário para seu próximo projeto em PHP. Continue explorando técnicas avançadas, funções personalizadas ou APIs de terceiros para tornar sua aplicação ainda mais poderosa e dinâmica.
Próximos Passos
Refine sua aplicação PHP pronta para produção adicionando cache, balanceamento de carga ou segurança avançada.
Adicione controle de acesso baseado em funções ou fluxos de autenticação únicos, se sua base de usuários exigir.
Consulte a documentação oficial do Back4App para saber mais sobre ajuste de desempenho, logs e análises.
Experimente tutoriais adicionais e use as técnicas aprendidas aqui para construir soluções do mundo real, desde e-commerce até plataformas sociais.
﻿
Como Construir um Backend para Dart?
Como construir um backend para Xamarin?