PHPackages                             andydefer/laravel-task - 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. andydefer/laravel-task

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

andydefer/laravel-task
======================

A lightweight, file-based task system for Laravel with async execution, recurring tasks, and JSONL storage

v3.15.3(4w ago)0562MITPHPPHP >=8.1

Since May 25Pushed 1mo agoCompare

[ Source](https://github.com/andydefer/laravel-task)[ Packagist](https://packagist.org/packages/andydefer/laravel-task)[ RSS](/packages/andydefer-laravel-task/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (15)Versions (47)Used By (2)

Laravel Task
============

[](#laravel-task)

**Un système de tâches léger pour Laravel avec exécution asynchrone, tâches récurrentes et stockage structuré.**

[![PHP Version](https://camo.githubusercontent.com/83dd395020c37276225039739320f6c8e7e99963ab21ee3d09282cb48dad2a60/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d626c7565)](https://php.net)[![Laravel Version](https://camo.githubusercontent.com/ba69236eb9bfe25effcb7eb44086de41847364b41b47c2e3f6c3975cd2653974/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e7825323025374325323031332e7825323025374325323031342e7825323025374325323031352e782d626c7565)](https://laravel.com)[![License](https://camo.githubusercontent.com/5caa455d8debc46fb23abbadb45a733a937f3910a73fc875c2f7820468e1bb54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e)](LICENSE)

---

Table des matières
------------------

[](#table-des-matières)

1. [Installation](#installation)
2. [Concepts fondamentaux](#concepts-fondamentaux)
3. [Créer une tâche unique](#cr%C3%A9er-une-t%C3%A2che-unique)
4. [Créer une tâche récurrente](#cr%C3%A9er-une-t%C3%A2che-r%C3%A9currente)
5. [Exécuter les tâches](#ex%C3%A9cuter-les-t%C3%A2ches)
6. [Surveillance continue avec TasksWatch](#surveillance-continue-avec-taskswatch)
7. [Gestion des tâches](#gestion-des-t%C3%A2ches)
8. [Mode test](#mode-test)
9. [Bonnes pratiques](#bonnes-pratiques)
10. [Référence des commandes](#r%C3%A9f%C3%A9rence-des-commandes)
11. [Licence](#licence)

---

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

[](#installation)

```
composer require andydefer/laravel-task
```

### Prérequis

[](#prérequis)

- PHP 8.1 ou supérieur
- Laravel 12.x, 13.x, 14.x ou 15.x

### Publier les migrations

[](#publier-les-migrations)

```
php artisan vendor:publish --tag=task-migrations
php artisan migrate
```

### Service Provider

[](#service-provider)

Le package s'enregistre automatiquement via `TaskServiceProvider`. Aucune configuration supplémentaire n'est nécessaire.

---

Concepts fondamentaux
---------------------

[](#concepts-fondamentaux)

### Types de tâches

[](#types-de-tâches)

TypeDescriptionCas d'usage**Unique**Tâche exécutée une seule fois à une date planifiéeEnvoi d'email, génération de rapport, notification**Récurrente**Tâche exécutée en boucle selon un intervalleNettoyage de cache, synchronisation de données### Architecture

[](#architecture)

Le package suit une architecture en couches :

```
Directives (CLI) → Services (Métier) → Processors → Runners → Repositories → Base de données

```

**Principe clé :** Utilisez toujours les **services** (via `getLaravel()->make()`) plutôt que les facades pour une meilleure testabilité.

---

Créer une tâche unique
----------------------

[](#créer-une-tâche-unique)

### 1. Créer la classe de la tâche

[](#1-créer-la-classe-de-la-tâche)

```