laravel blog

Блог Laravel 11.x

Цель этого репозитория — показать хорошие практики разработки на Laravel, а также представить случаи использования таких функций фреймворка, как:

• Аутентификация
• API
  • Святилище
  • API-ресурсы
  • Управление версиями
• Лезвие
• Вещание
• Кэш
• Проверка электронной почты
• Файловая система
• Помощники
• Горизонт
• Локализация
• Почта
• Миграции
• Политика
• Провайдеры
• Запросы
• Посев и фабрики
• Тестирование
• Усадьба

Помимо Laravel, этот проект использует другие инструменты, такие как:

• Бутстрап 5.x
• Пинта
• Шрифт Awesome
• Горячее подключение
• Редис
• Spatie/laravel-медиабиблиотека
• hotwired-laravel/турбо-laravel
• Еще многое предстоит открыть.

Несколько скриншотов

Вы можете найти несколько скриншотов приложения: https://imgur.com/a/Jbnwj.

Установка

Чтобы создать среду разработки, следуйте этим инструкциям.

Настройка среды разработки на локальном компьютере:

$ 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

Теперь откройте http://laravel-blog.test.

Почтовая программа

Вы можете использовать Mailpit для тестирования своих писем в разработке.

После установки откройте http://localhost:8025.

Прежде чем начать

Вам нужно запустить миграцию с семенами:

$ php artisan migrate:fresh --seed

Это создаст нового пользователя, которого вы сможете использовать для входа:

 email : [email protected]
password : demodemo

И затем скомпилируйте ресурсы:

$ yarn dev

Стартовая работа для информационного бюллетеня:

$ php artisan tinker
> PrepareNewsletterSubscriptionEmail::dispatch ();

Полезные команды

Запустите Laravel Horizon:

$ php artisan horizon

Заполнение базы данных:

$ php artisan db:seed

Запуск тестов:

$ php artisan test

Запуск Laravel Pint:

$ ./vendor/bin/pint --verbose --test

Создание резервной копии:

$ php artisan vendor:publish --provider= " SpatieBackupBackupServiceProvider "
$ php artisan backup:run

Генерация поддельных данных:

$ php artisan db:seed --class=DevDatabaseSeeder

Откройте для себя пакет

$ php artisan package:discover

В среде разработки перестройте базу данных:

$ php artisan migrate:fresh --seed

Доступ к API

Клиенты могут получить доступ к REST API. Запросы API требуют аутентификации через токен носителя.

Создайте новый токен:

curl --location --request POST ' laravel-blog.test/api/v1/authenticate?email=your_email&password=your_password ' 
     --header ' X-Requested-With: XMLHttpRequest '

И теперь вы можете использовать ключ meta.access_token в качестве токена на Bearer :

curl --location ' laravel-blog.test/api/v1/posts ' 
      --header ' X-Requested-With: XMLHttpRequest ' 
      --header ' Authorization: Bearer access_token '

API имеют префикс api и номер версии API, например v1 .

Не забудьте установить для заголовка X-Requested-With значение XMLHttpRequest . В противном случае Laravel не распознает вызов как запрос AJAX.

Чтобы перечислить все доступные маршруты для API:

$ php artisan route:list --path=api

Содействие

Не стесняйтесь внести свой вклад в проект, адаптируя или добавляя функции! Сообщения об ошибках или запросы на включение приветствуются.

Лицензия

Этот проект выпущен под лицензией MIT.