Aller au contenu
Quiet Social

Couvertures

La couverture d'un post est son image : une Image du SDK, une URL, un chemin absolu sous un dossier autorisé, ou un chemin sur un disque. Le paquet la lit au moment de l'envoi, avec des garde-fous contre ce qu'un modèle ne devrait pas faire publier.

Les quatre formes

Couverture Comment elle est lue
Une Image du SDK Telle quelle, avec son propre texte alternatif.
Une URL http(s):// Téléchargée par le SDK à l'envoi du post. Les adresses privées et locales sont refusées, sauf si allow_private_network_images vaut true.
Un chemin absolu Lu seulement sous l'un des cover_roots, et seulement si c'est une image.
Toute autre chaîne Un chemin sur le disque coverDisk, sinon cover_disk, sinon votre disque par défaut.
#[SocialPost(content: 'excerpt', cover: 'cover_path', coverAlt: 'cover_alt', coverDisk: 'public')]
class Article extends Model
{
    use PublishesToSocial;
}

Les garde-fous

  • Dossiers autorisés. Un chemin absolu n'est lu que sous storage_path('app/public') ou public_path() (la clé cover_roots, à élargir en publiant la configuration), et seulement si le fichier est une image : un chemin rangé dans un modèle ne peut pas faire envoyer /etc/hosts ou votre .env. storage/app/private n'est pas une racine par défaut : publier depuis ce dossier doit être un choix.
  • Taille. Une couverture plus lourde que cover_max_bytes (20 Mio) est refusée avant d'être lue.
  • Réseau privé. Une URL vers une adresse privée, locale ou réservée est refusée, pour qu'une adresse saisie par un utilisateur n'atteigne pas votre propre réseau. QUIET_SOCIAL_ALLOW_PRIVATE_NETWORK_IMAGES=true lève ce refus sur un poste de développement qui sert ses images en http://localhost, jamais en production. Le détail du téléchargement est dans la documentation du SDK PHP.

Quand une couverture fait défaut

  • Un fichier ou un chemin introuvable, hors des dossiers autorisés, trop lourd ou qui n'est pas une image rend le post invalide : lien rejected et SocialPostRejected.
  • Un disque qui ne répond pas est un échec passager, retenté.
  • Une URL refusée, ou que son serveur ne donne pas, fait échouer le post : SocialPostFailed, et un lien failed renvoyé à la prochaine modification. Une erreur serveur ou une limite de débit de son hôte est retentée.

Texte alternatif et réseaux

coverAlt est le texte alternatif. Chaque réseau peut avoir sa couverture (#[Pinterest(cover: …)], pinterestCover()) et son texte alternatif ; un texte alternatif de réseau sans couverture de réseau décrit l'image commune sur ce réseau. Un post porte une image, et une par réseau au plus.

L'empreinte d'une couverture

L'empreinte d'un fichier de couverture se calcule sur son chemin, sa taille et sa date de modification, sans le lire : vérifier qu'un post n'a pas changé ne coûte pas une lecture de fichier. Remplacer le fichier change sa taille ou sa date, donc le post.