퀵스타터즈
Symfony를 위한 백엔드 구축 방법은?

28min
소개
이 튜토리얼에서는 Back4App을 사용하여 Symfony의 백엔드를 구축하는 방법을 배웁니다. 
Back4App의 강력한 기능—데이터베이스 관리, 클라우드 코드, REST 및 GraphQL API—를 사용하여 Symfony 애플리케이션과 원활하게 작동하는 안전하고 확장 가능하며 효율적인 백엔드를 만드는 방법을 보여드립니다. 
사용자 인증, 파일 저장 및 실시간 업데이트를 Live Queries를 통해 처리하는 방법도 알아볼 수 있습니다(아키텍처에 따라 다를 수 있음).
Back4App의 빠른 설정과 직관적인 플랫폼을 활용하면 서버와 데이터베이스를 수동으로 처리하는 것에 비해 시간과 노력을 절약할 수 있습니다. 
신뢰할 수 있는 백엔드 개발을 위한 고급 보안, 클라우드 작업으로 작업 예약, 웹훅 구성 및 기타 필수 기능에 대한 실습 경험을 얻을 수 있습니다.
이 튜토리얼을 완료한 후, 프로덕션을 위한 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로 연결:
앱의 “앱 설정” 또는 “보안 및 키”에서 애플리케이션 ID 및 REST API 키 (GraphQL을 사용할 계획이라면 GraphQL 엔드포인트도) 찾습니다.
당신의 Parse 서버 URL (예: https://parseapi.back4app.com)를 기록해 두세요.
Symfony는 기본 Parse SDK가 없으므로, Symfony의 HTTP 클라이언트 또는 Guzzle과 같은 라이브러리를 사용하여 Back4App의 REST 또는 GraphQL API와 통신해야 합니다.
﻿
아래는 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();
    }
}
﻿
이 서비스는 Symfony 내에서 Back4App 백엔드에 요청을 하는 데 도움을 줄 것입니다.
2단계 – 데이터베이스 설정
데이터 모델 생성
Back4App에서 데이터를 저장할 클래스(테이블)를 정의합니다. 예를 들어, Todo 클래스를 만들어 작업을 보관하고 싶다고 가정해 보겠습니다:
데이터베이스로 이동 당신의 Back4App 대시보드에서.
새로운 클래스 생성 “Todo” 및 title (문자열)과 isCompleted (부울)과 같은 필드를 추가합니다.
새 클래스 생성
﻿
대안으로, Back4App AI 에이전트가 데이터 모델을 생성하게 하세요:
AI 에이전트 열기 당신의 프로젝트 대시보드에서.
데이터 모델 설명하기 (예: “제목 및 완료 여부 필드가 있는 Todo 클래스를 생성합니다.”).
스키마 자동 생성하기
﻿
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에 통합할 수 있습니다. 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 앱이 실시간 데이터가 필요하다면, Live Queries를 더 프론트엔드 또는 실시간 마이크로서비스 맥락에서 통합할 수 있습니다. Back4App의 서버 설정에서 Live Queries를 구성한 후, WebSocket 클라이언트를 연결합니다. 필요하다면 Symfony는 이러한 업데이트에 응답하거나 별도의 실시간 레이어를 통해 방송할 수 있습니다.
3단계 – ACL 및 CLP로 보안 적용하기
ACLs (접근 제어 목록)
ACL을 사용하면 객체를 읽거나 쓸 수 있는 사람을 제어할 수 있습니다. 예를 들어, REST API를 사용하여 데이터를 생성할 때 JSON에 _ACL 필드를 추가하여 코드에서 ACL을 적용할 수 있습니다. 예를 들어:
JSON
{
  "title": "Private Task",
  "isCompleted": false,
  "_ACL": {
    "UserObjectIdHere": {
      "read": true,
      "write": true
    }
  }
}
{
  "title": "Private Task",
  "isCompleted": false,
  "_ACL": {
    "UserObjectIdHere": {
      "read": true,
      "write": true
    }
  }
}
﻿
CLPs (클래스 수준 권한)
클래스 수준 권한을 사용하면 전체 클래스에 대한 광범위한 접근 규칙을 설정할 수 있습니다:
Back4App 대시보드에서 데이터베이스 열기
클래스를 선택하세요 (예: “Todo”).
권한 탭으로 이동하여 읽기/쓰기 접근을 구성하세요.
﻿
자세한 정보는 앱 보안 가이드라인을 방문하세요.
4단계 – 클라우드 코드 함수 작성
클라우드 코드를 사용하면 인프라를 관리하지 않고도 안전한 서버 측 JavaScript를 실행할 수 있습니다. Symfony가 PHP로 되어 있지만, 특정 작업을 클라우드 코드에 위임하여 Back4App에서 고급 로직, 트리거 및 유효성 검사를 수행할 수 있습니다.
예: 저장하기 전에 Todo 유효성 검사
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단계 – 이메일 인증 및 비밀번호 재설정
이메일 구성
이메일 설정으로 이동 in 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 요청을 보낼 수 있게 해줍니다. 예를 들어, 새로운 Todo가 생성될 때마다 Slack 엔드포인트를 호출할 수 있습니다:
더보기 > 웹훅으로 이동 Back4App 대시보드에서.
외부 엔드포인트를 지정하여 웹훅 추가
객체 생성 시 이벤트를 Todo 클래스에서 트리거합니다.
웹훅 추가
﻿
10단계 – Back4App 관리 패널 탐색
다음과 같이 Back4App Admin App을 사용하여 사용자 친화적인 데이터 관리 인터페이스를 제공합니다:
Admin App 활성화는 App Dashboard > More > Admin App에서 가능합니다.
안전한 사용자 이름과 비밀번호로 관리 사용자 계정을 생성합니다.
쉬운 접근을 위해 사용자 정의 하위 도메인을 할당합니다.
Admin App 활성화
﻿
이 기능은 비기술 팀원이 코드를 깊이 파고들지 않고도 기록을 보고 관리할 수 있도록 도와줍니다.
결론
당신은 Back4App을 사용하여 Symfony의 백엔드를 구축하는 방법을 배웠습니다 이 과정에는 다음이 포함되었습니다:
새 프로젝트 생성 Back4App을 기반으로.
데이터베이스 구성 클래스, 필드 및 관계를 사용하여.
데이터 보안 ACL 및 CLP를 사용하여.
클라우드 코드 활용 서버 측 로직을 위해.
사용자 인증 관리 (가입, 로그인, 비밀번호 재설정).
파일 저장 처리 REST API를 사용하여.
클라우드 작업 설정 주기적인 작업을 위해.
웹훅 통합 외부 서비스와 연결하기 위해.
Back4App 관리 패널 탐색 쉬운 데이터 관리를 위해.
이 단계는 Symfony 애플리케이션을 구축하고 확장하기 위한 강력한 프레임워크를 제공합니다. 이 아키텍처를 확장하여 더 복잡한 로직을 처리하고, 결제 게이트웨이를 통합하거나, 고급 보안 기능을 추가하세요. Back4App을 사용하면 호스팅 및 인프라에 대한 시간과 노력을 절약할 수 있으므로 최상의 사용자 경험을 제공하는 데 집중할 수 있습니다.
다음 단계
생산 준비가 된 Symfony 앱 구축 더 높은 트래픽과 고급 성능 요구를 위해 Back4App 백엔드를 사용자 정의하여.
고급 기능 통합 역할 기반 접근, 분석 또는 결제를 위한 제3자 API와 같은.
공식 Back4App 문서 탐색 보안, 로그 및 모니터링에 대한 더 깊은 통찰을 위해.
더 많은 튜토리얼 확인 이 백엔드를 실시간 서비스와 결합하거나 실시간 업데이트가 있는 동적 웹사이트를 만들기 위해.
이 전략을 따르면 Symfony 프로젝트는 강력하고 효율적인 백엔드를 갖게 됩니다. Back4App을 활용하여 유지 관리를 용이하게 하고 애플리케이션의 기능을 빠르게 발전시키세요. 다음 Symfony 걸작을 만드는 데 행운을 빕니다!
업데이트됨 24 Jan 2025
이 페이지가 도움이 되었습니까?
Golang으로 백엔드를 구축하는 방법은?
아이오닉을 위한 백엔드 구축 방법?