- Documentación
- Paquete Laravel · Versión 0.1
- Adoptar el paquete en una base existente
Adoptar el paquete en una base existente
En esta página
Lee esto antes de añadir PublishesToSocial a un modelo que ya tiene filas: sin el comando social:baseline, el primer guardado de cada modelo existente publica su post, y un artículo antiguo en el que se corrige una errata saldría ese mismo día en tus redes.
Lo que hace el comando
social:baseline registra el post que describe hoy cada modelo existente, sin enviar nada: ninguna llamada llega a la API. Después, un modelo solo se publica cuando su post cambia, o cuando publishToSocial() lo pide.
php artisan social:baseline "App\Models\Article" "App\Models\Event" --chunk=500
Admite una o varias clases, o alias de morph. Lee los modelos sin ámbitos globales, por lotes de --chunk (200 por defecto), y para cada uno:
- un modelo cuya condición es verdadera (
when,skip,shouldPublishSocially()) y que todavía no tiene ningún post de la sincronización recibe un vínculobaseline: la huella de su post, nunca enviado; - un modelo cuya condición es falsa se deja de lado: se publicará el día en que su condición pase a ser verdadera, como debe ocurrir con un post nuevo;
- un modelo cuya fecha de publicación todavía está por llegar se deja de lado, contado como «scheduled in the future»: debe salir en su fecha, y su siguiente guardado (o
publishToSocial()) lo envía; - un modelo en la papelera (eliminación suave) se deja de lado;
- un modelo cuya sincronización se está ejecutando en ese momento se deja de lado, contado como «being synchronised»: el comando toma el mismo bloqueo que la sincronización, y lo espera
lock_waitsegundos; - un modelo que ya tiene un post de la sincronización se deja de lado: el comando puede ejecutarse dos veces;
- un modelo que describe un post inválido se deja de lado, con una advertencia.
Muestra una línea por clase, y falla para una clase que no sea un modelo Eloquent que use PublishesToSocial:
App\Models\Article: 120 recorded, 3 scheduled in the future, 0 being synchronised, 7 left out.
El procedimiento recomendado
- Desactivar la sincronización durante el despliegue:
QUIET_SOCIAL_SYNC_ENABLED=false. - Desplegar el código que añade
PublishesToSocialy su descripción, y luego ejecutarphp artisan migrate. - Registrar los modelos existentes con
php artisan social:baseline, clase por clase o todas a la vez. - Volver a activar la sincronización (quitar la variable o ponerla en
true), refrescar una configuración en caché conphp artisan config:cache, y reiniciar los workers conphp artisan queue:restart.
El comando también puede ejecutarse con la sincronización activada: un modelo guardado mientras tanto se publica entonces, como corresponde, y el comando lo deja de lado.
Lo que protege sin el comando
El límite ignore_older_than (un día por defecto) impide enviar automáticamente un modelo cuya fecha de publicación es antigua. Es una segunda red de seguridad, no un sustituto: un modelo sin fecha de publicación nunca es demasiado antiguo, y un modelo con una fecha de hace menos de un día todavía sale.
Tras el comando, publishToSocial() envía de todos modos un post registrado como baseline: es la forma de volver a publicar a propósito un modelo antiguo.