phpSmug

PHPSMUG

PHPSMUG ist ein einfacher objektorientierter Wrapper für die neue SMUGMUG API V2, die in PHP geschrieben wurde.

Die Absicht dieser Klasse ist es, PHP -Anwendungsentwicklern eine schnelle und einfache Interaktion mit der SMUGMUG -API zu ermöglichen, ohne sich um die feineren Details der API kümmern zu müssen.

Nicht schon ein SMUGMUG -Benutzer? Hier haben Sie hier einen Rabatt von 5 USD von Ihrem ersten Jahr bei mir, indem Sie sich mit diesem Code registrieren:

2zxfxmc19qoxu

Die Entwicklung von PhpsMug findet in meiner Freizeit statt. Wenn Sie PhpsMug nützlich finden und festgestellt haben, dass Sie viel Zeit gespart haben, sollten Sie dieses Projekt gesponsert.

---

Hinweis: Aufgrund signifikanter Änderungen der SMUGMUG -API ist PHPSMUG 4.0.0 und später nicht rückwärts kompatibel mit den SMUGMUG -API v1.xx -Veröffentlichungen.

Anforderungen

• Php> = 7.3.0,
• Guzzle 6 Bibliothek und der Guzzle OAuth1 -Abonnent,
• (Optional) Phpunit und PHP-CS-Fixer zum Ausführen von Tests.

Installation

Die empfohlene Methode zur Installation von PHPSMUG verwendet Komponist. Wenn Sie Komponist installiert haben, können Sie PHPSMUG und alle seine Abhängigkeiten in Ihrem Projektverzeichnis installieren:

$ composer require lildude/phpsmug

Alternativ können Sie den composer.json Ihres Projekts Folgendes hinzufügen:

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

.. und führen Sie dann composer update in Ihrem Projektverzeichnis aus.

Wenn Sie keinen Komponisten installieren lassen, können Sie es mit:

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

Grundnutzung des Phpsmug -Clients

phpSmug folgt den Konventionen PSR-1, PSR-2 und PSR-4, was bedeutet, dass Sie das Autolading des Komponisten problemlos verwenden können, um phpSmug in Ihre Projekte zu integrieren.

 <?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 ' );

Aus dem $client -Objekt können Sie auf alle SMUGMUG 2.0 -API -Methoden zugreifen.

Dokumentation

Weitere detailliertere Dokumentation finden Sie im docs -Verzeichnis oder https://lildude.github.io/Phpsmug/.

Beispiele

PHPSMUG wird mit 3 Beispielen geliefert, um Sie auf den Weg zu bringen. Alle 3 Beispiele führen dasselbe durch und verwenden nur unterschiedliche Authentifizierungsmethoden. Sie alle zeigen Miniaturansichten des ersten Albums für die jeweiligen Authentifizierungsmethoden:

• example.php veranschaulicht anonyme, nicht authentifizierte Zugriff.
• example-oauth.php veranschaulicht eine OAuth-Anmeldung.
• example-external-links.php veranschaulicht das Anzeigen privater Bilder.

Hilfe bekommen

Der beste Weg, um Hilfe bei der Implementierung von PHPSMUG in Ihre Projekte zu erhalten, besteht darin, ein Problem zu eröffnen. Auf diese Weise können Sie problemlos nach anderen Problemen suchen, bei denen andere möglicherweise zu den gleichen Fragen gestellt oder dieselben Probleme gestellt haben. Wenn dies nicht der Fall ist, wird Ihr Problem zu den Ressourcen, die anderen zu einem späteren Zeitpunkt zur Verfügung stehen, hinzufügen.

Bitte sei nicht schüchtern. Wenn Sie eine Frage haben, ein Problem haben oder nur neugierig auf etwas sind, besteht auch eine sehr gute Chance, dass jemand anderes auch ein Problem eröffnet und fragen.

Beitragen

Einen Fehler gefunden oder PhpsMug noch besser machen? Bitte öffnen Sie eine Pull -Anfrage mit Ihren Änderungen. Schauen Sie sich jedoch unbedingt den Beitrag zum Mitnehmen an. Keine Pull -Anfrage ist zu klein.

Änderungen

Alle bemerkenswerten Änderungen an diesem Projekt sind in ChangeLog.md dokumentiert.

Lizenz

PHPSMUG ist unter der MIT -Lizenz lizenziert - Einzelheiten finden Sie in der Lizenzdatei