Как организовать репозиторий github моего проекта laravel, чтобы пользователи могли легко установить и запустить его?

Question

Пять месяцев назад я создал довольно обширную систему управления блогами Laravel. Сейчас я нахожусь в точке, где я ищу работу и хотел бы, чтобы потенциальные работодатели могли легко установить и запустить мой проект, чтобы проверить его. Я хочу включить в readme.md инструкции о том, как его запустить, но я только что понял, что сам не могу понять, как его запустить!

Вот хранилище: https://github.com/colesam/Laravel-Blog

Вот что я пробовал:

git clone git@github.com:colesam/Laravel-Blog.git
composer install
php artisan serve

Это скопировало репозиторий в мой каталог xampp / htdocs и запустило его. В настоящее время XAMPP работает с MySQL и Apache.

Консоль отвечает, сообщая, что она обслуживается на localhost: 8000. К сожалению, я получаю сообщение об ошибке в HTML-документе:

Что не так с моим проектом и как я могу сделать это как можно проще для моих потенциальных работодателей / тех, кто хотел бы загрузить и проверить мой проект?

Answer 1

Это действительно легко на самом деле. Занимает около 5 минут. Вот шаги:

1. Клонирование проекта
2. Создать базу данных
3. Скопируйте .env.example в .env и установите правильные учетные данные базы данных
4. Запустите php artisan key:generate, чтобы сгенерировать ключ приложения
5. Запустите php artisan migrate, чтобы создать таблицы
6. Выполнить php artisan serve

И все готово.