PHPackages                             kusabi/messages - 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. kusabi/messages

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

kusabi/messages
===============

A library implementing a response message manager

1.0.1(6y ago)032mitPHPPHP ~7.2CI failing

Since Mar 23Pushed 6y ago1 watchersCompare

[ Source](https://github.com/kusabi/messages)[ Packagist](https://packagist.org/packages/kusabi/messages)[ RSS](/packages/kusabi-messages/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (1)Dependencies (6)Versions (4)Used By (0)

[![Release Badge](https://camo.githubusercontent.com/a5acf3f745097087941cd9c2cb034725bf8335015e5f2bf2f78808fe9a874e14/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6b75736162692f6d657373616765732e737667)](https://img.shields.io/github/release/kusabi/messages.svg)[![Tag Badge](https://camo.githubusercontent.com/01718825e55357b2b96bec811a7869bdffa5a489f5f43b964e1056bacecfd9ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f6b75736162692f6d657373616765732e737667)](https://img.shields.io/github/tag/kusabi/messages.svg)[![Licence Badge](https://camo.githubusercontent.com/5673af2131cb523bdc3d3f30665e5654636d0fc70078a4e39582348bc609c46a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6b75736162692f6d657373616765732e737667)](https://img.shields.io/github/license/kusabi/messages.svg)[![Issues Badge](https://camo.githubusercontent.com/60206f0c9efc2128cddafc554c8509c34fab4bed93f65647fa47bdcceee7ed84/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6b75736162692f6d657373616765732e737667)](https://img.shields.io/github/issues/kusabi/messages.svg)[![Codacy Badge](https://camo.githubusercontent.com/d1b19a3830b94289437a1b5cb9ac7d4d30c5a5e6dcc1b467516f02d349d5d526/68747470733a2f2f696d672e736869656c64732e696f2f636f646163792f67726164652f37656334643936343138396634646133383435623830633030396638643866652e737667)](https://img.shields.io/codacy/grade/7ec4d964189f4da3845b80c009f8d8fe.svg)[![Code Size](https://camo.githubusercontent.com/edbdc9ad91a61da6079a1dcee25de852e1a06373e958776d0ad76084c00ad428/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c616e6775616765732f636f64652d73697a652f6b75736162692f6d657373616765732e737667)](https://img.shields.io/github/languages/code-size/kusabi/messages.svg)

A message collection library for responses.

It is compatible with the PSR LoggerInterface.

How to use Messages
===================

[](#how-to-use-messages)

A message is the smallest unit in the library.

It contains a message and a context.

The message is a `string` and the context is an `array`.

All manipulator methods return the instance of Message for fluid chaining.

`$message->setMessage('Success')->setContext([1, 2, 3]);`

```
use Kusabi\Messages\Message;

// Creating a blank message
$message = new Message();

// Creating a message with a simple success string
$message = new Message('Successfully retrieved users');

// Creating a message with context.
// Here the context suggests we are only retriving recent users.
$message = new Message('Successfully retrieved users', [
    'created' => 'recent'
]);

// Updating the message after creation
$message->setMessage('Changed the message');
$message->setContext([
    'created' => 'recent',
    'changed_at' => date('Y-m-d H:i:s')
]);

// Merging more context data into the context array
$message->mergeContext([
    'changed_at' => date('Y-m-d H:i:s'),
    'reason' => 'merged'
]);

// Add more entries to the context using a key and value
$message->addContext('php', '7.2');

// Retrieving the values
$message->getMessage();
$message->getContext();

// Json encode the message
echo json_encode($message); // {"message":"Changed the message", "context":{...}}

// Cast as string just returns the message
echo (string) $message; // "Changed the message"
```

How to use Message Groups
=========================

[](#how-to-use-message-groups)

A message group is a collection of messages.

It is an array wrapper around this collection of message.

All manipulator methods return the instance of MessageGroup for fluid chaining.

```
$messageGroup->addMessage('Success', [])->clearMessages()->count();
```

```
// Creating a Message Group
$messageGroup = new MessageGroup();
$messageGroup->addMessage('Test Message', [
    'context' => 1
]);
$messageGroup->addMessageInstance(
    new Message('Test message')
);
$messageGroup[] = new Message('Test');

// Clearing the message group
$messageGroup->setMessages([]);
$messageGroup->clearMessages();

// Accessing Message Group properties
if (count($messageGroup) > 0) {
    foreach($messageGroup as $message) {
        echo $message->getMessage();
    }
    $messageGroup->clearMessages();
}

// Json encode the message group
echo json_encode($messageGroup); // [{"message":"First Message", "context":{...}},{"message":"Second Message", "context":{...}}]

// Cast as string just returns the messages
echo (string) $messageGroup; // "First Message, Second Message"
```

How to use Message Collections
==============================

[](#how-to-use-message-collections)

A message collection is a collection of message groups.

It has one for each verbosity level.

It acts as an array wrapper around this collection of message groups.

All manipulator methods return the instance of MessageCollection for fluid chaining.

```
$messageCollection
    ->success('It worked')
    ->notice('We will be experiencing down time shortly', [
        'start' => '1970-01-01 12:00:00'
    ]);
```

```
// Creating a Message Collection
$messageCollection = new MessageCollection();
$messageCollection->info('We will be experiencing downtime next Sunday', [
    'timestamp' => $nextWeek->getTimestamp()
]);
$messageCollection->error('Failed to connect to database', [
    'host' => '127.0.0.1',
    'password' => 'secret'
]);

// Accessing Message Collection properties
$messageCollection->getMessageGroups();
$messageCollection->getMessages();
```

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Every ~210 days

Total

2

Last Release

2445d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/62f4942978644437b5ff3d7bd3f6411580413d327b001104acd4914f43ab63b6?d=identicon)[kusabi](/maintainers/kusabi)

---

Top Contributors

[![kusabi](https://avatars.githubusercontent.com/u/22000941?v=4)](https://github.com/kusabi "kusabi (3 commits)")

---

Tags

messagespsr-3response

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/kusabi-messages/health.svg)

```
[![Health](https://phpackages.com/badges/kusabi-messages/health.svg)](https://phpackages.com/packages/kusabi-messages)
```

###  Alternatives

[symfony/lock

Creates and manages locks, a mechanism to provide exclusive access to a shared resource

514135.1M628](/packages/symfony-lock)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[phpro/soap-client

A general purpose SoapClient library

8895.9M52](/packages/phpro-soap-client)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

562565.8k42](/packages/ecotone-ecotone)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751284.3k37](/packages/civicrm-civicrm-core)[illuminate/broadcasting

The Illuminate Broadcasting package.

7126.9M203](/packages/illuminate-broadcasting)

PHPackages © 2026

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