O objetivo deste repositório é mostrar boas práticas de desenvolvimento em Laravel bem como apresentar casos de utilização de funcionalidades do framework como:
Além do Laravel, este projeto utiliza outras ferramentas como:
Você pode encontrar algumas capturas de tela do aplicativo em: https://imgur.com/a/Jbnwj
Para criar seu ambiente de desenvolvimento, siga estas instruções.
Configurando seu ambiente de desenvolvimento em sua máquina local:
$ git clone https://github.com/guillaumebriday/laravel-blog.git
$ cd laravel-blog
$ cp .env.example .env
$ php artisan key:generate
$ php artisan horizon:install
$ php artisan telescope:install
$ php artisan storage:link
Agora abra http://laravel-blog.test.
Você pode usar o Mailpit para testar seus e-mails em desenvolvimento.
Depois de instalado, abra http://localhost:8025.
Você precisa executar as migrações com as sementes:
$ php artisan migrate:fresh --seed
Isso criará um novo usuário que você pode usar para fazer login:
email : [email protected]
password : demodemo
E então, compile os ativos:
$ yarn dev
Iniciando trabalho para boletim informativo:
$ php artisan tinker
> PrepareNewsletterSubscriptionEmail::dispatch ();
Inicie o Laravel Horizon:
$ php artisan horizon
Semeando o banco de dados:
$ php artisan db:seed
Executando testes:
$ php artisan test
Executando o Laravel Pint:
$ ./vendor/bin/pint --verbose --test
Gerando backup:
$ php artisan vendor:publish --provider= " SpatieBackupBackupServiceProvider "
$ php artisan backup:run
Gerando dados falsos:
$ php artisan db:seed --class=DevDatabaseSeeder
Descubra o pacote
$ php artisan package:discover
No ambiente de desenvolvimento, reconstrua o banco de dados:
$ php artisan migrate:fresh --seed
Os clientes podem acessar a API REST. As solicitações de API requerem autenticação via token de portador.
Gere um novo token:
curl --location --request POST ' laravel-blog.test/api/v1/authenticate?email=your_email&password=your_password '
--header ' X-Requested-With: XMLHttpRequest '
E agora você pode usar a chave meta.access_token
como seu token Bearer
:
curl --location ' laravel-blog.test/api/v1/posts '
--header ' X-Requested-With: XMLHttpRequest '
--header ' Authorization: Bearer access_token '
As APIs são prefixadas por api
e o número da versão da API, como v1
.
Não se esqueça de definir o cabeçalho X-Requested-With
como XMLHttpRequest
. Caso contrário, o Laravel não reconhecerá a chamada como uma solicitação AJAX.
Para listar todas as rotas disponíveis para API:
$ php artisan route:list --path=api
Não hesite em contribuir com o projeto adaptando ou adicionando funcionalidades! Relatórios de bugs ou solicitações pull são bem-vindos.
Este projeto é lançado sob a licença do MIT.