> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# LINE SDK for Laravel

> 面向 Laravel 优化的 LINE 官方 SDK 封装包。提供 Webhook、Bot、通知、Socialite 四大功能。

## 概览

[revolution/laravel-line-sdk](https://github.com/invokable/laravel-line-sdk) 是一个让你能更方便地在 Laravel 中使用 LINE 官方 SDK 的包。

它提供了 Webhook 接收、Bot Facade、Laravel Notifications 集成、LINE Login（Socialite）四大功能。

<Info>
  该包要求 PHP 8.3 及以上、Laravel 12.0 及以上。
</Info>

## 安装

```shell theme={null}
composer require revolution/laravel-line-sdk
```

## 配置

### LINE Developers 控制台

在 [LINE Developers](https://developers.line.biz/) 创建 Channel。

<Info>
  Messaging API Channel 不再支持直接从 LINE Developers Console 创建。请先在 [LINE Official Account Manager](https://manager.line.biz/) 中创建官方账号，并启用 Messaging API 的使用。
</Info>

创建两个 Channel。

| Channel           | 需要获取的内容                                          |
| ----------------- | ------------------------------------------------ |
| **Messaging API** | Channel access token (long-lived)、Channel secret |
| **LINE Login**    | Channel ID、Channel secret                        |

### .env

```dotenv theme={null}
LINE_BOT_CHANNEL_TOKEN=
LINE_BOT_CHANNEL_SECRET=

LINE_LOGIN_CLIENT_ID=
LINE_LOGIN_CLIENT_SECRET=
LINE_LOGIN_REDIRECT=
```

### 发布配置文件（可选）

```shell theme={null}
php artisan vendor:publish --tag=line-config
```

## 快速开始

以下是让 Bot 尽快跑起来的步骤。

<Steps>
  <Step title="创建新的 Laravel 项目">
    ```shell theme={null}
    laravel new line-bot
    cd ./line-bot
    composer require revolution/laravel-line-sdk
    ```
  </Step>

  <Step title="配置 .env">
    ```dotenv theme={null}
    LINE_BOT_CHANNEL_TOKEN=
    LINE_BOT_CHANNEL_SECRET=
    ```
  </Step>

  <Step title="发布默认 Listener">
    ```shell theme={null}
    php artisan vendor:publish --tag=line-listeners
    ```

    会在 `app/Listeners/Line/` 中生成 `MessageListener`。
  </Step>

  <Step title="部署到 Web 服务器">
    要接收来自 LINE 的 Webhook，你需要一个可公开访问的 URL。本地服务器无法接收。

    在 LINE Developers 控制台设置 Webhook URL：

    ```
    https://example.com/line/webhook
    ```
  </Step>

  <Step title="将 Bot 加为好友并测试">
    使用 Messaging API Channel 的二维码添加好友。当你发送消息时，`MessageListener` 会原样回显。
  </Step>
</Steps>

## 文档

<Columns cols={2}>
  <Card title="Webhook / Bot" href="/zh/packages/laravel-line-sdk/bot" icon="webhook">
    通过 Webhook 控制器与 Bot Facade 收发消息。
  </Card>

  <Card title="通知 Channel" href="/zh/packages/laravel-line-sdk/notification" icon="bell">
    Laravel Notification System 与 LINE Messaging API 的集成。
  </Card>

  <Card title="Socialite（LINE Login）" href="/zh/packages/laravel-line-sdk/socialite" icon="shield-check">
    通过 Socialite 实现基于 LINE Login 的 OAuth2 认证。
  </Card>
</Columns>

## 参考链接

* GitHub：[invokable/laravel-line-sdk](https://github.com/invokable/laravel-line-sdk)
* 演示：[invokable/laravel-line-project](https://github.com/invokable/laravel-line-project)
* DeepWiki：[invokable/laravel-line-sdk](https://deepwiki.com/invokable/laravel-line-sdk)


## Related topics

- [LINE SDK for Laravel](/fr/packages/laravel-line-sdk/index.md)