- Documentation
- Paquet Laravel · Version 0.1
- Installation et configuration
Installation et configuration
Sur cette page
Le paquet s'installe par Composer avec le SDK PHP, crée sa table par une migration, et se configure par des variables d'environnement QUIET_SOCIAL_* : une clé API, une marque, et quelques réglages de synchronisation.
Prérequis
- PHP 8.2 ou plus récent, et Laravel 12 ou 13 (Laravel 13 exige lui-même PHP 8.3). Laravel 11 n'est plus pris en charge : aucune de ses versions n'échappe aux failles de sécurité connues.
- Le SDK PHP
quiet-social/php-social, installé avec le paquet. - Un cache qui gère les verrous et que partagent tous les processus qui enregistrent des modèles ou font tourner la file : Redis, Memcached ou le cache en base de données. Voir Synchronisation automatique.
- Une file d'attente, recommandée en production.
- Un espace de travail Quiet Social et une clé API.
Installer
composer require quiet-social/laravel-social
php artisan migrate
Le fournisseur de services est découvert automatiquement. Ses migrations créent la table social_publication_links, où le paquet retient ce qu'il a envoyé pour chaque modèle. Pour changer les valeurs par défaut, publiez la configuration :
php artisan vendor:publish --tag=social-config
Le modèle a-t-il déjà des lignes ? Lisez Adopter le paquet sur une base existante avant de déployer.
Créer une clé
Les clés se créent dans le panel, page Clés API, par le propriétaire ou un administrateur de l'espace de travail. Le parcours est décrit dans le guide. Le secret n'est affiché qu'une fois :
QUIET_SOCIAL_CLIENT_ID=qsc_a1b2c3d4e5f6g7h8i9j0k1l2
QUIET_SOCIAL_CLIENT_SECRET=qss_...
QUIET_SOCIAL_BRAND_ID=brd_...
QUIET_SOCIAL_WEBHOOK_SECRET=whsec_...
QUIET_SOCIAL_BRAND_ID est nécessaire quand la clé couvre tout un espace de travail : il faut alors dire à l'API pour quelle marque publier. Une clé bornée à une marque n'en a pas besoin.
Les droits dont la clé a besoin
| Ce que fait le paquet | Droits |
|---|---|
| Envoyer un post | publications:create, et media:create quand le post a une couverture |
| Résoudre les noms de réseau, trouver les réseaux que déclare un modèle | destinations:read |
| Lire le statut d'un post avant de le remplacer, retrouver une tentative | publications:read |
| Annuler un post qui n'est pas parti | publications:cancel |
Le constructeur manuel demande les mêmes droits, plus media:read pour une image donnée par son identifiant med_…. Le paquet ne se sert pas de brands:read. Chaque droit est décrit dans les périmètres de l'API.
Chaque clé de configuration
Chaque variable est lue en env('X') ?: défaut : une variable présente mais vide dans .env retombe sur sa valeur par défaut.
| Clé | Variable | Défaut | Rôle |
|---|---|---|---|
url |
QUIET_SOCIAL_URL |
https://quietsocial.dev/api/v1 |
L'adresse de l'API, version comprise. |
panel_url |
QUIET_SOCIAL_PANEL_URL |
https://quietsocial.dev |
Le panel, où l'on reconnecte un compte social. |
client_id |
QUIET_SOCIAL_CLIENT_ID |
aucun | L'identifiant qsc_… de la clé. |
client_secret |
QUIET_SOCIAL_CLIENT_SECRET |
aucun | Son secret qss_…. Des identifiants absents se révèlent par AuthenticationFailed au premier appel. |
brand_id |
QUIET_SOCIAL_BRAND_ID |
null |
La marque brd_… par défaut. |
sync |
QUIET_SOCIAL_SYNC_ENABLED |
true |
La synchronisation automatique. false l'arrête partout, jobs déjà en file compris ; publishToSocial() fonctionne toujours. |
queue.connection |
QUIET_SOCIAL_QUEUE_CONNECTION |
null (votre connexion par défaut) |
La connexion de file des jobs de synchronisation. |
queue.name |
QUIET_SOCIAL_QUEUE |
null (la file par défaut) |
Leur file. |
lock_wait |
QUIET_SOCIAL_LOCK_WAIT |
10 |
Secondes pendant lesquelles une synchronisation attend le verrou de son modèle avant d'être remise en file. |
ignore_older_than |
QUIET_SOCIAL_IGNORE_OLDER_THAN |
1440 |
Minutes. Un modèle dont la date de publication est plus ancienne n'est pas envoyé automatiquement. 0 lève la limite. |
destinations_ttl |
QUIET_SOCIAL_DESTINATIONS_TTL |
300 |
Secondes pendant lesquelles les destinations capables de publier sont gardées en cache, pour les modèles qui ne nomment pas leurs réseaux. 0 les relit à chaque fois. |
cover_disk |
QUIET_SOCIAL_COVER_DISK |
null (votre disque par défaut) |
Le disque où lire un chemin de couverture relatif. |
cover_roots |
aucune | [storage_path('app/public'), public_path()] |
Les seuls dossiers où lire un chemin de couverture absolu. Une entrée relative se lit depuis base_path(). |
cover_max_bytes |
QUIET_SOCIAL_COVER_MAX_BYTES |
20971520 (20 Mio) |
La plus grosse couverture lue. 0 ou moins est ignoré. |
allow_private_network_images |
QUIET_SOCIAL_ALLOW_PRIVATE_NETWORK_IMAGES |
false |
Autorise une URL de couverture vers une adresse privée ou locale. Pour un poste de développement seulement. |
webhook_secret |
QUIET_SOCIAL_WEBHOOK_SECRET |
null |
Le secret de signature whsec_…. Sans lui, la route de webhook n'existe pas. |
webhook_path |
QUIET_SOCIAL_WEBHOOK_PATH |
social/webhook |
Le chemin de la route de webhook. |
webhook_tolerance |
QUIET_SOCIAL_WEBHOOK_TOLERANCE |
300 |
Secondes pendant lesquelles une signature reste valable. |
webhook_replay_window |
QUIET_SOCIAL_WEBHOOK_REPLAY_WINDOW |
43200 (12 h) |
Secondes pendant lesquelles une livraison déjà traitée est retenue. 0 coupe la reconnaissance des reprises. |
connect_timeout |
QUIET_SOCIAL_CONNECT_TIMEOUT |
5 |
Secondes pour se connecter à l'API. |
timeout |
QUIET_SOCIAL_TIMEOUT |
20 |
Secondes pour un appel entier. |