Quickstarters
Как построить бекенд для Symfony?

28min
Введение
В этом учебном пособии вы узнаете как создать бэкенд для Symfony с использованием Back4App. 
Мы покажем вам, как использовать мощные функции Back4App, включая управление базами данных, Cloud Code, REST и GraphQL API, чтобы создать безопасный, масштабируемый и эффективный бэкенд, который будет работать без сбоев с вашим приложением Symfony. 
Вы также узнаете, как обрабатывать аутентификацию пользователей, хранение файлов и обновления в реальном времени с помощью Live Queries (если это применимо к вашей архитектуре).
Используя быстрое развертывание и интуитивно понятную платформу Back4App, вы сэкономите время и усилия по сравнению с ручным управлением серверами и базами данных. 
Вы получите практический опыт в области расширенной безопасности, планирования задач с помощью Cloud Jobs, настройки вебхуков и других важных функций для надежной разработки бэкенда.
После завершения этого учебника вы сможете уверенно расширять или настраивать свой Symfony бэкенд для продакшена, интегрировать внешние API и добавлять сложную бизнес-логику по мере необходимости.
Предварительные требования
Аккаунт Back4app
Зарегистрируйтесь бесплатно здесь.
Новый проект Back4app
Начало работы с Back4app.
Настройка, специфичная для Symfony
Убедитесь, что у вас установлена Symfony, и что PHP и Composer готовы.
Базовые знания Symfony
Знание контроллеров, сервисов и шаблонов будет полезным. Официальная документация Symfony.
Node.js (по желанию, для некоторых инструментов сборки)
Если вы планируете использовать инструменты на базе Node для фронтенд-задач, установите Node.js.
Убедитесь, что ваша среда Symfony и проект Back4App настроены перед началом. Это поможет вам без проблем следовать шагам.
Шаг 1 – Создание нового проекта на Back4App и подключение
Создайте проект Back4App:
Войдите в свою учетную запись Back4App.
Нажмите на “Новое приложение” на панели управления.
Назовите его (например, “Symfony-Backend-Tutorial”).
﻿
После создания он появится на вашей панели управления Back4App. Этот проект является вашей основой для бэкенда.
Подключитесь с помощью REST или GraphQL:
В настройках вашего приложения “Настройки приложения” или “Безопасность и ключи” найдите ваш Идентификатор приложения и Ключ REST API (и конечную точку GraphQL, если вы планируете использовать GraphQL).
Запишите ваш URL-адрес Parse Server (например, https://parseapi.back4app.com).
Поскольку Symfony не имеет родного SDK Parse, вам придется полагаться на HTTP-клиент Symfony или библиотеку, такую как Guzzle, для взаимодействия с REST или GraphQL API Back4App.
﻿
Ниже приведен пример использования Symfony HttpClient:
PHP
// src/Service/Back4AppClient.php

namespace App\Service;

use Symfony\Component\HttpClient\HttpClient;

class Back4AppClient
{
    private $appId;
    private $restKey;
    private $baseUrl;

    public function __construct(string $appId, string $restKey, string $baseUrl)
    {
        $this->appId = $appId;
        $this->restKey = $restKey;
        $this->baseUrl = $baseUrl;
    }

    public function createObject(string $className, array $data)
    {
        $client = HttpClient::create();
        $response = $client->request('POST', $this->baseUrl.'/classes/'.$className, [
            'headers' => [
                'X-Parse-Application-Id' => $this->appId,
                'X-Parse-REST-API-Key'   => $this->restKey,
                'Content-Type'          => 'application/json'
            ],
            'json' => $data,
        ]);
        return $response->toArray();
    }
}
// src/Service/Back4AppClient.php

namespace App\Service;

use Symfony\Component\HttpClient\HttpClient;

class Back4AppClient
{
    private $appId;
    private $restKey;
    private $baseUrl;

    public function __construct(string $appId, string $restKey, string $baseUrl)
    {
        $this->appId = $appId;
        $this->restKey = $restKey;
        $this->baseUrl = $baseUrl;
    }

    public function createObject(string $className, array $data)
    {
        $client = HttpClient::create();
        $response = $client->request('POST', $this->baseUrl.'/classes/'.$className, [
            'headers' => [
                'X-Parse-Application-Id' => $this->appId,
                'X-Parse-REST-API-Key'   => $this->restKey,
                'Content-Type'          => 'application/json'
            ],
            'json' => $data,
        ]);
        return $response->toArray();
    }
}
﻿
Эта служба поможет вам делать запросы к вашему Back4App бэкенду из Symfony.
Шаг 2 – Настройка базы данных
Создание модели данных
На Back4App вы определите классы (таблицы), которые будут хранить ваши данные. Допустим, вы хотите класс Todo для хранения задач:
Перейдите к базе данных в вашей панели управления Back4App.
Создайте новый класс “Todo” и добавьте поля, такие как title (String) и isCompleted (Boolean).
Создать новый класс
﻿
В качестве альтернативы, позвольте Back4App AI Agent создать вашу модель данных:
Откройте AI Agent в вашей панели управления проектом.
Опишите вашу модель данных (например, “Создайте класс Todo с полями title и isCompleted.”).
Сгенерируйте схему автоматически.
﻿
Чтение и запись данных с использованием REST
Чтобы создать новый Todo из контроллера Symfony, вы можете сделать:
PHP
use App\Service\Back4AppClient;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Routing\Annotation\Route;

class TodoController extends AbstractController
{
    #[Route('/todo/new', name: 'new_todo')]
    public function new(Back4AppClient $client)
    {
        $data = [
            'title' => 'Buy groceries',
            'isCompleted' => false
        ];
        $result = $client->createObject('Todo', $data);
        
        return $this->json($result);
    }
}
use App\Service\Back4AppClient;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Routing\Annotation\Route;

class TodoController extends AbstractController
{
    #[Route('/todo/new', name: 'new_todo')]
    public function new(Back4AppClient $client)
    {
        $data = [
            'title' => 'Buy groceries',
            'isCompleted' => false
        ];
        $result = $client->createObject('Todo', $data);
        
        return $this->json($result);
    }
}
﻿
Для запросов, используйте GET-запрос с вашими учетными данными:
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
﻿
Чтение и запись данных с использованием GraphQL
Вы также можете интегрировать GraphQL в Symfony, используя библиотеку клиента GraphQL. Пример мутации для создания Todo выглядит так:
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the kitchen"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the kitchen"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
Работа с живыми запросами (необязательно)
Если вашему приложению Symfony нужны данные в реальном времени, вы можете интегрировать Живые запросы в более фронтенд или реальном времени микросервисном контексте. Настройте Живые запросы в Настройках сервера на Back4App, затем подключите клиент WebSocket. Symfony может реагировать на эти обновления или транслировать их через отдельный слой реального времени, если это необходимо.
Шаг 3 – Применение безопасности с помощью ACL и CLP
ACL (Списки контроля доступа)
ACL позволяют вам контролировать, кто может читать или записывать объект. Например, вы можете применить ACL в коде при создании данных с помощью REST API, добавив поля _ACL в ваш JSON. Например:
JSON
{
  "title": "Private Task",
  "isCompleted": false,
  "_ACL": {
    "UserObjectIdHere": {
      "read": true,
      "write": true
    }
  }
}
{
  "title": "Private Task",
  "isCompleted": false,
  "_ACL": {
    "UserObjectIdHere": {
      "read": true,
      "write": true
    }
  }
}
﻿
CLP (Разрешения на уровне класса)
Разрешения на уровне класса позволяют вам устанавливать широкие правила доступа для целого класса:
Откройте базу данных в панели управления Back4App.
Выберите свой класс (например, “Todo”).
Перейдите на вкладку Разрешения и настройте доступ на чтение/запись.
﻿
Для получения дополнительной информации посетите Руководство по безопасности приложений.
Шаг 4 – Написание функций облачного кода
Облачный код позволяет вам запускать безопасный серверный JavaScript без управления инфраструктурой. Хотя Symfony написан на PHP, вы все равно можете перенести определенные задачи на Облачный код на Back4App для сложной логики, триггеров и валидаций.
Пример: Проверка задачи перед сохранением
JS
// main.js

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
// main.js

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
﻿
Развертывание
Используйте Back4App CLI или панель управления для развертывания main.js.
Вызывайте ваши облачные функции через REST или GraphQL из ваших сервисов Symfony.
﻿
Шаг 5 – Настройка аутентификации
Управление пользователями в Back4App основывается на классе Parse User . С помощью Symfony вы можете обрабатывать регистрацию пользователей, вход в систему и сброс пароля через вызовы REST или GraphQL.
Регистрация / Вход через REST
Bash
# Sign Up
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": "alex", "password": "symfony123", "email": "[email protected]"}' \
  https://parseapi.back4app.com/users

# Log In
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  --data-urlencode 'username=alex' \
  --data-urlencode 'password=symfony123' \
  https://parseapi.back4app.com/login
# Sign Up
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": "alex", "password": "symfony123", "email": "alex@example.com"}' \
  https://parseapi.back4app.com/users

# Log In
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  --data-urlencode 'username=alex' \
  --data-urlencode 'password=symfony123' \
  https://parseapi.back4app.com/login
﻿
Используйте сервис Symfony для обертывания этих вызовов, если вам нужны программные потоки пользователей.
Социальный вход
Если вы планируете интеграцию входа через Google или Apple, обратитесь к Документации по социальному входу Back4App. Вам нужно будет настроить ваши OAuth приложения и сделать конкретные REST вызовы для завершения аутентификации.
Шаг 6 – Обработка хранения файлов
Загрузка файлов через 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/png" \
  --data-binary '@localImage.png' \
  https://parseapi.back4app.com/files/localImage.png
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/png" \
  --data-binary '@localImage.png' \
  https://parseapi.back4app.com/files/localImage.png
﻿
После загрузки вы получите URL файла. Вы можете сохранить эту ссылку в любом классе (например, Todo) в качестве ссылки на этот файл.
Шаг 7 – Подтверждение электронной почты и сброс пароля
Настройка электронной почты
Перейдите к настройкам электронной почты в Back4App.
Включите проверку электронной почты и шаблоны сброса пароля.
Настройте строки «От» и «Тема» по мере необходимости.
Это гарантирует, что все регистрации требуют подтверждения действительности электронной почты.
Шаг 8 – Планирование задач с помощью облачных заданий
Пример облачного задания
JS
// main.js
Parse.Cloud.job('cleanupOldTodos', async () => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  query.lessThan('createdAt', new Date(now - THIRTY_DAYS));

  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
// main.js
Parse.Cloud.job('cleanupOldTodos', async () => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  query.lessThan('createdAt', new Date(now - THIRTY_DAYS));

  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
﻿
Запланируйте это cleanupOldTodos задание в вашей панели управления Back4App для ежедневного выполнения, улучшая управление данными.
Шаг 9 – Интеграция вебхуков
Вебхуки позволяют Back4App отправлять HTTP-запросы на внешние сервисы. Например, вы можете отправлять уведомления на конечную точку Slack каждый раз, когда создается новая Todo задачу:
Перейдите в Разное > Вебхуки в вашей панели управления Back4App.
Добавьте вебхук с указанием вашей внешней конечной точки.
Запустите событие при создании объекта в классе Todo.
Добавление вебхука
﻿
Шаг 10 – Изучение панели администратора Back4App
Используйте Back4App Admin App для удобного интерфейса управления данными:
Включите Admin App из App Dashboard > More > Admin App.
Создайте администратора с безопасным именем пользователя и паролем.
Назначьте пользовательский поддомен для легкого доступа.
Включите Admin App
﻿
Эта функция помогает не техническим членам команды просматривать и управлять записями, не углубляясь в код.
Заключение
Вы узнали как создать бэкенд для Symfony с использованием Back4App. Это включало:
Создание нового проекта на Back4App в качестве основы.
Настройка базы данных с классами, полями и отношениями.
Защита данных с помощью ACL и CLP.
Использование Cloud Code для серверной логики.
Управление аутентификацией пользователей (регистрация, вход, сброс пароля).
Обработка хранения файлов с помощью REST API.
Настройка Cloud Jobs для периодических задач.
Интеграция вебхуков для подключения внешних сервисов.
Навигация по панели администратора Back4App для удобного управления данными.
Эти шаги предоставляют вам надежную основу для создания и масштабирования вашего приложения Symfony. Расширяйте эту архитектуру, чтобы обрабатывать более сложную логику, интегрировать платежные шлюзы или добавлять расширенные функции безопасности. С Back4App вы экономите время и усилия на хостинг и инфраструктуру, чтобы сосредоточиться на предоставлении наилучшего пользовательского опыта.
Следующие шаги
Создайте готовое к производству приложение Symfony путем настройки вашего бэкенда Back4App для более высокого трафика и продвинутых потребностей в производительности.
Интегрируйте расширенные функции такие как доступ на основе ролей, аналитика или сторонние API для платежей.
Изучите официальную документацию Back4App для более глубокого понимания безопасности, журналов и мониторинга.
Посмотрите больше учебников чтобы объединить этот бэкенд с сервисами в реальном времени или создать динамические веб-сайты с живыми обновлениями.
Следуя этим стратегиям, ваш проект Symfony получает мощный и эффективный бэкенд. Используйте Back4App для упрощения обслуживания и быстрого развития возможностей вашего приложения. Удачи в создании вашего следующего шедевра Symfony!
Обновлено 23 Jan 2025
Помогла ли вам эта страница?
Как создать бэкенд для Golang?
Как создать бэкенд для Ionic?