NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #2548 most downloaded on Packagist
SDK of the LINE BOT API for PHP
Latest stable
v12.9.0
Last release 26 days ago
27 Oct 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
106 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
To follow the bot api update, SpacerComponentBuilder has also been deprecated and removed from this SDK.
We updated major version with respect for semantic versioning.
To follow the bot api update, SpacerComponentBuilder has also been deprecated and removed from this SDK.
See following issue #318 about details.
Supported these features.
Get webhook endpoint information
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Support these features.
Add minimum integration for Laravel.
https://developers.line.biz/en/reference/messaging-api/#send-narrowcast-message
https://developers.line.biz/en/reference/messaging-api/#send-narrowcast-message
We stopped to support php 5.5. please see this discussion. https://github.com/line/line-bot-sdk-php/issues/289
Video viewing complete event has been added
Issue channel access token v2.1
support this apis.
suport this https://developers.line.biz/en/reference/messaging-api/#retry-api-request
## TextMessage constructor fails message without emojis #291 fix bug.
fix bug.
## fixed can use quick reply and sender at same time #278 see #278 . ## fix: ButtonTemplateBuilder title ignores "0" #286 see #285 .
see #278 .
see #285 .
support this change. https://developers.line.biz/en/news/2020/04/14/messaging-api-update-april-2020/
support this change. https://developers.line.biz/en/news/2020/04/14/messaging-api-update-april-2020/
suport this features. https://developers.line.biz/en/docs/messaging-api/using-audience/
support this change. https://developers.line.biz/en/reference/messaging-api/#wh-text
support following changes. https://developers.line.biz/en/docs/messaging-api/icon-nickname-switch/
support following changes. https://developers.line.biz/en/docs/messaging-api/icon-nickname-switch/
Add mode property added to webhook event.
Add mode property added to webhook event.
Add support following api.
support stickerResourceType property to StickerMessage.
support stickerResourceType property to StickerMessage.
Add missing these functions.
Fix #256
add CI matrix for support PHP7.4
remove unused symfony/dependency-injection on dev-dependencies
remove unused symfony/dependency-injection on dev-dependencies
Notice of domain name change for certain endpoints
Followed this change.
Get user interaction statistics
Support this api.
## Flex 1 Update #239 Support this. * Flex Message Update 1 released ## Fix echo bot connection check always fail #246 Fix the bug of #245 .
Support this.
Fix the bug of #245 .
Get number of message deliveries
Support following api
## Support OAuth #229 Support following api * Issue channel access token * Revoke channel access token ## LINE Things - automatic communication featur
Support following api
Support Scenario result event
add support for "Get the target limit for additional messages api"
Support following api.
notificationDisabled paramnotificationDisabled paramSupport new param "altUri.desktop" for URI action https://developers.line.biz/en/reference/messaging-api/#uri-action
Support new param "altUri.desktop" for URI action https://developers.line.biz/en/reference/messaging-api/#uri-action
Support following api https://developers.line.biz/en/reference/messaging-api/#issue-link-token
add support following. Get number of sent reply Get number of sent push messages Get number of sent multicast messages
add support following. Get number of sent reply Get number of sent push messages Get number of sent multicast messages
Support new property "video" for Imagemap message.
Support new property "video" for Imagemap message.
Move ext-posix to requirements in composer.json
Add support following.
Supported new events following.
Supported new events following.
This update is minor changes to clean up comments, variable names, typos and coding styles. Which is almost nothing change to actual code, but if you
This update is minor changes to clean up comments, variable names, typos and coding styles. Which is almost nothing change to actual code, but if you find something wrong with this SDK, please let us know.
You can now handle account link event. https://developers.line.me/en/reference/messaging-api/#account-link-event
You can now handle account link event. https://developers.line.me/en/reference/messaging-api/#account-link-event
LocationMessage now allow null title parameter or address.
LocationMessage now allow null title parameter or address.
Fixed a issue that getGroupMemberIds() and getRoomMemberIds() methods are not working properly.
Fixed the issue that we added RawMessageBuilder class at 3.4.0 but auto generated documents are not pushed correctly.
Fixed the issue that we added RawMessageBuilder class at 3.4.0 but auto generated documents are not pushed correctly.
ButtonTemplateBuilder class accepts that both title and thumbnailImageUrl are optional parameters.
ButtonTemplateBuilder class accepts that both title and thumbnailImageUrl are optional parameters.
This class allows you to specify message array directory. This class doesn't call build() method internally. So you need to pass built message array to constructor of this class. You need to know about detail of the structure of the messages. But you can use new type of message without waiting support its builder class.
> We have released Flex Message, a new message type for the Messaging API. Flex Messages are messages with a customizable layout. You can customize th
We have released Flex Message, a new message type for the Messaging API. Flex Messages are messages with a customizable layout. You can customize the layout freely by combining multiple elements.
https://developers.line.me/en/news/2018/06/
This feature was contributed by @vocolboy. Thank you!
This feature was contributed by @vocolboy. Thank you!
When a user receives a message that contains quick reply buttons from a bot, those buttons appear at the bottom of the chat screen. The user can simply tap one of the buttons to reply to the bot. The quick reply feature can be used in a one-on-one chat with a bot, a group, and a room. You can set up to 13 quick reply buttons to a message of any type.
https://developers.line.me/en/docs/messaging-api/using-quick-reply/
> We have released imageAspectRatio, imageSize, and imageBackgroundColor fields for Buttons and Carousel template messages. Using these fields, you ca
We have released imageAspectRatio, imageSize, and imageBackgroundColor fields for Buttons and Carousel template messages. Using these fields, you can configure the aspect ratio, size, and background color for images used in template messages.
https://developers.line.me/en/news/2017/11/
Added support PHP 7.2. Alternatively we no longer support PHP 5.4.
Added support PHP 7.2. Alternatively we no longer support PHP 5.4.
You can control RichMenu using this library.
https://developers.line.me/en/docs/messaging-api/using-rich-menus/
Cleaned up development environment. Changed composer.json to require library version more relax and revised Makefile and HACKING.md etc.
apigen from require-devBecause it's only needed for owner of this library.
req_mirror is no longer neededWe used to rely on golang implemented http request mirroring server. But I implemented same feature in pure PHP instead.
>Template with multiple images which can be cycled like a carousel.
Template with multiple images which can be cycled like a carousel.
When this action is tapped, a postback event is returned via webhook with the date and time selected by the user from the date and time selection dialog.
https://devdocs.line.me/en/#template-messages
Gets the user profile of a member of a group or room that the bot is in. This can be the user ID of a user who has not added the bot as a friend or has blocked the bot.
https://devdocs.line.me/en/#get-group-room-member-profile
Gets the user IDs of the members of a group or a room that the bot is in. This includes the user IDs of users who have not added the bot as a friend or has blocked the bot. This feature is only available for LINE@ Approved accounts or official accounts.
https://devdocs.line.me/en/#get-group-room-member-ids
This SDK now supports FileMessage. Please refer to the following documentation for more information:
This SDK now supports FileMessage. Please refer to the following documentation for more information:
Ref: https://developers.line.me/news?ny=2017&nm=05
group event and room event can accept/provide the userId #82Ref: https://developers.line.me/news?ny=2017&nm=05
- Changes to the Messaging API specifications
Webhooks will include the user ID of users who send messages in a group or a room if the user has agreed to the “Official Accounts Terms of Use”. Note that the user ID will not be included in the webhook if the user is using a version of LINE below 7.5.0.
For more information about the changes, see the updated API reference and JSON examples at source group and source room.
This SDK supports UnknownEvent and UnknownMessage from this version. If application receives event that has a type that is not supported by this SDK,
UnknownEvent and UnknownMessageThis SDK supports UnknownEvent and UnknownMessage from this version.
If application receives event that has a type that is not supported by this SDK, it encapsulates the event to UnknownEvent'. UnknownMessage` is also the same.
See also: https://github.com/line/line-bot-sdk-php/wiki/How-to-handle-unknown-type-events-and-messages
These exception classes are no longer supported. Please use UnknownEvent and UnknownMessage instead.
2021/07/28
LINE Login v2.0 is deprecated .
Although the date is yet to be determined, LINE Login v2.0 is scheduled for end-of-life in the future, so we recommend that you use LINE Login v2.1. Once determined, the end-of-life time and date will be announced here.
There will be a certain grace period between the end-of-life announcement and the actual end-of-life. For more information, see LINE Login versions .
LINE Login Deprecated Life cycle
Previous post [Resolved] Notice about service outage for the Messaging API Next post [Resolved] Notice about service outage for the Messaging API
Support beacon device message (beacon.dm) Ref: https://devdocs.line.me/#webhook-event-object
Support beacon device message (beacon.dm) Ref: https://devdocs.line.me/#webhook-event-object
Nothing published for this version
https://github.com/line/line-bot-sdk-php/issues/48
https://github.com/line/line-bot-sdk-php/issues/48
https://github.com/line/line-bot-sdk-php/issues/47
The new method MessageEvent#getMessageType() returns type of message event (e.g. text, image)
The new method MessageEvent#getMessageType() returns type of message event (e.g. text, image)
Fix https://github.com/line/line-bot-sdk-php/issues/35
Content-Length: 0 to request header when body of POST is empty (https://github.com/line/line-bot-sdk-php/pull/38)Fix https://github.com/line/line-bot-sdk-php/issues/35
This method returns the identifier of the event source that associated with event source type (i.e. returns any: userId, groupId or roomId).
BaseEvent#getEventSourceId()This method returns the identifier of the event source that associated with event source type (i.e. returns any: userId, groupId or roomId).
https://github.com/line/line-bot-sdk-php/pull/36
https://github.com/line/line-bot-sdk-php/pull/37
Now you can retrieve response header(s) through Response class.
Response classNow you can retrieve response header(s) through Response class.
Related:
Thank you for your suggestion, @samwierema.
Response#getHeader($name)This method returns a response header string, or null if the response does not have a header of that name.
Response#getHeaders()This method returns all of the response headers as string array.
https://github.com/line/line-bot-sdk-php/pull/30
en: https://devdocs.line.me/en/
Docs:
No longer support old trial bot.
2021/09/01
As announced on May 13, 2021 and August 24, 2021 , TLS 1.0 and TLS 1.1 support for LINE API has been discontinued at the end of August 2021.
Domain names of the target LINE API
api.line.me
api-data.line.me
This applies to all LINE APIs using the domain names above, not just specific services.
Supported SSL/TLS protocol versions
We no longer support TLS 1.0 and TLS 1.1.
Protocol version By the end of August 2021 After September 2021
TLS 1.3 ✅ ✅
TLS 1.2 ✅ ✅
TLS 1.1 ✅ ❌
TLS 1.0 ✅ ❌
SSL 3.0 ❌ ❌
SSL 2.0 ❌ ❌
End-of-support date
August 31, 2021
Impact
API requests that use TLS 1.0 or TLS 1.1 will sequentially result in error and no longer will be able to use the LINE API. If your environment is TLS 1.1 or lower, please upgrade your OS, OpenSSL, etc. so that your app or server can continue to communicate using TLS 1.2 or higher.
LINE will continue to improve the quality of its services to its customers. Thank you for your understanding.
LINE Platform SSL/TLS End of life
Previous post [Resolved] Notice about outage for LINE Login and LIFF Next post LINE Login button design guidelines have been changed
Remove polyfill of hash_equals() from SDK dependency.
Remove polyfill of hash_equals() from SDK dependency.
Nothing published for this version
Nothing published for this version
One column per quarter.