- Documentación
- Paquete Laravel · Versión 0.1
- Instalación y configuración
Instalación y configuración
En esta página
El paquete se instala con Composer junto con el SDK PHP, crea su tabla mediante una migración, y se configura con variables de entorno QUIET_SOCIAL_*: una clave API, una marca, y algunos ajustes de sincronización.
Requisitos
- PHP 8.2 o posterior, y Laravel 12 o 13 (Laravel 13 exige por sí mismo PHP 8.3). Laravel 11 ya no es compatible: ninguna de sus versiones está libre de vulnerabilidades conocidas.
- El SDK PHP
quiet-social/php-social, instalado con el paquete. - Una caché que admita bloqueos y que compartan todos los procesos que guardan modelos o ejecutan la cola: Redis, Memcached o la caché en base de datos. Consulta Sincronización automática.
- Una cola, recomendada en producción.
- Un espacio de trabajo de Quiet Social y una clave API.
Instalar
composer require quiet-social/laravel-social
php artisan migrate
El proveedor de servicios se descubre automáticamente. Sus migraciones crean la tabla social_publication_links, donde el paquete guarda lo que ha enviado para cada modelo. Para cambiar los valores por defecto, publica la configuración:
php artisan vendor:publish --tag=social-config
¿El modelo ya tiene filas? Lee Adoptar el paquete en una base existente antes de desplegar.
Crear una clave
Las claves se crean en el panel, página Clés API (claves API), por el propietario o un administrador del espacio de trabajo. El recorrido se describe en la guía. El secreto se muestra una sola vez:
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 es necesario cuando la clave cubre todo un espacio de trabajo: entonces hay que decir a la API para qué marca publicar. Una clave vinculada a una marca no lo necesita.
Los permisos que necesita la clave
| Lo que hace el paquete | Permisos |
|---|---|
| Enviar un post | publications:create, y media:create cuando el post lleva una portada |
| Resolver los nombres de red, encontrar las redes que declara un modelo | destinations:read |
| Leer el estado de un post antes de sustituirlo, recuperar un intento | publications:read |
| Cancelar un post que no ha salido | publications:cancel |
El constructor manual pide los mismos permisos, más media:read para una imagen dada por su identificador med_…. El paquete no usa brands:read. Cada permiso se describe en los permisos de la API.
Cada clave de configuración
Cada variable se lee como env('X') ?: valor_por_defecto: una variable presente pero vacía en .env vuelve a su valor por defecto.
| Clave | Variable | Por defecto | Función |
|---|---|---|---|
url |
QUIET_SOCIAL_URL |
https://quietsocial.dev/api/v1 |
La dirección de la API, versión incluida. |
panel_url |
QUIET_SOCIAL_PANEL_URL |
https://quietsocial.dev |
El panel, donde se reconecta una cuenta social. |
client_id |
QUIET_SOCIAL_CLIENT_ID |
ninguno | El identificador qsc_… de la clave. |
client_secret |
QUIET_SOCIAL_CLIENT_SECRET |
ninguno | Su secreto qss_…. Unas credenciales ausentes se revelan con AuthenticationFailed en la primera llamada. |
brand_id |
QUIET_SOCIAL_BRAND_ID |
null |
La marca brd_… por defecto. |
sync |
QUIET_SOCIAL_SYNC_ENABLED |
true |
La sincronización automática. false la detiene en todas partes, incluidos los jobs ya en cola; publishToSocial() sigue funcionando. |
queue.connection |
QUIET_SOCIAL_QUEUE_CONNECTION |
null (tu conexión por defecto) |
La conexión de cola de los jobs de sincronización. |
queue.name |
QUIET_SOCIAL_QUEUE |
null (la cola por defecto) |
Su cola. |
lock_wait |
QUIET_SOCIAL_LOCK_WAIT |
10 |
Segundos durante los que una sincronización espera el bloqueo de su modelo antes de volver a ponerse en cola. |
ignore_older_than |
QUIET_SOCIAL_IGNORE_OLDER_THAN |
1440 |
Minutos. Un modelo cuya fecha de publicación sea más antigua no se envía automáticamente. 0 elimina el límite. |
destinations_ttl |
QUIET_SOCIAL_DESTINATIONS_TTL |
300 |
Segundos durante los que los destinos capaces de publicar se guardan en caché, para los modelos que no nombran sus redes. 0 los vuelve a leer cada vez. |
cover_disk |
QUIET_SOCIAL_COVER_DISK |
null (tu disco por defecto) |
El disco donde se lee una ruta de portada relativa. |
cover_roots |
ninguna | [storage_path('app/public'), public_path()] |
Las únicas carpetas donde se lee una ruta de portada absoluta. Una entrada relativa se lee desde base_path(). |
cover_max_bytes |
QUIET_SOCIAL_COVER_MAX_BYTES |
20971520 (20 MiB) |
La portada más grande que se lee. 0 o menos se ignora. |
allow_private_network_images |
QUIET_SOCIAL_ALLOW_PRIVATE_NETWORK_IMAGES |
false |
Autoriza una URL de portada hacia una dirección privada o local. Solo para un equipo de desarrollo. |
webhook_secret |
QUIET_SOCIAL_WEBHOOK_SECRET |
null |
El secreto de firma whsec_…. Sin él, la ruta de webhook no existe. |
webhook_path |
QUIET_SOCIAL_WEBHOOK_PATH |
social/webhook |
La ruta del webhook. |
webhook_tolerance |
QUIET_SOCIAL_WEBHOOK_TOLERANCE |
300 |
Segundos durante los que una firma sigue siendo válida. |
webhook_replay_window |
QUIET_SOCIAL_WEBHOOK_REPLAY_WINDOW |
43200 (12 h) |
Segundos durante los que se recuerda una entrega ya procesada. 0 desactiva el reconocimiento de reintentos. |
connect_timeout |
QUIET_SOCIAL_CONNECT_TIMEOUT |
5 |
Segundos para conectarse a la API. |
timeout |
QUIET_SOCIAL_TIMEOUT |
20 |
Segundos para una llamada completa. |