Download the PHP package andydefer/push-notifier without Composer

On this page you can find all versions of the php package andydefer/push-notifier. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of andydefer/push-notifier

Informations about the package push-notifier

PushNotifier

PHP Version License

PushNotifier est un package PHP puissant et flexible (compatible avec tout framework ou application brute) pour l'envoi de notifications push via Firebase Cloud Messaging (FCM) v1. Construit avec une architecture robuste et orientée contrat (interfaces), il simplifie l'authentification et l'envoi de notifications, vous permettant d'intégrer des notifications fiables en quelques minutes.

📦 Installation

🚀 Démarrage Rapide

1. Obtenir les identifiants Firebase

  1. Allez dans la Console Firebase.
  2. Sélectionnez votre projet.
  3. Allez dans Paramètres du projet > Comptes de service.
  4. Cliquez sur Générer une nouvelle clé privée pour télécharger le fichier JSON du compte de service.
  5. Placez ce fichier dans un endroit sécurisé de votre projet (par exemple, storage/app/firebase-credentials.json).

2. Envoyer votre première notification

🔗 Architecture et Concepts Clés

Le package est construit autour de plusieurs concepts puissants pour garantir flexibilité, testabilité et fiabilité dans n'importe quel environnement PHP.

1. La Factory comme Point d'Entrée Unique

La classe NotificationFactory est le point d'entrée principal. Elle centralise la création de vos services et vous permet d'injecter vos propres implémentations des composants de bas niveau (client HTTP, fournisseur d'auth). C'est le cœur de l'injection de dépendances du package.

2. Contrats pour la Flexibilité (Interfaces)

Le package est défini par des contrats (interfaces). Cela vous permet de remplacer n'importe quel composant interne par votre propre logique sans modifier le cœur du package.

3. DTOs pour la Clarté et la Cohérence

Toutes les données manipulées par le package sont encapsulées dans des DTOs (Data Transfer Objects).

4. Exceptions Spécifiques

Le package lance des exceptions spécifiques pour chaque type d'erreur.

📧 Création de Messages

Le DTO FcmMessageData a une structure simple et flexible :

Types de Notifications Prédéfinis

Messages Personnalisés

Pour tous les autres types, utilisez la méthode make() :

🛠️ Utilisation Avancée

Envoyer à plusieurs appareils

Valider un token

Analyser les réponses d'erreur

⚙️ Configuration

Méthodes de Configuration

🧪 Tests

📚 API Complète

NotificationFactory

Méthode Description
__construct(?HttpClientInterface, ?AuthProviderInterface) Constructeur avec injection optionnelle.
makeFirebaseServiceFromJsonFile(string $path): FirebaseService Crée un service depuis un fichier JSON.
makeFirebaseServiceFromJsonString(string $json): FirebaseService Crée un service depuis une chaîne JSON.
makeFirebaseServiceFromArray(array $config): FirebaseService Crée un service depuis un tableau.
makeFirebaseServiceFromEnv(array $env): FirebaseService Crée un service depuis les variables d'env.
makeFirebaseService(FirebaseConfigData $config): FirebaseService Crée un service depuis un DTO.

FirebaseService

Méthode Description
send(string $token, FcmMessageData $message): FcmResponseData Envoie une notification.
sendMulticast(array $tokens, FcmMessageData $message): array Envoie à plusieurs appareils.
sendInfo(string $token, string $title, string $body): FcmResponseData Envoie une notification "INFO".
ping(string $token): FcmResponseData Envoie une notification silencieuse "PING".
validateToken(string $token): bool Vérifie si un token est valide.

FcmMessageData

Méthode Statique Description
make(string $type, array $data = []): self Crée un message personnalisé.
info(string $title, string $body): self Crée un message "INFO".
ping(): self Crée un message "PING" avec ['connected' => 'true'].

FcmResponseData

Méthode Description
fromFcmResponse(array $response, int $statusCode): self Crée depuis une réponse FCM.
fromError(string $code, string $message, ?int $statusCode): self Crée depuis une erreur.
isInvalidToken(): bool Vérifie si le token est invalide.
isQuotaExceeded(): bool Vérifie si le quota est dépassé.
isAuthError(): bool Vérifie s'il s'agit d'une erreur d'authentification.

🤝 Contribution

Les contributions sont les bienvenues !

  1. Forkez le projet
  2. Créez une branche (git checkout -b feature/ma-fonctionnalite)
  3. Commitez (git commit -m 'Ajoute une fonctionnalité')
  4. Poussez (git push origin feature/ma-fonctionnalite)
  5. Ouvrez une Pull Request

📄 Licence

MIT

PushNotifier - Des notifications push simples et fiables avec PHP et Firebase. 🚀

All versions of push-notifier with dependencies

PHP Build Version
Package Version
Requires guzzlehttp/guzzle Version ^7.10
nesbot/carbon Version ^3.0
php Version ^8.1
spatie/laravel-data Version ^4.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package andydefer/push-notifier contains the following files

Loading the files please wait ...