Este repositório contém código para desenvolvedores que precisam iniciar uma aplicação utilizando os conceitos RESTFul com Slim Framework, porém, não querem passar pala fase de estruturação e configuração de ferramentas como Eloquent ORM, OAuth e Slim-Monolog. Slim-OAuth2-Eloquent já contém todas estas ferramentas configuradas e prontas para uso.
PHP >= 5.4.0
- Download
composer.phar
$ curl -sS https://getcomposer.org/installer | php- Instalar dependências
$ composer install- Criar banco de testes SQLite
$ php share/init/init.phpO banco de dados que foi criando, dentro do subdiretório share/init, contém um usuário de teste. Este será usando para ilustrar o uso da API.
username: usertest
password: test
A pasta Core e o arquivo routes.php é onde deve estar todo o fluxo do projeto. Nestes locais ficarão os código que não devem ser atualizados por novas versões do projeto Slim-OAuth2-Eloquent.
Para não haver problemas é muito importante que o desenvolvedor inclua estes no .gitignore de seu projeto.
Para obter um token de acesso ou atualizar o token existente, a solicitão deve ser feita utilizando o método POST e Content-Type: application/x-www-form-urlencoded. Os dados nescessários são:
grant_type: password
client_id: testclient
client_secret: secret
username: usertest
password: test
grant_type: password
client_id: testclient
client_secret: secret
username: usertest
password: test
O acesso aos dados da API acontece dentro dos padrões RESTful (GET, POST, PUT, DELETE). Ao utilizar qualquer um destes métodos é obrigatório o envio do 'token' obtido na solictação. O mesmo precisa ser enviado no 'header' da requisição 'http' através do parametro 'Authorization' e este deve ser da seguinte foma:
Authorization: Bearer d7TSwi1dXK3F1sN78tTEPDGOmD9c2oWmRFu6hrj6
OBS.: O hash utilizado como token é meramente ilustrativo, devendo ser substituído pelo obtido na solicitação/atualização de token
Bugs, features, sugestões ou dúvidas utilizar GitHub
Leonir Alves - https://twitter.com/leonir_ad