PHPackages                             andydefer/laravel-fcm-notifications - 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. [Mail & Notifications](/categories/mail)
4. /
5. andydefer/laravel-fcm-notifications

ActiveLibrary[Mail & Notifications](/categories/mail)

andydefer/laravel-fcm-notifications
===================================

Laravel package for Firebase Cloud Messaging notifications integration

1.0.3(1mo ago)012MITPHPPHP ^8.1

Since Mar 15Pushed 1mo agoCompare

[ Source](https://github.com/andydefer/laravel-fcm-notifications)[ Packagist](https://packagist.org/packages/andydefer/laravel-fcm-notifications)[ RSS](/packages/andydefer-laravel-fcm-notifications/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (10)Used By (0)

Tu as parfaitement raison ! Version 1.x, pas de migration dans le README, et le changelog est l'endroit approprié pour les instructions de mise à jour. Voici le README corrigé :

Laravel FCM Notifications
=========================

[](#laravel-fcm-notifications)

[![PHP Version](https://camo.githubusercontent.com/187240af044d09d5b14a1d9d9ebdf3f7a993e4c7bc09bdb46b4ba661a891bf5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c7565)](https://php.net)[![Laravel Version](https://camo.githubusercontent.com/5e7ab9fe01c60d995bbdeea1fcb187e393a8b099cb776467d19802f6b5c21d81/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253246313125324631322d6f72616e6765)](https://laravel.com)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](LICENSE)

**Laravel FCM Notifications** est un package Laravel puissant et élégant qui intègre Firebase Cloud Messaging (FCM) au système de notifications natif de Laravel. Construit sur la base du package [andydefer/push-notifier](https://github.com/andydefer/push-notifier), il offre une solution complète pour envoyer des notifications push à vos utilisateurs sur Android, iOS et le web.

Ce package suit les principes SOLID et les bonnes pratiques de Laravel, avec une architecture orientée contrat (interfaces) qui le rend extrêmement flexible et testable.

---

✨ Fonctionnalités
-----------------

[](#-fonctionnalités)

- **Intégration native** avec le système de notifications de Laravel
- **Gestion automatique des tokens** : enregistrement, validation, invalidation
- **Support multi-appareils** : un utilisateur peut avoir plusieurs tokens
- **Token primaire dynamique** : le token le plus récemment utilisé est automatiquement considéré comme primaire
- **Nettoyage automatique** des tokens expirés ou inutilisés (basé sur `last_used_at`)
- **File d'attente** par défaut pour ne pas bloquer vos requêtes
- **Logging détaillé** pour faciliter le débogage
- **Tests exhaustifs** : plus de 50 tests unitaires et fonctionnels
- **Traductions** : support multilingue (français, anglais)
- **Commandes artisan** pour la maintenance et les tests

---

📦 Installation
--------------

[](#-installation)

### Étape 1 : Installer le package

[](#étape-1--installer-le-package)

```
composer require andydefer/laravel-fcm-notifications
```

### Étape 2 : Publier les fichiers nécessaires

[](#étape-2--publier-les-fichiers-nécessaires)

```
# Publier la migration
php artisan vendor:publish --provider="Andydefer\FcmNotifications\FcmNotificationServiceProvider" --tag="fcm-migrations"

# Publier la configuration (optionnel)
php artisan vendor:publish --provider="Andydefer\FcmNotifications\FcmNotificationServiceProvider" --tag="fcm-config"

# Publier les traductions (optionnel)
php artisan vendor:publish --provider="Andydefer\FcmNotifications\FcmNotificationServiceProvider" --tag="fcm-translations"
```

### Étape 3 : Exécuter les migrations

[](#étape-3--exécuter-les-migrations)

```
php artisan migrate
```

### Étape 4 : Configurer Firebase

[](#étape-4--configurer-firebase)

Placez votre fichier de credentials Firebase (fichier JSON du compte de service) dans un emplacement sécurisé, par exemple `storage/app/firebase-credentials.json`.

Ajoutez ensuite le chemin dans votre fichier `.env` :

```
FIREBASE_CREDENTIALS=/chemin/absolu/vers/firebase-credentials.json
```

---

⚙️ Configuration
----------------

[](#️-configuration)

Le fichier de configuration `config/fcm.php` vous permet de personnaliser le comportement du package :

```