跳转到主要内容

​
概览

revolution/laravel-line-sdk 是一个让你能更方便地在 Laravel 中使用 LINE 官方 SDK 的包。 它提供了 Webhook 接收、Bot Facade、Laravel Notifications 集成、LINE Login（Socialite）四大功能。
该包要求 PHP 8.3 及以上、Laravel 12.0 及以上。

​
安装

composer require revolution/laravel-line-sdk

​
配置

​
LINE Developers 控制台

在 LINE Developers 创建 Channel。
Messaging API Channel 不再支持直接从 LINE Developers Console 创建。请先在 LINE Official Account Manager 中创建官方账号，并启用 Messaging API 的使用。
创建两个 Channel。
Channel需要获取的内容
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

部署到 Web 服务器

要接收来自 LINE 的 Webhook，你需要一个可公开访问的 URL。本地服务器无法接收。在 LINE Developers 控制台设置 Webhook URL：
https://example.com/line/webhook
5

将 Bot 加为好友并测试

使用 Messaging API Channel 的二维码添加好友。当你发送消息时，MessageListener 会原样回显。

​
文档

Webhook / Bot

通过 Webhook 控制器与 Bot Facade 收发消息。

通知 Channel

Laravel Notification System 与 LINE Messaging API 的集成。

Socialite（LINE Login）

通过 Socialite 实现基于 LINE Login 的 OAuth2 认证。

​
参考链接

最后修改于 2026年7月13日

相关主题

LINE SDK for Laravel