PHPackages                             coderflex/laravel-ticket - 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. [Database & ORM](/categories/database)
4. /
5. coderflex/laravel-ticket

ActiveLibrary[Database & ORM](/categories/database)

coderflex/laravel-ticket
========================

Laravel Ticket System, to help you manage your tickets eaisly

v2.3.0(2w ago)43993.6k↓46.7%81[1 issues](https://github.com/coderflexx/laravel-ticket/issues)[4 PRs](https://github.com/coderflexx/laravel-ticket/pulls)1MITPHPPHP ^8.1CI failing

Since Sep 25Pushed 2w ago6 watchersCompare

[ Source](https://github.com/coderflexx/laravel-ticket)[ Packagist](https://packagist.org/packages/coderflex/laravel-ticket)[ Docs](https://github.com/coderflexx/laravel-ticket)[ Fund](https://www.buymeacoffee.com/ousid)[ Fund](https://ko-fi.com/ousid)[ RSS](/packages/coderflex-laravel-ticket/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (10)Dependencies (35)Versions (27)Used By (1)

 [![Laravisit Logo](art/logo.png)](art/logo.png)

[![Latest Version on Packagist](https://camo.githubusercontent.com/3dad83ec5088b807629bd90d96664a0e24d93219e5127fedf0291927c9345caf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f646572666c65782f6c61726176656c2d7469636b65742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/coderflex/laravel-ticket)[![GitHub Tests Action Status](https://camo.githubusercontent.com/6c8b7b60a264e4af7e84bc0fe7f7a08d8b19eee7731237bc90cac110111d3a41/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f646572666c6578782f6c61726176656c2d7469636b65742f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d74657374)](https://github.com/coderflexx/laravel-ticket/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ebc062dce69196a72dedbc67920a46181f8b0c6cbf30bae1ee37593d29e940e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f646572666c6578782f6c61726176656c2d7469636b65742f7068707374616e2e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65)](https://github.com/coderflexx/laravel-ticket/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/631b79529ae600a2a0bd8b7428d21f35712f1112708aad5ddc7fff1e4aa4e004/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f646572666c65782f6c61726176656c2d7469636b65742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/coderflex/laravel-ticket)

- [Introduction](#introduction)
- [Installation](#installation)
- [Configuration](#configuration)
- [Preparing your model](#preparing-your-model)
- [Usage](#usage)
    - [Ticket Table Structure](#ticket-table-structure)
    - [Message Table Structure](#message-table-structure)
    - [Label Table Structure](#label-table-structure)
    - [Category Table Structure](#category-table-structure)
- [API Methods](#api-methods)
    - [Ticket API Methods](#ticket-api-methods)
    - [Ticket Relationship API Methods](#ticket-relationship-api-methods)
    - [Ticket Scopes](#ticket-scopes)
    - [Category & Label Scopes](#category--label-scopes)
- [Handling File Upload](#handling-file-upload)
- [Testing](#testing)
- [Changelog](#changelog)
- [Contributing](#contributing)
- [Security Vulnerabilities](#security-vulnerabilities)
- [Credits](#credits)
- [License](#license)

Introduction
------------

[](#introduction)

**Laravel Ticket** package, is a Backend API to handle your ticket system, with an easy way.

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

[](#installation)

You can install the package via composer:

```
composer require coderflex/laravel-ticket
```

Configuration
-------------

[](#configuration)

You can publish the config file with:

```
php artisan vendor:publish --tag="ticket-config"
```

You can publish and run the migrations with:

```
php artisan vendor:publish --tag="ticket-migrations"
```

Before Running the migration, you may publish the config file, and make sure the current tables does not make a conflict with your existing application, and once you are happy with the migration table, you can run

```
php artisan migrate
```

Preparing your model
--------------------

[](#preparing-your-model)

Add `HasTickets` trait into your `User` model, along with `CanUseTickets` interface

```
...
use Coderflex\LaravelTicket\Concerns\HasTickets;
use Coderflex\LaravelTicket\Contracts\CanUseTickets;
...
class User extends Model implements CanUseTickets
{
    ...
    use HasTickets;
    ...
}
```

Usage
-----

[](#usage)

The Basic Usage of this package, is to create a `ticket`, then associate the `labels` and the `categories` to it.

You can associate as many as `categories`/`labels` into a single ticket.

Here is an example

```
use Coderflex\LaravelTicket\Models\Ticket;
use Coderflex\LaravelTicket\Models\Category;
use Coderflex\LaravelTicket\Models\Label;

...
public function store(Request $request)
{
    /** @var User */
    $user = Auth::user();

    $ticket = $user->tickets()
                    ->create($request->validated());

    $category = Category::first();
    $label = Label::first();

    $ticket->attachCategories($category);
    $ticket->attachLabels($label);

    // or you can create the categories & the tickets directly by:
    // $ticket->categories()->create(...);
    // $ticket->labels()->create(...);

    return redirect(route('tickets.show', $ticket->uuid))
            ->with('success', __('Your Ticket Was created successfully.'));
}

public function createLabel()
{
    // If you create a label seperated from the ticket and wants to
    // associate it to a ticket, you may do the following.
    $label = Label::create(...);

    $label->tickets()->attach($ticket);

    // or maybe
    $label->tickets()->detach($ticket);
}

public function createCategory()
{
    // If you create a category/categories seperated from the ticket and wants to
    // associate it to a ticket, you may do the following.
    $category = Category::create(...);

    $category->tickets()->attach($ticket);

    // or maybe
    $category->tickets()->detach($ticket);
}
...
```

### Ticket Table Structure

[](#ticket-table-structure)

Column NameTypeDefaultID`integer``NOT NULL`UUID`string``NULL`user\_id`integer``NOT NULL`title`string``NOT NULL`message`string``NULL`priority`string``low`status`string``open`is\_resolved`boolean``false`is\_locked`boolean``false`assigned\_to`integer``NULL`created\_at`timestamp``NULL`updated\_at`timestamp``NULL`### Message Table Structure

[](#message-table-structure)

Column NameTypeDefaultID`integer``NOT NULL`user\_id`integer``NOT NULL`ticket\_id`integer``NOT NULL`message`string``NULL`created\_at`timestamp``NULL`updated\_at`timestamp``NULL`### Label Table Structure

[](#label-table-structure)

Column NameTypeDefaultID`integer``NOT NULL`name`string``NULL`slug`string``NULL`is\_visible`boolean``false`created\_at`timestamp``NULL`updated\_at`timestamp``NULL`### Category Table Structure

[](#category-table-structure)

Column NameTypeDefaultID`integer``NOT NULL`name`string``NULL`slug`string``NULL`is\_visible`boolean``false`created\_at`timestamp``NULL`updated\_at`timestamp``NULL`API Methods
-----------

[](#api-methods)

### Ticket API Methods

[](#ticket-api-methods)

The `ticket` model came with handy methods to use, to make your building process easy and fast, and here is the list of the available **API**:

MethodArgumentsDescriptionExampleChainable`archive``void`archive the ticket`$ticket->archive()`✓`close``void`close the ticket`$ticket->close()`✓`reopen``void`reopen a closed ticket`$ticket->reopen()`✓`markAsResolved``void`mark the ticket as resolved`$ticket->markAsResolved()`✓`markAsLocked``void`mark the ticket as locked`$ticket->markAsLocked()`✓`markAsUnlocked``void`mark the ticket as unlocked`$ticket->markAsUnlocked()`✓`markAsArchived``void`mark the ticket as archived`$ticket->markAsArchived()`✓`closeAsResolved``void`close the ticket and marked it as resolved`$ticket->closeAsResolved()`✓`closeAsUnresolved``void`close the ticket and marked it as unresolved`$ticket->closeAsUnresolved()`✓`reopenAsUnresolved``void`reopen the ticket and marked it as unresolved`$ticket->reopenAsUnresolved()`✓`isArchived``void`check if the ticket archived`$ticket->isArchived()`✗`isOpen``void`check if the ticket open`$ticket->isOpen()`✗`isClosed``void`check if the ticket closed`$ticket->isClosed()`✗`isResolved``void`check if the ticket has a resolved status`$ticket->isResolved()`✗`isUnresolved``void`check if the ticket has an unresolved status`$ticket->isUnresolved()`✗`isLocked``void`check if the ticket is locked`$ticket->isLocked()`✗`isUnlocked``void`check if the ticket is unlocked`$ticket->isUnlocked()`✗`assignTo``void`assign ticket to a user`$ticket->assignTo($user)` or `$ticket->assignTo(2)`✓`makePriorityAsLow``void`make ticket priority as low`$ticket->makePriorityAsLow()`✓`makePriorityAsNormal``void`make ticket priority as normal`$ticket->makePriorityAsNormal()`✓`makePriorityAsHigh``void`make ticket priority as high`$ticket->makePriorityAsHigh()`✓The **Chainable** column, is showing the state for the method, that if it can be chained or not, something like

```
    $ticket->archive()
            ->close()
            ->markAsResolved();
```

### Ticket Relationship API Methods

[](#ticket-relationship-api-methods)

The `ticket` model has also a list of methods for interacting with another related models

MethodArgumentsDescriptionExample`attachLabels``mixed` ID, `array` attributes, `bool` touchassociate labels into an existing ticket`$ticket->attachLabels([1,2,3,4])``syncLabels``Model/array` IDs, `bool` detouchingassociate labels into an existing ticket`$ticket->syncLabels([1,2,3,4])``attachCategories``mixed` ID, `array` attributes, `bool` touchassociate categories into an existing ticket`$ticket->attachCategories([1,2,3,4])``syncCategories``Model/array` IDs, `bool` detouchingassociate categories into an existing ticket`$ticket->syncCategories([1,2,3,4])``message``string` messageadd new message on an existing ticket`$ticket->message('A message in a ticket')``messageAsUser``Model/null` user, `string` messageadd new message on an existing ticket as a different user`$ticket->messageAsUser($user, 'A message in a ticket')`> The `attachCategories` and `syncCategories` methods, is an alternative for `attach` and `sync` laravel methods, and if you want to learn more, please take a look at this [link](https://laravel.com/docs/9.x/eloquent-relationships#attaching-detaching)

The `commentAsUser` accepts a user as a first argument, if it's null, the **authenticated** user will be user as default.

### Ticket Scopes

[](#ticket-scopes)

The `ticket` model has also a list of scopes to begin filter with.

MethodArgumentsDescriptionExample`closed``void`get the closed tickets`Ticket::closed()->get()``opened``void`get the opened tickets`Ticket::opened()->get()``archived``void`get the archived tickets`Ticket::archived()->get()``unArchived``void`get the unArchived tickets`Ticket::unArchived()->get()``resolved``void`get the resolved tickets`Ticket::resolved()->get()``locked``void`get the locked tickets`Ticket::locked()->get()``unlocked``void`get the unlocked tickets`Ticket::unlocked()->get()``withLowPriority``void`get the low priority tickets`Ticket::withLowPriority()->get()``withNormalPriority``void`get the normal priority tickets`Ticket::withNormalPriority()->get()``withHighPriority``void`get the high priority tickets`Ticket::withHighPriority()->get()``withPriority``string` $priorityget the withPriority tickets`Ticket::withPriority('critical')->get()`### Category & Label Scopes

[](#category--label-scopes)

MethodArgumentsDescriptionExample`visible``void`get the visible model records`Label::visible()->get()``hidden``void`get the hidden model records`Category::visible()->get()`Handling File Upload
--------------------

[](#handling-file-upload)

This package doesn't come with file upload feature (yet) Instead you can use [laravel-medialibrary](https://github.com/spatie/laravel-medialibrary) by **Spatie**, to handle file functionality.

The steps are pretty straight forward, all what you need to do is the following.

Extends the `Ticket` model, by creating a new model file in your application by

```
php artisan make:model Ticket

```

Then extend the base `Ticket Model`, then use `InteractWithMedia` trait by spatie package, and the interface `HasMedia`:

```
namespace App\Models\Ticket;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class Ticket extends \Coderflex\LaravelTicket\Models\Ticket implements HasMedia
{
    use InteractsWithMedia;
}
```

The rest of the implementation, head to [the docs](https://spatie.be/docs/laravel-medialibrary/v10/introduction) of spatie package to know more.

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [ousid](https://github.com/ousid)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance97

Actively maintained with recent releases

Popularity54

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 63.6% 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 ~71 days

Recently: every ~118 days

Total

20

Last Release

15d ago

Major Versions

v1.6.0 → v2.0.02024-04-08

1.x-dev → v2.2.02026-04-14

### Community

Maintainers

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

---

Top Contributors

[![ousid](https://avatars.githubusercontent.com/u/21012933?v=4)](https://github.com/ousid "ousid (91 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (21 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (14 commits)")[![neazk](https://avatars.githubusercontent.com/u/28840712?v=4)](https://github.com/neazk "neazk (5 commits)")[![krekas](https://avatars.githubusercontent.com/u/11015977?v=4)](https://github.com/krekas "krekas (4 commits)")[![JaberWiki](https://avatars.githubusercontent.com/u/55241455?v=4)](https://github.com/JaberWiki "JaberWiki (1 commits)")[![juliangarcess](https://avatars.githubusercontent.com/u/41131304?v=4)](https://github.com/juliangarcess "juliangarcess (1 commits)")[![akiyamaSM](https://avatars.githubusercontent.com/u/12276076?v=4)](https://github.com/akiyamaSM "akiyamaSM (1 commits)")[![zainphp](https://avatars.githubusercontent.com/u/19289785?v=4)](https://github.com/zainphp "zainphp (1 commits)")[![DannyCooper](https://avatars.githubusercontent.com/u/152804?v=4)](https://github.com/DannyCooper "DannyCooper (1 commits)")[![dominosaurs](https://avatars.githubusercontent.com/u/19289785?v=4)](https://github.com/dominosaurs "dominosaurs (1 commits)")[![ennikin-skywalker](https://avatars.githubusercontent.com/u/9866493?v=4)](https://github.com/ennikin-skywalker "ennikin-skywalker (1 commits)")[![giacomomasseron](https://avatars.githubusercontent.com/u/16156317?v=4)](https://github.com/giacomomasseron "giacomomasseron (1 commits)")

---

Tags

customer-supporteloquenthelpdesklaravellaravel-packagephpsupport-ticketticketing-systemticketslaravelcoderflexlaravel-ticket

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/coderflex-laravel-ticket/health.svg)

```
[![Health](https://phpackages.com/badges/coderflex-laravel-ticket/health.svg)](https://phpackages.com/packages/coderflex-laravel-ticket)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k102.4M1.4k](/packages/spatie-laravel-permission)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[wnx/laravel-backup-restore

A package to restore database backups made with spatie/laravel-backup.

213421.0k2](/packages/wnx-laravel-backup-restore)[spatie/laravel-passkeys

Use passkeys in your Laravel app

471890.7k39](/packages/spatie-laravel-passkeys)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)

PHPackages © 2026

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