Aller au contenu
Quiet Social

Installation et configuration

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.