Laravel template project

Goal is to create project template with mariadb MYSQL, keycloak and document its creation from the scratch to working version with minimal welcome page with dark mode global CSS definition, settings and about in menu. Model view controller writing style.

Content would be customer (party) list with CRUD in table.

Laravel definitions

composer require laravel/boost --dev
php artisan boost:install

Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via taylor@laravel.com. All security vulnerabilities will be promptly addressed.

Setting up new deployment.

composer create-project laravel/laravel project-name
cd project-name

Create database and run migration after env configuration. Setup keycloak, you can use predefined configuration file.

create database laravel;

Create tables with ORM

php artisan migrate

User management with laravel UI lib

composer require laravel/ui
php artisan ui bootstrap --auth

Verzioniranje

git tag -a v1.0.1 -m "Verzija 1.0.1: Osnovna funkcionalnost"
git push origin v1.0.1
git describe --tags --abbrev=0 2>/dev/null

Deploy

First checkout repository and install laralvel libs. Copy env.templet to .env and replace environment specific configuration parameters data.

Run

Fedora linux install PHP packages.

dnf install php-gd
dnf install php-mysqli
dnf install php-cli
dnf install phpunit composer

composer require laravel/boost --dev
php artisan key:generate
composer require laravel/ui

php artisan serve

Licenca

Ta projekt je licenciran pod MIT Licenco.

Copy to new project

rsync -av ltp/app/ dod/app/
rsync -av ltp/database/ dod/database/
rsync -av ltp/config/ dod/config/
rsync -av ltp/routes/ dod/routes/
rsync -av ltp/composer.json  dod/composer.json
rsync -av ltp/bootstrap/app.php dod/bootstrap/app.php
rsync -av ltp/.env.example dod/.env.example 
rsync -av ltp/public/ dod/public/
rsync -av ltp/resources/ dod/resources/
rsync -av ltp/bootstrap/ wse/bootstrap/

mkdir -p storage/framework/cache
mkdir -p storage/framework/views

# copy gitignore, LICENSE in .env.esample 
# copy artisan executable

Docker

docker-compose up -d --build

# 2. Počisti Laravel cache (opcijsko)
docker-compose exec app php artisan config:clear
docker-compose exec app php artisan cache:clear

# 3. Zaženi migracije
docker-compose exec app php artisan migrate --force

# 4. (Opcijsko) Generiraj nov APP_KEY, če je potrebno
docker-compose exec app php artisan key:generate