phpSmug

phpsmug

PHPSMUG est un wrapper d'objet simple pour la nouvelle API V2 Smugmug, écrite en PHP.

L'intention de cette classe est de permettre aux développeurs d'applications PHP rapidement et faciles avec l'API Smugmug, sans avoir à se soucier des détails les plus fins de l'API.

Pas déjà un utilisateur SmugMug? Ici, ayez une remise de 5 $ sur votre première année sur moi en s'inscrivant en utilisant ce code:

2zxfxmc19qoxu

Le développement de PhPSMUG a lieu pendant mon temps libre. Si vous trouvez PHPSMUG utile et que cela vous a fait gagner beaucoup de temps, envisagez de parrainer ce projet.

---

Remarque: En raison de changements significatifs dans l'API SmugMug, PHPSMUG 4.0.0 et plus tard n'est pas compatible en arrière avec les rejets API V1.xx SmugMug V1.xx.

Exigences

• Php> = 7.3.0,
• Bibliothèque Guzzle 6 et abonné Guzzle OAuth1,
• (Facultatif) PHPUNIT et PHP-CS-FIXer pour exécuter des tests.

Installation

La méthode recommandée d'installation de PHPSMUG utilise le compositeur. Si vous avez installé le compositeur, vous pouvez installer PHPSMUG et toutes ses dépendances à partir de votre répertoire de projet:

$ composer require lildude/phpsmug

Alternativement, vous pouvez ajouter ce qui suit à composer.json de votre projet:

{
    "require" : {
        "lildude/phpsmug" : " ^4.0 "
    }
}

.. puis exécutez composer update à partir de votre répertoire de projet.

Si vous n'avez pas installé le compositeur, vous pouvez le télécharger en utilisant:

$ curl -s http://getcomposer.org/installer | php

Utilisation de base du client PHPSMUG

phpSmug suit les conventions PSR-1, PSR-2 et PSR-4, ce qui signifie que vous pouvez facilement utiliser le compositeur automatique du compositeur pour intégrer phpSmug dans vos projets.

 <?php

// This file is generated by Composer
require_once ' vendor/autoload.php ' ;

// Optional, but definitely nice to have, options
$ options = [
    ' AppName '   => ' My Cool App/1.0 (http://app.com) ' ,
];
$ client = new phpSmug  Client ( " [YOUR_API_KEY] " , $ options ));
$ albums = $ client -> get ( ' user/[your_username]!albums ' );

À partir de l'objet $client , vous pouvez accéder à toutes les méthodes API SmugMug 2.0.

Documentation

Voir le répertoire docs ou https://lidude.github.io/phpsmug/ pour une documentation plus détaillée.

Exemples

PHPSMUG est livré avec 3 exemples pour vous aider à vous mettre sur votre chemin. Les 3 exemples effectuent la même chose, en utilisant simplement des méthodes d'authentification différentes. Ils montrent tous des miniatures du premier album trouvé pour les méthodes d'authentification respectives:

• example.php illustre un accès anonyme et non authentifié.
• example-oauth.php illustre une connexion OAuth.
• example-external-links.php illustre l'affichage des images privées.

Obtenir de l'aide

La meilleure façon d'obtenir de l'aide à la mise en œuvre de PHPSMUG dans vos projets est d'ouvrir un problème. Cela vous permet de rechercher facilement d'autres problèmes où d'autres peuvent avoir posé les mêmes questions ou frapper les mêmes problèmes et s'ils ne l'ont pas fait, votre problème ajoutera aux ressources disponibles aux autres à une date ultérieure.

S'il vous plaît ne soyez pas timide. Si vous avez une question, un problème ou si vous êtes curieux de quelque chose, il y a de très bonnes chances que quelqu'un d'autre soit aussi, alors allez-y et ouvrez un problème et demandez.

Contributif

Vous avez trouvé un bug ou vous voulez rendre Phpsmug encore meilleur? N'hésitez pas à ouvrir une demande de traction avec vos modifications, mais assurez-vous de consulter la contribution.md d'abord pour certains conseils et directives. Aucune demande de traction n'est trop petite.

Changements

Toutes les modifications notables de ce projet sont documentées dans ChangeLog.md.

Licence

PHPSMUG est concédé sous licence MIT - Voir le fichier de licence pour plus de détails