Portadas
En esta página
La portada de un post es su imagen: una Image del SDK, una URL, una ruta absoluta bajo una carpeta autorizada, o una ruta en un disco. El paquete la lee en el momento del envío, con salvaguardas contra lo que un modelo no debería hacer publicar.
Las cuatro formas
| Portada | Cómo se lee |
|---|---|
Una Image del SDK |
Tal cual, con su propio texto alternativo. |
Una URL http(s):// |
Descargada por el SDK al enviar el post. Las direcciones privadas y locales se rechazan, salvo si allow_private_network_images vale true. |
| Una ruta absoluta | Solo se lee bajo una de las cover_roots, y solo si es una imagen. |
| Cualquier otra cadena | Una ruta en el disco coverDisk, si no cover_disk, si no tu disco por defecto. |
#[SocialPost(content: 'excerpt', cover: 'cover_path', coverAlt: 'cover_alt', coverDisk: 'public')]
class Article extends Model
{
use PublishesToSocial;
}
Las salvaguardas
- Carpetas autorizadas. Una ruta absoluta solo se lee bajo
storage_path('app/public')opublic_path()(la clavecover_roots, que se amplía publicando la configuración), y solo si el archivo es una imagen: una ruta guardada en un modelo no puede hacer que se envíe/etc/hostso tu.env.storage/app/privateno es una raíz por defecto: publicar desde esa carpeta debe ser una decisión. - Tamaño. Una portada más pesada que
cover_max_bytes(20 MiB) se rechaza antes de leerla. - Red privada. Una URL hacia una dirección privada, local o reservada se rechaza, para que una dirección introducida por un usuario no alcance tu propia red.
QUIET_SOCIAL_ALLOW_PRIVATE_NETWORK_IMAGES=truelevanta ese rechazo en un equipo de desarrollo que sirve sus imágenes enhttp://localhost, nunca en producción. El detalle de la descarga está en la documentación del SDK PHP.
Cuando falla una portada
- Un archivo o una ruta inexistente, fuera de las carpetas autorizadas, demasiado pesado o que no es una imagen hace que el post sea inválido: vínculo
rejectedySocialPostRejected. - Un disco que no responde es un fallo pasajero, que se reintenta.
- Una URL rechazada, o que su servidor no entrega, hace fallar el post:
SocialPostFailed, y un vínculofailedque se reenvía en la siguiente modificación. Un error de servidor o un límite de frecuencia de su host se reintenta.
Texto alternativo y redes
coverAlt es el texto alternativo. Cada red puede tener su portada (#[Pinterest(cover: …)], pinterestCover()) y su texto alternativo; un texto alternativo de red sin portada de red describe la imagen común en esa red. Un post lleva una imagen, y una por red como máximo.
La huella de una portada
La huella de un archivo de portada se calcula sobre su ruta, su tamaño y su fecha de modificación, sin leerlo: comprobar que un post no ha cambiado no cuesta una lectura de archivo. Sustituir el archivo cambia su tamaño o su fecha, y por tanto el post.