PHPackages                             fenos/mex - 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. [API Development](/categories/api)
4. /
5. fenos/mex

ActiveLibrary[API Development](/categories/api)

fenos/mex
=========

Multi participants Chat API for laravel 4

1.0.7(12y ago)23712MITPHPPHP >=5.4.0

Since May 14Pushed 11y ago2 watchersCompare

[ Source](https://github.com/fenos/Mex)[ Packagist](https://packagist.org/packages/fenos/mex)[ RSS](/packages/fenos-mex/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (6)Dependencies (3)Versions (9)Used By (0)

Mex
===

[](#mex)

### Package out of date Not useful in production

[](#package-out-of-date-not-useful-in-production)

=====

[![Build Status](https://camo.githubusercontent.com/e2b315a9186092492982a4632e68cce205d4cbb8b18c38db77088faf0172d841/68747470733a2f2f7472617669732d63692e6f72672f66656e6f732f4d65782e7376673f6272616e63683d312e302e30)](https://travis-ci.org/fenos/Mex)[![License](https://camo.githubusercontent.com/c19c646b7d2578c3a72a46a18ce4b3cb03744203f0f2619828722e27a6821095/68747470733a2f2f706f7365722e707567782e6f72672f66656e6f732f6d65782f6c6963656e73652e706e67)](https://packagist.org/packages/fenos/mex)[![Latest Stable Version](https://camo.githubusercontent.com/6a5be55a74cc9395e79fa415e128d34cf0e6e99d5ed4934f2d4d6ea586d2bf87/68747470733a2f2f706f7365722e707567782e6f72672f66656e6f732f6d65782f762f737461626c652e706e67)](https://packagist.org/packages/fenos/mex)

Hi guys, I want to present Mex, Mex is a simple but powerful API for build a internal multi participants chat system. This API come with a lots features, and the syntax is pretty straightforward, Now you have the tools for build your own multi participants chat with laravel 4. Enjoy it.

- [Installation](#installation)
- [Documentation](#documentation)
- [Conversations](#conversations)
    - [Conversation Exists](#conversation-exists)
    - [Create Conversations](#create-conversations)
    - [Archive & Restore Conversations](#archive--restore-conversations)
    - [Join & Leave Conversations](#join--leave-conversations)
    - [Lists Conversations](#lists-conversations)
    - [Force remove Conversations](#force-remove-conversations)
- [Messages](#messages)
    - [Send Messages](#send-messages)
    - [Get Messages Conversation](#get-messages-conversation)
    - [Delete Messages](#delete-messages)
- [Note](#note)
- [Credits](#credits)

Installation
------------

[](#installation)

### Step 1

[](#step-1)

Add it on your composer.json

```
"fenos/mex": "1.0.*"

```

and run **composer update**

### Step 2

[](#step-2)

Add the following string to **app/config/app.php**

**Providers array:**

```
'Fenos\Mex\MexServiceProvider'

```

**Aliases array:**

```
'Mex'    => 'Fenos\Mex\Facades\Mex'

```

### Step 3

[](#step-3)

#### Migration

[](#migration)

Make sure that your settings on **app/config/database.php** are correct, then make the migration typing:

```
php artisan migrate --package="fenos/mex"

```

### Step 4

[](#step-4)

#### Include relations

[](#include-relations)

For include the realtions that mex will need to know you have just to import the Following trait on your model siply like so

```

    class User extends Eloquent
    {

        use \Fenos\Mex\Models\MexRelations;

    }

```

That's it your have done.

Documentation
-------------

[](#documentation)

As first approch to Mex you have to know that this package is based on conversations, so before any action, you have to retrive the current conversation to work with. Said that we can start.

### Conversations

[](#conversations)

The code that you will use, in few words, always, for initialize a conversation will be:

```
Mex::conversation($conversation_id);

```

Another useful method is `participants`, with it you can retrive conversations knowing only the participants ID But be aware that when a conversation is started you have to get it having the conversation id. Because if any of the participants join or leave the conversation the conversation will have a different numbers of participants and for retrive it again you have to pass the new participants that was joined or without who leaved the conversation.

```
Mex::conversation()->participants(1,2,3,4);

```

#### Conversation Exists

[](#conversation-exists)

If you wanna check if a conversation exists as said above you can do it in 2 different ways.

**Having the ID of the conversation**

```
try
{
    Mex::conversation($conversation_id)->exists();
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // do your staff
}

```

**Having only the participants ID**

```
try
{
    Mex::conversation()->participants(1,2,3,4)->exists();
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // do your staff
}

```

On the `participants()` method you will pass the IDS of the participants "Users" (for now). But remember that you can pass even an **array** of them!

#### Create Conversations

[](#create-conversations)

For create conversations is really easy, Let me show the code, it is more easy show it then explain it in this case. Then review it.

```
// this will create a multi conversation between users 1 - 2 and 3
Mex::conversation()->participants(1,2,3)->create(['founder_id' => 1]);

```

So what's going on here I'm telling to `Mex` that i'm working with a `conversation`, and I know, that I need to create it, so I pass the participants that "will start to chat", and then I pass the founder id in an array easy hum?.

Keep in mind that the `founder_id` must be specified but you can even omit it on the participants values/array.

Also **very important** the create method doesn't check if the conversation has been already start between thoose participants, so before create it make sure you check that.

```

$participants = [1,2,3];
$founder = Auth::user()->id;
try
{
    Mex::conversation()->participants($participants)->exists();

    // here means that exists so you can just send a message in the conversation we will see it later
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
    Mex::conversation()->participants($participants)->create(['founder_id' => $founder]);
}

```

That's it!

#### Archive & Restore Conversations

[](#archive--restore-conversations)

##### Archive

[](#archive)

Archive conversations doesn't mean delete it, but just store it as archived maybe a old conversation that you don't wanna have as active. With Mex you can do it really easy and quick let me show you.

```
try
{
    Mex::conversation($conversation_id)->from($user_id)->archive(); // that's it, the user 1 has archived the conversation
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

Second approch

```
try
{
    Mex::conversation()->participants(1,2,3)->from($user_id)->archive(); // that's it, the user 1 has archived the conversation
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

How you saw here I used a new method called `from()` this method is really important for determinate who does the action. Because do you know that if the `user with ID 1` archive the conversation that even `User ID 2` is in, **only** `User ID 1` will have it as archived, while the user 2 still normal. So speicfy always the user with `from()` when you do any action that focus only 1 User.

##### Restore

[](#restore)

For restore a conversation and have it again as "active" use the method `restore()` instead:

```
try
{
    Mex::conversation($conversation_id)->from($user_id)->restore(); // that's it, the user 1 has restored the conversation
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

You can use even partecipants method here.

#### Lists Conversations

[](#lists-conversations)

Do you need to retrive a nice lists of the conversations that the current user has started or has been invited? Ok well use this one, but keep in mind that the archived conversations will be not showed here.

What you aspect from this method? Lists of conversations / informations participants / last message sent

```
Mex::conversation()->from($user_id)->lists();

```

This method right now will get all conversations about that user, but if the user has 1000 conversations? Relax you have 3 filters for that and i'm sure you know thoose.

```
// limit the result to 10 conversation and order it
Mex::conversation()->from($user_id)->lists( array('limit' => 10,'orderBy' => 'DESC') );

// paginate it
Mex::conversation()->from($user_id)->lists( array(['orderBy' => 'ASC', 'paginate' => 10) );

```

**New filter**

if you want exclude the founder informations inside the participants results pass use the filter `founder` with false value like so:

```
Mex::conversation()->from($user_id)->lists( array(['orderBy' => 'ASC', 'paginate' => 10, 'founder' => false) );

```

If instead you need to retrive the archived lists of conversations you use this method:

```
// you can have the parameters as above
Mex::conversation()->from($user_id)->archivedLists();

```

#### Join & Leave Conversations

[](#join--leave-conversations)

The user has already a conversation started with others but he want to add someone else. You can give this feature to you chat using the `join()` method see how:

```
try
{
    Mex::conversation($conversation_id)->join(4,5); // user 4 and 5 are joined now in the conversation

catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

Instead if you wanna leave the conversation use `leave()` instead

```
try
{
    Mex::conversation($conversation_id)->leave(4,5); // user 4 and 5 are leaved now in the conversation

catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

#### Force remove Conversations

[](#force-remove-conversations)

Removing the conversations means that, the user will not see the conversation anymore **Only the user that does the action** others participants will still see the conversation. And the conversation can be restored using the `restore` method just in case. Keep also in mind that the user will not leave the conversation if he delete the conversation this is up to you. Let's see how force delete the conversation.

```
try
{
    Mex::conversation($id)->from($user_id)->forceRemove();

catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

Messages
--------

[](#messages)

After you learned about conversations now is time to focus on the messages (Nothing more hard then conversations). See how it easilly works.

### Send Messages

[](#send-messages)

for send message is really easy let me show the code and then review it.

```
try
{
    Mex::conversation($conversation_id)->message('Text of your message')->from(1)->send();

catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

I told you, is almost self explained but I review it. We are getting the conversation and passing the id of it, in this conversation we know that we have to send the message. Next, we use `message()` method with inside the text of the message. Next witch user send the message? i specific him with `from()` method. Now Mex know everything for deliver the message on the right place and use `send()`.

Now I want even review Create a conversation and sending the message on the same time! That is the main action that an chat must to have.

```

try
{
    // check if the conversation exists
    $conversation = Mex::conversation()->participants(1,2,3)->exists();

    // yes exists, the method above give to me the ID of the conversation and i send only the message
    Mex::conversation($conversation->conversation_id)->message('Conversation exists')->from(1)->send();
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // the conversation doesn't exists so I create a new
    $newConversation = Mex::conversation()->participants(1,2,3)->create(['founder_id'=> 1]);

    // and I send the message to the current conversation
    $newConversation->message('New conversation')->from(1)->send();
}

```

Cool isn't?

### Get Messages Conversation

[](#get-messages-conversation)

Finally we have almost done, now is time to get the messages of a conversation. Here you have 2 ways to get messages of a conversation.

First of all how I mentioned on the documentation the method `from()` is very important for let Mex know wich user want to retreive the messages so I'll use the following.

```
try
{
    Mex::conversation($conversation_id)->from(1)->get();
}
catch()
{
    // conversation not found
}

```

Using `from()` method **no external users can access to conversation if an user ID that not belongs to any of the currents IDS on the conversation**, it will throw `ConversationNotFoundException`.

Also if the user has some massage deleted using `from()` will not show it obviously,they are deleted for this user, but **not for others in the conversation**.

The second method get the entirely conversation with all deleted messages as well, so is not useful for users but I document it.

```
try
{
    Mex::conversation($conversation_id)->get();
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

If you want to `limit` or `order` or `paginate` the messages pass the array on the `get()` method

```
Mex::conversation($conversation_id)->from(1)->get(['limit' => 10,'orderBy' => 'DESC']);
Mex::conversation($conversation_id)->from(1)->get(['orderBy' => 'DESC','paginate' => '10']); // paginate as last paramater of the array

```

Also Important, you can retrive the messages of conversations "active" and "Archived" but **Not conversation that has been ForceDeleted** it will throw `ConversationNotFoundException`

### Delete Messages

[](#delete-messages)

The good feature of deleting messages is that only the user that delete the message will not see it anymore but the others participants still see it. Let's see how a user delete a message.

```
try
{
    // this delete the message with id 1 for the user with 1 on the conversation with id 1!! :)
    Mex::conversation($conversaton_id)->message($message_id)->from($user_id)->delete();

    // if you prefer to use from() method after the conversation() method do it is the same
    Mex::conversation($conversaton_id)->from($user_id)->message($message_id)->delete();
}
catch(\Fenos\Mex\Exceptions\ConversationNotFoundException $e)
{
    // conversation not found
}

```

### Note

[](#note)

How you can see this is the first realease and it seem to promises well. Soon if time permit `Mex` will have new features already designed. Example it will come Polymorphic as well, how you can see on the migration files the tables are already setted for it :). For the rest feautures will come out more as surprise. :)

I made it with <3

### Tests

[](#tests)

For run the tests make sure to have phpUnit and Mockery installed

### Credits

[](#credits)

© Copyright Fabrizio Fenoglio

Released package under MIT Licence.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 97.4% 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 ~0 days

Total

8

Last Release

4383d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab9e036805ae0f49f15155a92bd8e949032f04cbb54ff82a632ee333c25fe505?d=identicon)[slypver3](/maintainers/slypver3)

---

Top Contributors

[![fenos](https://avatars.githubusercontent.com/u/4754064?v=4)](https://github.com/fenos "fenos (38 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (1 commits)")

---

Tags

laravelchatAPI chat

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/fenos-mex/health.svg)

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

###  Alternatives

[andreaselia/laravel-api-to-postman

Generate a Postman collection automatically from your Laravel API

1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[mollie/laravel-mollie

Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite

3624.1M28](/packages/mollie-laravel-mollie)[api-ecosystem-for-laravel/dingo-api

A RESTful API package for the Laravel and Lumen frameworks.

3121.5M10](/packages/api-ecosystem-for-laravel-dingo-api)[mll-lab/laravel-graphiql

Easily integrate GraphiQL into your Laravel project

683.2M9](/packages/mll-lab-laravel-graphiql)[kirschbaum-development/laravel-openapi-validator

Automatic OpenAPI validation for Laravel HTTP tests

581.1M5](/packages/kirschbaum-development-laravel-openapi-validator)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

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