Шаблон бэкенда приложения Todo
PHP — Схема, API и руководство по AI

Ключевые выводы

Обзор

Todo приложение — это одна из самых распространенных отправных точек для изучения разработки бэкенда. Внутри оно требует регистрации пользователей, CRUD задач, контроля доступа на основе владения и, опционально, синхронизации в реальном времени.

Схема ниже определяет два класса — _User (встроенный) и Todo — соединенные указателем. С помощью Back4app PHP SDK вы можете взаимодействовать с этим бэкендом из вашего приложения — запрашивать, создавать, обновлять и удалять объекты — без написания пользовательского API слоя.

Почему стоит создать ваш PHP Todo бэкенд с Back4app?

Back4app предоставляет готовый бэкенд и типизированный SDK, чтобы вы могли создать ваше Todo приложение без написания REST glue или управления аутентификацией самостоятельно.

• •SDK и безопасность типов: SDK обеспечивает безопасность типов для Todo и User и обрабатывает JSON, так что вам нужно писать меньше шаблонного кода.
• •Асинхронный и необязательный оффлайн: Используйте async/await; поддерживаемые SDK предлагают локальную привязку, чтобы ваш список мог работать в оффлайне и синхронизироваться при возвращении в онлайн.
• •Live Queries: Подписывайтесь на изменения Todo, чтобы интерфейс обновлялся в реальном времени через WebSockets.

Одна и та же схема и API для каждого стека — переключайте клиентов позже, не меняя бэкенд.

Основные преимущества

Готовый к производству бэкенд для Todo, чтобы вы могли быстрее запускать и сосредоточиться на своем приложении.

Технический стек

Все, что поддерживает этот шаблон приложения Todo, одним взглядом.

ER-диаграмма

Диаграмма «Сущность-Связь» для модели данных приложения PHP Todo.

erDiagram
    _User {
        String objectId PK
        String username
        String email
        String password
        Date createdAt
        Date updatedAt
    }

    Todo {
        String objectId PK
        String title
        Boolean done
        Date dueDate
        Number priority
        Pointer owner FK
        Date createdAt
        Date updatedAt
    }

    _User ||--o{ Todo : "owns"

Поток интеграции

Последовательность Auth-to-CRUD: как ваше PHP приложение взаимодействует с Back4app — вход в систему, затем запрос и создание задач.

sequenceDiagram
  participant User
  participant App as PHP App
  participant Back4app as Back4app REST API

  User->>App: Login
  App->>Back4app: POST /login (username, password)
  Back4app-->>App: sessionToken
  App-->>User: Logged in

  User->>App: Load todos
  App->>Back4app: GET /classes/Todo (X-Parse-Session-Token)
  Back4app-->>App: results[]
  App-->>User: Show list

  User->>App: Create todo
  App->>Back4app: POST /classes/Todo
  Back4app-->>App: objectId, createdAt
  App-->>User: Updated list

Словарь данных

Полная справка по полям для каждого класса в схеме.

Безопасность и разрешения

Как владение, ACL и разрешения на уровне класса защищают данные в этой схеме.

Схема (JSON)

Сырая схема JSON — скопируйте и используйте в своем приложении Back4app или импортируйте через API.

{
  "classes": [
    {
      "className": "Todo",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "title": {
          "type": "String",
          "required": true
        },
        "done": {
          "type": "Boolean",
          "required": false,
          "defaultValue": false
        },
        "dueDate": {
          "type": "Date",
          "required": false
        },
        "priority": {
          "type": "Number",
          "required": false,
          "defaultValue": 3
        },
        "owner": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "_User",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "username": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": true
        },
        "password": {
          "type": "String",
          "required": true
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    }
  ]
}

API Playground

Попробуйте REST и GraphQL конечные точки для схемы Todo. Ответы из приведенных выше примерных данных — учетная запись Back4app не требуется.

Использует ту же схему Todo, что и этот шаблон.

Пошаговая интеграция PHP

Подключитесь к вашему Back4app бэкенду из PHP приложения, используя Back4app PHP SDK.

1. Шаг 1: Установите Back4app PHP SDK

   Добавьте Back4app SDK для вашего стека (например, npm, pubspec или менеджер пакетов).

   PHP

   Копировать

   1

   composer require guzzlehttp/guzzle

2. Шаг 2: Инициализируйте Back4app в вашем приложении

   Инициализируйте Back4app SDK при запуске приложения с вашим App ID и URL сервера.

   PHP

   Копировать

   1

   2

   3

   4

   5

   // Initialize (e.g. bootstrap or config)
   $baseUrl = 'https://parseapi.back4app.com';
   $appId = getenv('PARSE_APP_ID');
   $restKey = getenv('PARSE_REST_KEY');
   $sessionToken = null; // set after login

3. Шаг 3: Запросите все задачи

   Используйте SDK для получения всех объектов Todo, отсортированных по приоритету.

   PHP

   Копировать

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   // GET /classes/Todo
   function getTodos(string $baseUrl, string $appId, string $restKey, ?string $sessionToken): array {
       $client = new \GuzzleHttp\Client();
       $headers = [
           'X-Parse-Application-Id' => $appId,
           'X-Parse-REST-API-Key'   => $restKey,
           'Content-Type' => 'application/json',
       ];
       if ($sessionToken) $headers['X-Parse-Session-Token'] = $sessionToken;
       $res = $client->get($baseUrl . '/classes/Todo?order=priority', ['headers' => $headers]);
       $body = json_decode($res->getBody()->getContents(), true);
       return $body['results'] ?? [];
   }

4. Шаг 4: Создайте задачу

   Создайте новую задачу Todo с заголовком, статусом выполнения и приоритетом, затем сохраните.

   PHP

   Копировать

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   // POST /classes/Todo
   function createTodo(string $baseUrl, string $appId, string $restKey, string $sessionToken, string $title, int $priority = 3): array {
       $client = new \GuzzleHttp\Client();
       $res = $client->post($baseUrl . '/classes/Todo', [
           'headers' => [
               'X-Parse-Application-Id' => $appId,
               'X-Parse-REST-API-Key'   => $restKey,
               'X-Parse-Session-Token'  => $sessionToken,
               'Content-Type' => 'application/json',
           ],
           'json' => ['title' => $title, 'done' => false, 'priority' => $priority],
       ]);
       return json_decode($res->getBody()->getContents(), true);
   }

5. Шаг 5: Обновление и удаление задач

   Обновите поля и сохраните, или удалите объект.

   PHP

   Копировать

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   // PUT /classes/Todo/{objectId} — mark done
   // DELETE /classes/Todo/{objectId}
   function markDone(string $baseUrl, string $appId, string $restKey, string $sessionToken, string $objectId): void {
       $client = new \GuzzleHttp\Client();
       $client->put($baseUrl . '/classes/Todo/' . $objectId, [
           'headers' => [
               'X-Parse-Application-Id' => $appId,
               'X-Parse-REST-API-Key'   => $restKey,
               'X-Parse-Session-Token'  => $sessionToken,
               'Content-Type' => 'application/json',
           ],
           'json' => ['done' => true],
       ]);
   }

Часто задаваемые вопросы

Распространенные вопросы о шаблоне бэкенда приложения Todo.