Download the PHP package sendgo/symfony without Composer
On this page you can find all versions of the php package sendgo/symfony. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sendgo/symfony
More information about sendgo/symfony
Files in sendgo/symfony
Package symfony
Short Description Sendgo Symfony 번들 — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS Symfony 통합
License MIT
Homepage https://sendgo.io
Informations about the package symfony
sendgo/symfony
Symfony에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 공식 Symfony 번들
sendgo/symfony는 sendgo/php 코어를 확장한 Symfony 전용 번들입니다.
DI 컨테이너 서비스 자동 등록, 설정(config) 통합, 오토와이어링을 완벽하게 제공합니다.
목차
- 설치
- 빠른 시작
- 오토와이어링 사용법
- 상세 사용법
- 알림톡
- 친구톡
- SMS / LMS / MMS
- 서비스 클래스 패턴
- Messenger 비동기 발송
- 예외 처리
- 설정 옵션
- 자주 묻는 질문
설치
번들 등록
Symfony Flex를 사용하는 경우 번들이 자동으로 등록됩니다.
Flex를 사용하지 않는다면 config/bundles.php에 직접 추가하세요.
빠른 시작
1단계 — 환경변수 설정 (.env)
2단계 — 번들 설정 파일 (config/packages/sendgo.yaml)
3단계 — 알림톡 전송
오토와이어링 사용법
번들이 Sendgo\Php\Sendgo 서비스를 컨테이너에 등록하므로, 생성자에 타입힌트만 하면
자동으로 주입됩니다. 별도의 서비스 정의는 필요하지 않습니다.
sendgo 서비스 ID로 직접 컨테이너에서 가져올 수도 있습니다.
상세 사용법
알림톡
친구톡
⚠️ Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다. 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 브랜드메시지(자유형) 로 자동 대체 발송됩니다. 호출은 계속 성공하며, 자유 본문 타입(
FT/FI/FW)을 개별 수신자에게 보내는 경로는 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.다음의 경우에는 브랜드메시지를 사용하세요.
- 템플릿 기반 리치 타입 (
FL/FC/FM/FP/FA)- 채널 친구가 아닌 수신자 (
targeting=N/I)- 수신 동의한 전체 채널 친구 동보 (
targeting=F)메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 —
FT→BT,FI→BI,FW→BW,FL→BL,FC→BC,FM→BM,FP→BP,FA→BA.
SMS / LMS / MMS
서비스 클래스 패턴
services.yaml에서 autowire: true가 설정되어 있으면 Sendgo\Php\Sendgo가 자동 주입됩니다.
Messenger 비동기 발송
Symfony Messenger로 발송을 비동기 처리할 수 있습니다.
예외 처리
설정 옵션
config/packages/sendgo.yaml 에서 설정합니다:
| 키 | 환경변수 | 기본값 | 설명 |
|---|---|---|---|
access_key |
SENDGO_ACCESS_KEY |
— (필수) | Sendgo 액세스 키 |
secret_key |
SENDGO_SECRET_KEY |
— (필수) | Sendgo 시크릿 키 |
kakao_sender_key |
SENDGO_KAKAO_SENDER_KEY |
null |
카카오 발신프로필 키 |
sms_sender_key |
SENDGO_SMS_SENDER_KEY |
null |
SMS 발신자 키 |
api_version |
SENDGO_API_VERSION |
'v2' |
API 버전 |
url |
SENDGO_URL |
'https://sendgo.io' |
API 기본 URL |
자주 묻는 질문 (FAQ)
Q. sendgo/php와의 차이는 무엇인가요?
A. sendgo/php는 프레임워크 독립적인 순수 PHP 코어 패키지입니다. sendgo/symfony는 이를 확장해 번들 자동 등록, DI 컨테이너 서비스 등록, config 바인딩, 오토와이어링 등 Symfony 통합을 추가합니다.
Q. Symfony 6.4, 7 모두 지원하나요?
A. 네, symfony/config, symfony/dependency-injection, symfony/http-kernel 모두 ^6.4|^7.0을 지원합니다.
Q. 오토와이어링 없이 서비스 ID로 접근할 수 있나요?
A. 네, sendgo 별칭이 등록되어 있어 $container->get('sendgo')로 접근할 수 있습니다.
Q. 테스트 시 Sendgo를 Mock 처리하려면?
A. 테스트 컨테이너에서 Sendgo\Php\Sendgo 서비스를 PHPUnit Mock으로 교체하면 됩니다.
관련 패키지
| 언어/프레임워크 | 패키지 | GitHub |
|---|---|---|
| PHP (순수) | sendgo/php |
php |
| Laravel | sendgo/laravel |
laravel |
| Spring Boot | io.sendgo:sendgo-spring |
spring |
| Node.js | @sendgo/node |
node |
| 전체 목록 | — | send-go GitHub 조직 |
브랜드메시지 · 짧은 URL
이 패키지는 코어(sendgo/php)의 클라이언트를 그대로 노출하므로, 코어에 있는 채널이
모두 그대로 쓸 수 있습니다. 두 기능 모두 v2 전용입니다.
| 기능 | 접근 |
|---|---|
| 카카오 브랜드메시지 (친구톡의 후속 채널) | $sendgo->brandMessage |
| 짧은 URL (단축 + 클릭 반응 분석) | $sendgo->shortUrl |
브랜드메시지는 채널 친구가 아닌 수신자에게도 보낼 수 있고(targeting = N),
수신 동의한 전체 채널 친구에게 동보 발송할 수도 있습니다(targeting = F).
짧은 URL 은 메시지 본문의 링크를 줄이고 클릭 반응(일별 추이·디바이스·유입경로·국가)을 집계합니다.
사용 예시와 파라미터는 코어 README 와 SDK 가이드 를 참고하세요.
관리 API — 채널·템플릿·발신번호 등록 (v2 전용)
콘솔에서만 되던 등록·심사를 코드로 처리합니다. 이 번들은 코어(sendgo/php)의
클라이언트를 그대로 노출하므로, 주입받은 Sendgo 서비스에서 바로 쓸 수 있습니다.
| 서비스 | 하는 일 | 계정 |
|---|---|---|
$sendgo->kakaoSenders |
카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청 | 기업 |
$sendgo->noticeTemplates |
알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제 | 기업 |
$sendgo->brandTemplates |
브랜드메시지 템플릿 CRUD, 동기화, 가져오기 | 기업 |
$sendgo->senderRegistration |
발신번호 등록 신청, 중복 확인, 유형 안내 | 개인·기업 |
$sendgo->messageTemplates |
문자 상용구 템플릿 CRUD | 개인·기업 |
$sendgo->kakaoImages |
카카오 이미지 업로드 — 템플릿용 URL 발급 | 기업 |
$sendgo->rejectedNumbers |
수신거부(080) 번호 조회 | 개인·기업 |
$sendgo->webhook |
이벤트 웹훅 구독 — 심사 결과 수신 | 개인·기업 |
sendgo.io 콘솔에 들어올 일이 없습니다. 휴대폰 발신번호는 PASS 대신 신분증 사본을 받아 sendgo 운영자가 대신 심사합니다. 사람이 개입하는 지점은 카카오 채널 인증번호 하나뿐이고, 그것도 여러분 화면에서 입력받으면 됩니다. 심사가 붙는 것들은 비동기라 웹훅으로 결과를 받으세요.
전체 파라미터는 코어 README 와 API 문서 를 참고하세요.
변경 사항
1.3.0 (2026-09-11)
- 관리 API 노출 — 코어 1.3.0 의
kakaoSenders·noticeTemplates·brandTemplates·senderRegistration·messageTemplates를 주입받은Sendgo서비스에서 그대로 쓸 수 있습니다. 콘솔에서만 되던 채널 등록, 알림톡 템플릿 검수 요청, 발신번호 심사 접수를 코드로 처리합니다. - 이벤트 웹훅 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단, 브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로 검증합니다(SDK 에 검증 헬퍼 포함).
- 카카오 이미지 업로드 추가 — 브랜드메시지 템플릿의
imageUrl은 카카오가 호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다. - 수신거부(080) 조회 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.
1.2.1 (2026-08-14)
- 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다. npm/PyPI/Packagist/Maven/NuGet/RubyGems 검색 결과에 그대로 찍히는 문자열이라 종료된 채널을 계속 홍보하고 있었습니다.
- 검색 키워드에
brand-message를 추가했습니다 (friendtalk은 유입 검색어라 유지).
1.2.0 (2026-08-14)
- 친구톡 Deprecated 표기 — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고, 2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다. 관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
- 자유 본문 타입(
FT/FI/FW)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을 문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에NOT_A_BRAND_MESSAGE를 반환합니다. - 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
- 짧은 URL 지원 (1.1.0 릴리스 누락분 포함).
1.1.0 (2026-08-11)
- 브랜드메시지·짧은 URL 접근 방법 문서화 (코어를 그대로 노출)
라이선스
MIT License © 2026 Sendgo
키워드: 카카오 알림톡 Symfony, 카카오 친구톡 Symfony, SMS 발송 Symfony, 알림톡 Symfony 번들, Symfony 카카오 API 연동, Symfony Messenger 알림톡, Sendgo Symfony SDK
All versions of symfony with dependencies
sendgo/php Version ^1.6
symfony/config Version ^6.4|^7.0
symfony/dependency-injection Version ^6.4|^7.0
symfony/http-kernel Version ^6.4|^7.0