Skip to content
SDK of the LINE Messaging API for PHP
PHP Makefile Shell
Branch: master
Clone or download
Pull request Compare This branch is 189 commits behind line:master.
Latest commit f949d84 Mar 30, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE Dec 12, 2017
devtool Remove unused function Nov 21, 2016
docs 📝 doc Sep 21, 2017
examples Update composer.json Jul 3, 2017
line-bot-sdk-tiny Fix English issues in documentation Oct 24, 2016
src Add tests and fix bugs Mar 30, 2018
tests Add tests and fix bugs Mar 30, 2018
.gitignore Add phpdoc files Feb 18, 2017
.travis.yml Remove PHP5.4 test from TravisCI Mar 30, 2018 Add code of conduct Jan 23, 2018 Correct repository URL on Sep 29, 2016
LICENSE Support the latest LINE Messaging API Sep 29, 2016
Makefile Improve release flow and note it Aug 17, 2017 Implement image upload function and fix some modules Mar 29, 2018
composer.json Support PHP 5.4 and 5.5 Feb 19, 2017
phpunit.xml Support the latest LINE Messaging API Sep 29, 2016


Build Status

SDK of the LINE Messaging API for PHP.

About the LINE Messaging API

See the official API documentation for more information.



Install the LINE Messaging API SDK using Composer.

$ composer require linecorp/line-bot-sdk

Getting started

Create the bot client instance

The bot client instance is a handler of the Messaging API.

$httpClient = new \LINE\LINEBot\HTTPClient\CurlHTTPClient('<channel access token>');
$bot = new \LINE\LINEBot($httpClient, ['channelSecret' => '<channel secret>']);

The constructor of the bot client requires an instance of HTTPClient. This library provides CurlHTTPClient by default.

Call API

You can call an API through the bot client instance.

A very simple example:

$response = $bot->replyText('<reply token>', 'hello!');

This procedure sends a message to the destination that is associated with <reply token>.

A more advanced example:

$textMessageBuilder = new \LINE\LINEBot\MessageBuilder\TextMessageBuilder('hello');
$response = $bot->replyMessage('<reply token>', $textMessageBuilder);
if ($response->isSucceeded()) {
    echo 'Succeeded!';

// Failed
echo $response->getHTTPStatus() . ' ' . $response->getRawBody();

LINEBot#replyMessage() takes the reply token and MessageBuilder. The method sends a message that is built by MessageBuilder to the destination.



The type of message that is sent depends on the type of instance of MessageBuilder. For example, the method sends a text message if you pass TextMessageBuilder and it sends an image message if you pass ImageMessageBuilder.

For more detailed information on MessageBuilder, see \LINE\LINEBot\MessageBuilder and the namespace.

Other methods that take MessageBuilder behave in the same way.


Methods that call API returns Response. Response has three methods;

  • Response#isSucceeded()
  • Response#getHTTPStatus()
  • Response#getRawBody()
  • Response#getJSONDecodedBody()
  • Response#getHeader($name)
  • Response#getHeaders()

You can use these methods to check the response status and take response body.


Returns a Boolean value. The return value represents whether the request succeeded or not.


Returns the HTTP status code of a response.


Returns the body of the response as raw data (a byte string).


Returns the body that is decoded in JSON. This body is an array.


This method returns a response header string, or null if the response does not have a header of that name.


This method returns all of the response headers as string array.


LINE's server sends user actions (such as a message, image, or location) to your bot server. Request of that contains event(s); event is action of the user.

The following shows how the webhook is handled:

  1. Receive webhook from LINE's server.
  2. Parse request payload by LINEBot#parseEventRequest($body, $signature).
  3. Iterate parsed events and some react as you like.

The following examples show how webhooks are handled:

More information

For more information, see the official API documents and PHPDoc. If it's your first time using this library, we recommend taking a look at examples and the PHPDoc of \LINE\LINEBot.



This repository contains two examples of how to use the LINE Messaging API.


A simple sample implementation. This application reacts to text messages that are sent from users.


A full-stack (and slightly complex) sample implementation. This application demonstrates a practical use of the LINE Messaging API.


This library provides PHPDoc to describe how to use the methods. You can generate the documentation using apigen using the following command.

$ make doc

The HTML files are generated in docs/.

Official API documentation

Official API documents shows the detail of Messaging API and fundamental usage of SDK.


How to switch the HTTP client implementation

  1. Implement \LINE\LINEBot\HTTPClient
  2. Pass the implementation to the constructor of \LINE\LINEBot

Please refer CurlHTTPClient that is the default HTTP client implementation.


  • PHP 5.5 or later

For SDK developers

Please refer

See also


A very simple SDK (subset) for the LINE Messaging API for PHP. line-bot-sdk-tiny provides a simple interface and functions which makes it a good way to learn how to use the LINE Messaging API.


Copyright 2016 LINE Corporation

LINE Corporation licenses this file to you under the Apache License,
version 2.0 (the "License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at:

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
You can’t perform that action at this time.