phpSmug

phpsmug

O PHPSMUG é um invólucro simples orientado para o objeto para a nova API SMUGMUG V2, escrita em PHP.

A intenção desta classe é permitir que os desenvolvedores de aplicativos PHP interação rápida e fácil com a API SmogMug, sem ter que se preocupar com os detalhes mais finos da API.

Ainda não é um usuário presunçoso? Aqui, tenha um desconto de US $ 5 no seu primeiro ano em mim, registrando -se usando este código:

2zxfxmc19qoxu

O desenvolvimento do PHPSMug ocorre no meu tempo livre. Se você achar o PhpsMug útil e descobriu que economizou muito tempo, considere patrocinar este projeto.

---

NOTA: Devido a alterações significativas na API presunçosa, o PHPSMUG 4.0.0 e posterior não é compatível com as liberações de API v1.xx da API SmugMug.

Requisitos

• Php> = 7.3.0,
• Biblioteca do Guzzle 6 e o ​​assinante Guzzle OAuth1,
• (Opcional) Phpunit e Php-CS-Fixer para executar testes.

Instalação

O método recomendado para instalar o PHPSMUG está usando o compositor. Se você tiver o compositor instalado, pode instalar o PHPSMUG e todas as suas dependências no diretório do seu projeto:

$ composer require lildude/phpsmug

Como alternativa, você pode adicionar o seguinte ao composer.json do seu projeto:

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

.. e depois execute composer update no diretório do seu projeto.

Se você não tem o compositor instalado, pode baixá -lo usando:

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

Uso básico do cliente PHPSMUG

phpSmug segue as convenções PSR-1, PSR-2 e PSR-4, o que significa que você pode facilmente usar o AutoLoading do Composer para integrar phpSmug em seus projetos.

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

A partir do objeto $client , você pode acessar todos os métodos da API SMUGMUG 2.0.

Documentação

Consulte o diretório docs ou https://lildude.github.io/phpsmug/ para obter uma documentação mais detalhada.

Exemplos

O PHPSMUG vem com 3 exemplos para ajudá -lo a levá -lo. Todos os três exemplos executam a mesma coisa, apenas usando métodos de autenticação diferentes. Todos eles mostram miniaturas do primeiro álbum encontradas para os respectivos métodos de autenticação:

• example.php ilustra acesso anônimo e não autenticado.
• example-oauth.php ilustra um login OAuth.
• example-external-links.php ilustra a exibição de imagens privadas.

Obtendo ajuda

A melhor maneira de obter ajuda na implementação do PHPSMug em seus projetos é abrir um problema. Isso permite procurar facilmente outros problemas em que outros possam ter feito as mesmas perguntas ou atingir os mesmos problemas e, se não o fizeram, seu problema adicionará aos recursos disponíveis para outras pessoas posteriormente.

Por favor, não seja tímido. Se você tem uma pergunta, problema ou está apenas curioso sobre algo, há uma chance muito boa de que alguém também esteja, então vá em frente e abra um problema e pergunte.

Contribuindo

Encontrou um bug ou deseja tornar o PHPSMug ainda melhor? Sinta -se à vontade para abrir uma solicitação de tração com suas alterações, mas não deixe de conferir o contribuindo. MD primeiro para obter algumas dicas e diretrizes. Nenhuma solicitação de tração é muito pequena.

Mudanças

Todas as alterações notáveis ​​neste projeto estão documentadas em changelog.md.

Licença

O PHPSMUG está licenciado sob a licença do MIT - consulte o arquivo de licença para obter detalhes