Download the PHP package andydefer/laravel-reminder without Composer
On this page you can find all versions of the php package andydefer/laravel-reminder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download andydefer/laravel-reminder
More information about andydefer/laravel-reminder
Files in andydefer/laravel-reminder
Package laravel-reminder
Short Description A flexible and robust reminder system for Laravel
License MIT
Informations about the package laravel-reminder
Laravel Reminder
Une solution flexible et robuste pour gérer les rappels dans vos applications Laravel.
Introduction
Laravel Reminder est un package qui vous permet d'ajouter facilement un système de rappels à vos modèles Eloquent. Que ce soit pour envoyer des notifications d'échéance, des rappels de rendez-vous, ou toute autre alerte temporelle, ce package vous offre une architecture propre et extensible, intégrée nativement avec le système de notification de Laravel.
Concept fondamental
Le package repose sur un principe simple mais puissant : tout modèle qui doit recevoir des rappels est "rappelable" (remindable). Ces rappels sont automatiquement traités selon une fenêtre de tolérance que vous définissez.
Comment ça marche ?
- Planification : Vous créez des rappels pour vos modèles à des dates spécifiques
- Traitement : Un job planifié vérifie régulièrement les rappels à envoyer
- Fenêtre de tolérance : Chaque modèle définit sa propre fenêtre d'acceptation (ex: 30 minutes)
- Notification : Le modèle retourne une notification Laravel à envoyer
- Envoi automatique : Le système utilise
notify()pour envoyer la notification - Suivi : Le système garde une trace de chaque tentative (succès/échec)
Installation
Publication des ressources (optionnel)
Note : Les migrations sont automatiquement chargées par le package si vous ne les publiez pas.
Configuration
Le fichier de configuration config/reminder.php vous offre un contrôle total sur le comportement du package :
Utilisation de base
1. Rendre un modèle "rappelable"
Commencez par ajouter le trait Remindable à votre modèle :
2. Implémenter le contrat ShouldRemind
Pour qu'un modèle puisse recevoir des rappels, il doit implémenter l'interface ShouldRemind :
3. Créer une notification Laravel
Créez une notification standard Laravel qui sera envoyée lors du rappel :
4. Planifier des rappels
Une fois votre modèle configuré, vous pouvez planifier des rappels de plusieurs façons :
Planification multiple
Format 1 : Tableau indexé (mêmes canaux pour tous)
Format 2 : Tableau associatif (canaux différents par rappel)
Format 3 : Format mixte
Gestion des rappels existants
Récupération des rappels
Requêtes avancées avec le modèle Reminder
Mise à jour manuelle des rappels
Vérifications d'état
Annulation de rappels
Les channels de notification
Définir des canaux personnalisés
Utiliser channelsForSending()
Dans votre notification, utilisez cette méthode pour récupérer les canaux :
Exemples concrets de combinaisons de canaux
Commandes Artisan
Syntaxe et options
Exemple de sortie
Utilisation dans du code
Scheduler et File d'attente
Configuration dans le fichier .env
Configuration du scheduler
Mise en place de la crontab
Vérification du bon fonctionnement
Architecture détaillée
Le modèle Reminder
Les énumérations
ReminderStatus
ToleranceUnit
Le Value Object Tolerance
Le Cast ChannelsCast
Le trait Remindable
Le service ReminderService
Le job ProcessRemindersJob
La commande SendRemindersCommand
Le facade Reminder
Utilisation du facade :
Les événements
Les exceptions
Tests
Le package est fourni avec une suite de tests complète.
Exécuter les tests
Exemple de test pour les channels
Bonnes pratiques
1. Toujours inclure le trait Notifiable
2. Utiliser channelsForSending() dans vos notifications
3. Nommer les métadonnées de façon cohérente
4. Structurer les notifications selon le contexte
5. Valider les channels avant utilisation
6. Gérer les erreurs gracieusement
7. Nettoyer les anciens rappels
8. Utiliser la file d'attente en production
Cas d'usage avancés
Rappels récurrents
Rappels avec conditions
Combinaison avec les préférences utilisateur
Statistiques et reporting
Dépannage
Problème : Les rappels ne s'envoient pas
Problème : Les channels personnalisés ne sont pas utilisés
Problème : "toRemind() must return an instance of Notification"
Problème : Trop de tentatives échouées
Problème : "Call to undefined method channelsForSending()"
Problème : Les dates ne sont pas reconnues
Contribuer
Les contributions sont les bienvenues !
Comment contribuer
- Forkez le projet
- Créez une branche (
git checkout -b feature/amazing-feature) - Committez vos changements (
git commit -m 'Add amazing feature') - Pushez vers la branche (
git push origin feature/amazing-feature) - Ouvrez une Pull Request
Guide de style
- Suivez les conventions PSR-12
- Ajoutez des tests pour vos nouvelles fonctionnalités
- Mettez à jour la documentation si nécessaire
- Commentez votre code en français ou en anglais
Tests
Licence
Ce package est open-sourcé sous licence MIT. Voir le fichier LICENSE pour plus d'informations.
Créé avec ❤️ par Andy Kani
All versions of laravel-reminder with dependencies
illuminate/console Version ^10.0|^11.0|^12.0
illuminate/database Version ^10.0|^11.0|^12.0
illuminate/notifications Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0
php Version ^8.1