Courier Management Portal [Laravel]

Prerequisites

• Git (Others) or GitBash (Windows)
• PHP > 7.1.3
• PHP Extensions [OPENSSL, PDO, MBSTRING, TOKENIZER, JSON, CURL, XML, FILEINFO]
• Composer
• NodeJS
• Visual Studio Code

Cloning

git clone https://github.com/webgeeks-in/courierman.git
cd courierman

Set Environment Variables

cp .env.example .env

# Update following variables in .env
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=courierman
DB_USERNAME=root
DB_PASSWORD=

Directory Permissions (Except Windows)

• bootstrap/cache/ Required permission: 0775
• storage/ Required permission: 0775
• storage/app/ Required permission: 0775
• storage/framework/ Required permission: 0775
• storage/logs/ Required permission: 0775

chmod -R 0777 storage/
chmod -R 0777 bootstrap/cache

Installing Composer & Node Dependencies

composer install
npm i

Run Migration & Seeder

php artisan migrate
php artisan db:seed

Specific migration and seeder

php artisan migrate:refresh --path=/database/migrations/file_name
php artisan db:seed --class=UsersTableSeeder

Generate APP Key & Link Storage

php artisan key:generate
php artisan storage:link

Compile Assets

npm run dev

Start the Engine

Tighten up the seatbelt and You're ready to ride...

php artisan serve

Docker Fans

This application can be also run on docker -- Development Friendly
-- Not for Production

PreRequisites

• Docker Desktop
• MySQL Workbench or Any Native MYSQL Tools except PHPMYADMIN

Play Commands

# Start containers in background
$ docker-compose up -d

# Stop containers
$ docker-compose kill

# Force rebuild of Dockerfiles
$ docker-compose up -d --build

# See list of running containers
$ docker ps

# Dive inside container (Example : cms_app)
$ docker exec -ti [CONTAINER ID] bash

# Remove dangling/untagged images
$ docker images -q --filter dangling=true | xargs docker rmi

# Remove stopped containers
$ docker ps -aq --no-trunc -f status=exited | xargs docker rm

Access App

http://127.0.0.1:8080/

Access DB

Server : 127.0.0.1
User : root
Password : mysql
Port : 33061

Screenshots

That's all Folks. Enjoy.