PHPackages                             php-core/laravel-madeline-proto - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. php-core/laravel-madeline-proto

ActiveLibrary[Utility & Helpers](/categories/utility)

php-core/laravel-madeline-proto
===============================

A third party Telegram client library danog/MadelineProto wrapper for Laravel

v0.0.1(8mo ago)01.0kAGPL-3.0-onlyPHPPHP ^8.4CI passing

Since Oct 16Pushed 8mo agoCompare

[ Source](https://github.com/php-core/laravel-madeline-proto)[ Packagist](https://packagist.org/packages/php-core/laravel-madeline-proto)[ RSS](/packages/php-core-laravel-madeline-proto/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (8)Versions (2)Used By (0)

Laravel MadelineProto
=====================

[](#laravel-madelineproto)

[![Latest Stable Version](https://camo.githubusercontent.com/b9d4bc88526c68463eb251a24fa791229a60856de2cc5f44f0bfc24ff4c7e306/68747470733a2f2f706f7365722e707567782e6f72672f7068702d636f72652f6c61726176656c2d6d6164656c696e652d70726f746f2f76)](//packagist.org/packages/php-core/laravel-madeline-proto)[![Total Downloads](https://camo.githubusercontent.com/2bbbad65da56c101365ea680a997602751143624c80a2d98bff3da2896cd9921/68747470733a2f2f706f7365722e707567782e6f72672f7068702d636f72652f6c61726176656c2d6d6164656c696e652d70726f746f2f646f776e6c6f616473)](//packagist.org/packages/php-core/laravel-madeline-proto)[![License](https://camo.githubusercontent.com/210d5c849cef250c8e4a8aa749ca055c6d952475fa5d04d59effe14fc652b486/68747470733a2f2f706f7365722e707567782e6f72672f7068702d636f72652f6c61726176656c2d6d6164656c696e652d70726f746f2f6c6963656e7365)](//packagist.org/packages/php-core/laravel-madeline-proto)[![Tests](https://github.com/php-core/laravel-madeline-proto/actions/workflows/tests.yml/badge.svg)](https://github.com/php-core/laravel-madeline-proto/actions/workflows/tests.yml)

A third party Telegram client library [danog/MadelineProto](https://github.com/danog/MadelineProto) wrapper for Laravel. Updated to support latest MadelineProto and PHP 8.4 by PHPCore

Getting Started
===============

[](#getting-started)

Add the laravel-madeline-proto to the project dependency:

```
composer require php-core/laravel-madeline-proto
```

Then publish the `telegram.php` config file:

```
php artisan vendor:publish --provider="PHPCore\MadelineProto\MadelineProtoServiceProvider"
```

Set up the Telegram API key by providing env variables:

```
MP_TELEGRAM_API_ID=... //your telegram api id here
MP_TELEGRAM_API_HASH=... //your telegram api hash here
```

This wrapper package supports for running both [single](https://github.com/php-core/laravel-madeline-proto/wiki/Single-Telegram-Account) / [multiple](https://github.com/php-core/laravel-madeline-proto/wiki/Multiple-Telegram-Account) telegram account.

Dig Deeper
----------

[](#dig-deeper)

Please check [wiki](https://github.com/php-core/laravel-madeline-proto/wiki) for more details about laravel-madeline-proto usage

Testing
=======

[](#testing)

Automated Testing
-----------------

[](#automated-testing)

This package uses Pest PHP for automated testing. To run the test suite:

```
composer test
```

For more details on automated testing, see [TESTING.md](TESTING.md).

Manual Testing with Telegram
----------------------------

[](#manual-testing-with-telegram)

To test the package with actual Telegram API connections locally:

1. Copy `.env.example` to `.env` and add your credentials
2. Run the test script: `php test-telegram.php`
3. Send test messages: `php test-send-message.php "Hello!"`

For detailed instructions, see [MANUAL\_TESTING.md](MANUAL_TESTING.md).

### Integration Tests

[](#integration-tests)

Run integration tests that interact with real Telegram API:

```
export MP_INTEGRATION_TESTS=true
vendor/bin/pest tests/Integration
```

These tests will send actual messages to the chat ID configured in `MP_TEST_CHAT_ID` (defaults to "me" for Saved Messages).

Notes
=====

[](#notes)

- This wrapper package is still not wrapping all the apis yet, I'm still focusing on wrapping the messages api.
- If you can't find the method that you want in Messages facade or need to use the default danog/MadelineProto api, you might want to use `MadelineProto::getClient()` facade method. It will return `danog\MadelineProto\API` object where you can call all the method provided by the [danog/MadelineProto](https://github.com/danog/MadelineProto) library.

Thanks To
=========

[](#thanks-to)

[setiawanhu](https://github.com/setiawanhu) for the base version this package is based on

[Bryan Ramaputra](https://github.com/Ordinal43) for helping me to write readable documentations.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance59

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

261d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/103283996?v=4)[PHP Core](/maintainers/php-core)[@php-core](https://github.com/php-core)

---

Tags

laraveltelegrammadeline-proto

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/php-core-laravel-madeline-proto/health.svg)

```
[![Health](https://phpackages.com/badges/php-core-laravel-madeline-proto/health.svg)](https://phpackages.com/packages/php-core-laravel-madeline-proto)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[illuminate/queue

The Illuminate Queue package.

21332.6M1.6k](/packages/illuminate-queue)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k91.0k1](/packages/mike-bronner-laravel-model-caching)[fumeapp/modeltyper

Generate TypeScript interfaces from Laravel Models

198321.1k](/packages/fumeapp-modeltyper)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)