Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/guillaumebriday/laravel-blog
Laravel 11.0 blog application with Hotwire, Horizon, Telescope, Sanctum, Breeze and Pusher
https://github.com/guillaumebriday/laravel-blog
api best-practices blog hotwire hotwire-turbo laravel laravel-11 laravel-breeze laravel-horizon laravel-sanctum laravel-telescope php
Last synced: 3 days ago
JSON representation
Laravel 11.0 blog application with Hotwire, Horizon, Telescope, Sanctum, Breeze and Pusher
- Host: GitHub
- URL: https://github.com/guillaumebriday/laravel-blog
- Owner: guillaumebriday
- License: mit
- Created: 2017-02-08T18:34:24.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-20T10:51:08.000Z (3 months ago)
- Last Synced: 2025-01-02T09:05:34.626Z (10 days ago)
- Topics: api, best-practices, blog, hotwire, hotwire-turbo, laravel, laravel-11, laravel-breeze, laravel-horizon, laravel-sanctum, laravel-telescope, php
- Language: PHP
- Homepage: https://laravel-blog.guillaumebriday.fr
- Size: 3.52 MB
- Stars: 1,762
- Watchers: 90
- Forks: 582
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- favorite-link - Laravel 5.7 blog application with Vue.js，Docker，Redis，Horizon and Pusher。
- awesome - guillaumebriday/laravel-blog - Laravel 11.0 blog application with Hotwire, Horizon, Telescope, Sanctum, Breeze and Pusher (PHP)
README
# Laravel 11.x blog
The purpose of this repository is to show good development practices on [Laravel](http://laravel.com/) as well as to present cases of use of the framework's features like:
- [Authentication](https://laravel.com/docs/11.x/authentication)
- API
- [Sanctum](https://laravel.com/docs/11.x/sanctum)
- [API Resources](https://laravel.com/docs/11.x/eloquent-resources)
- Versioning
- [Blade](https://laravel.com/docs/11.x/blade)
- [Broadcasting](https://laravel.com/docs/11.x/broadcasting)
- [Cache](https://laravel.com/docs/11.x/cache)
- [Email Verification](https://laravel.com/docs/11.x/verification)
- [Filesystem](https://laravel.com/docs/11.x/filesystem)
- [Helpers](https://laravel.com/docs/11.x/helpers)
- [Horizon](https://laravel.com/docs/11.x/horizon)
- [Localization](https://laravel.com/docs/11.x/localization)
- [Mail](https://laravel.com/docs/11.x/mail)
- [Migrations](https://laravel.com/docs/11.x/migrations)
- [Policies](https://laravel.com/docs/11.x/authorization)
- [Providers](https://laravel.com/docs/11.x/providers)
- [Requests](https://laravel.com/docs/11.x/validation#form-request-validation)
- [Seeding & Factories](https://laravel.com/docs/11.x/seeding)
- [Testing](https://laravel.com/docs/11.x/testing)
- [Homestead](https://laravel.com/docs/11.x/homestead)
Beside Laravel, this project uses other tools like:
- [Bootstrap 5.x](https://getbootstrap.com/)
- [Pint](https://github.com/laravel/pint)
- [Font Awesome](https://fontawesome.com/)
- [Hotwired](https://hotwired.dev/)
- [Redis](https://redis.io/)
- [spatie/laravel-medialibrary](https://github.com/spatie/laravel-medialibrary)
- [hotwired-laravel/turbo-laravel](https://github.com/hotwired-laravel/turbo-laravel)
- Many more to discover.
## Some screenshots
You can find some screenshots of the application on : [https://imgur.com/a/Jbnwj](https://imgur.com/a/Jbnwj)
## Installation
To create your development environment [follow these instructions](https://laravel.com/docs/11.x/installation#local-installation-using-herd).
Setting up your development environment on your local machine:
```bash
$ 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
```
Now open [http://laravel-blog.test](http://laravel-blog.test).
### Mailer
You can use [Mailpit](https://github.com/axllent/mailpit) to test your emails in development.
Once installed, open [http://localhost:8025](http://localhost:8025).
## Before starting
You need to run the migrations with the seeds :
```bash
$ php artisan migrate:fresh --seed
```
This will create a new user that you can use to sign in :
```yml
email: [email protected]
password: demodemo
```
And then, compile the assets :
```bash
$ yarn dev
```
Starting job for newsletter :
```bash
$ php artisan tinker
> PrepareNewsletterSubscriptionEmail::dispatch();
```
## Useful commands
Start Laravel Horizon:
```bash
$ php artisan horizon
```
Seeding the database :
```bash
$ php artisan db:seed
```
Running tests :
```bash
$ php artisan test
```
Running Laravel Pint :
```bash
$ ./vendor/bin/pint --verbose --test
```
Generating backup :
```bash
$ php artisan vendor:publish --provider="Spatie\Backup\BackupServiceProvider"
$ php artisan backup:run
```
Generating fake data :
```bash
$ php artisan db:seed --class=DevDatabaseSeeder
```
Discover package
```bash
$ php artisan package:discover
```
In development environment, rebuild the database :
```bash
$ php artisan migrate:fresh --seed
```
## Accessing the API
Clients can access to the REST API. API requests require authentication via Bearer token.
Generate a new token:
```bash
curl --location --request POST 'laravel-blog.test/api/v1/authenticate?email=your_email&password=your_password' \
--header 'X-Requested-With: XMLHttpRequest'
```
And now you can use the `meta.access_token` key as your `Bearer` token:
```bash
curl --location 'laravel-blog.test/api/v1/posts' \
--header 'X-Requested-With: XMLHttpRequest' \
--header 'Authorization: Bearer access_token'
```
API are prefixed by `api` and the API version number like so `v1`.
Do not forget to set the `X-Requested-With` header to `XMLHttpRequest`. Otherwise, Laravel won't recognize the call as an AJAX request.
To list all the available routes for API :
```bash
$ php artisan route:list --path=api
```
## Contributing
Do not hesitate to contribute to the project by adapting or adding features ! Bug reports or pull requests are welcome.
## License
This project is released under the [MIT](http://opensource.org/licenses/MIT) license.