- Documentation
- Paquet Laravel · Version 0.1
- Couvertures
Couvertures
Sur cette page
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')oupublic_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/hostsou votre.env.storage/app/privaten'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=truelève ce refus sur un poste de développement qui sert ses images enhttp://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
rejectedetSocialPostRejected. - 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 lienfailedrenvoyé à 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.