메인 콘텐츠로 건너뛰기

​
개요

revolution/laravel-line-sdk는 LINE 공식 SDK를 Laravel에서 사용하기 쉽게 만든 패키지입니다. Webhook 수신, Bot 파사드, Laravel Notifications 통합, LINE Login (Socialite)의 4가지 기능을 제공합니다.
이 패키지는 PHP 8.3 이상, Laravel 12.0 이상이 필요합니다.

​
설치

composer require revolution/laravel-line-sdk

​
설정

​
LINE Developers 콘솔

LINE Developers에서 채널을 생성합니다.
Messaging API 채널은 LINE Developers Console에서 직접 생성할 수 없게 되었습니다. 먼저 LINE Official Account Manager에서 공식 계정을 만든 뒤 Messaging API 사용을 활성화하세요.
두 개의 채널을 생성합니다.
채널획득할 정보
Messaging APIChannel access token (long-lived), Channel secret
LINE LoginChannel ID, Channel secret

​
.env

LINE_BOT_CHANNEL_TOKEN=
LINE_BOT_CHANNEL_SECRET=

LINE_LOGIN_CLIENT_ID=
LINE_LOGIN_CLIENT_SECRET=
LINE_LOGIN_REDIRECT=

​
설정 파일 게시 (선택 사항)

php artisan vendor:publish --tag=line-config

​
빠른 시작

가장 빨리 Bot을 동작시키는 절차입니다.
1

새 Laravel 프로젝트 생성

laravel new line-bot
cd ./line-bot
composer require revolution/laravel-line-sdk
2

.env 설정

LINE_BOT_CHANNEL_TOKEN=
LINE_BOT_CHANNEL_SECRET=
3

기본 Listener 게시

php artisan vendor:publish --tag=line-listeners
app/Listeners/Line/에 MessageListener가 생성됩니다.
4

웹 서버에 배포

LINE에서 Webhook을 수신하려면 공개된 URL이 필요합니다. 로컬 서버에서는 수신할 수 없습니다.LINE Developers 콘솔에서 Webhook URL을 설정합니다.
https://example.com/line/webhook
5

Bot을 친구 추가하고 테스트

Messaging API 채널의 QR 코드로 친구 추가합니다. 메시지를 보내면 MessageListener가 그대로 앵무새처럼 답변합니다.

​
문서

Webhook / Bot

Webhook 컨트롤러와 Bot 파사드에 의한 메시지 송수신.

알림 채널

Laravel Notification System과 LINE Messaging API 통합.

Socialite (LINE Login)

LINE Login에 의한 OAuth2 인증을 Socialite로 구현.

​
참고 링크

마지막 수정일 2026년 7월 13일

관련 항목

LINE SDK for Laravel