Repolode
overtrue

overtrue/easy-sms

여러 중국 및 해외 SMS 제공업체를 단일 API로 이용하고, 장애 조치와 게이트웨이 전략을 지원하는 PHP 라이브러리입니다.

스타
3,334
포크
563
열린 이슈
23
마지막 커밋
지난달

어떤 프로젝트인가요?

Easy SMS는 하나의 호출 방식으로 여러 SMS 서비스 제공업체를 통해 문자를 보낼 수 있는 PHP 컴포넌트입니다. 개발자는 Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian, Twilio 등의 게이트웨이를 하나 이상 설정한 뒤, 실제 메시지를 처리하는 제공업체와 관계없이 하나의 전송 메서드를 호출하면 됩니다.

게이트웨이를 여러 개 설정하면 라이브러리가 지정된 순서나 다른 전략에 따라 시도하므로, 제공업체에 장애가 발생해도 자동으로 건너뛸 수 있습니다. 전송 결과는 게이트웨이별 상태와 제공업체 응답을 담은 배열로 반환되며, 모든 게이트웨이에서 실패하면 전용 예외를 던집니다. 메시지는 일반 텍스트, 변수가 포함된 템플릿 ID 또는 메시지 클래스로 전달할 수 있고, 클로저를 사용해 사용자 지정 게이트웨이를 등록할 수도 있습니다.

이 패키지는 PHP 8.4 이상과 Guzzle 7 또는 8이 필요하며, Composer로 설치합니다.

핵심 기능

  • 01중국 및 해외의 수십 개 SMS 제공업체에서 사용할 수 있는 통합 전송 API.
  • 02순차 실행 또는 사용자 지정 전략을 지원하는 다중 게이트웨이와 자동 장애 조치.
  • 03게이트웨이별 결과 배열을 반환하며, 모든 게이트웨이에서 실패하면 전용 예외를 던집니다.
  • 04일반 텍스트, 변수가 포함된 템플릿 ID, 재사용 가능한 메시지 클래스를 지원합니다.
  • 05라이브러리를 수정하지 않고 사용자 지정 게이트웨이를 등록할 수 있습니다.

활용 사례

  • 대체 제공업체를 설정해 PHP 웹 애플리케이션에서 인증 코드를 전송합니다.
  • 애플리케이션 코드를 다시 작성하지 않고 SMS 업체를 교체합니다.
  • PHP 백엔드에서 Alibaba Cloud 또는 Tencent Cloud를 통해 템플릿 기반 알림을 전송합니다.
  • 모니터링을 위해 여러 제공업체의 전송 결과를 기록합니다.

빠른 시작

  1. 1

    Composer로 패키지를 설치합니다

    composer require "overtrue/easy-sms"
  2. 2

    게이트웨이 설정으로 EasySms 인스턴스를 만들고 send()를 호출합니다

사용 전 알아둘 점

  • PHP 8.4 이상이 필요합니다.
  • SMS 제공업체마다 별도의 계정과 인증 정보가 필요하므로 사용하는 제공업체에 가입해야 합니다.
  • Guzzle 8에서는 헤더 옵션 값이 문자열이어야 합니다. 따라서 게이트웨이 설정에 문자열이 아닌 값이 있으면 오류가 발생합니다.

토픽

#sms#php#messaging#notification#api-client#verification-code#php-sms#sms-client#sms-gateway

자주 묻는 질문

easy-sms은(는) 무엇인가요?
여러 중국 및 해외 SMS 제공업체를 단일 API로 이용하고, 장애 조치와 게이트웨이 전략을 지원하는 PHP 라이브러리입니다. Easy SMS는 하나의 호출 방식으로 여러 SMS 서비스 제공업체를 통해 문자를 보낼 수 있는 PHP 컴포넌트입니다. 개발자는 Alibaba Cloud, Tencent Cloud, Huawei Cloud, Yunpian, Twilio 등의 게이트웨이를 하나 이상 설정한 뒤, 실제 메시지를 처리하는 제공업체와 관계없이 하나의 전송 메서드를 호출하면 됩니다.
easy-sms은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
easy-sms은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
easy-sms은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. easy-sms의 마지막 커밋은 2026년 10월 4일입니다.
easy-sms은(는) 어디에 사용할 수 있나요?
대체 제공업체를 설정해 PHP 웹 애플리케이션에서 인증 코드를 전송합니다. 애플리케이션 코드를 다시 작성하지 않고 SMS 업체를 교체합니다. PHP 백엔드에서 Alibaba Cloud 또는 Tencent Cloud를 통해 템플릿 기반 알림을 전송합니다. 모니터링을 위해 여러 제공업체의 전송 결과를 기록합니다.
easy-sms는 어떻게 설치하나요?
Composer로 패키지를 설치합니다: composer require "overtrue/easy-sms" 게이트웨이 설정으로 EasySms 인스턴스를 만들고 send()를 호출합니다
easy-sms은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/overtrue/easy-sms

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트