Installation

Requirements

Bhitti requires PHP 8.3+, Composer, PDO, Mbstring, and the PDO extension for your chosen SQL database.

Install optional extensions only when you use their drivers: PhpRedis, Memcached, or APCu.

Clone skeleton app

git clone https://github.com/sayedsahin/bhitti.git
cd bhitti
composer install

Create the environment file:

cp .env.example .env

Windows PowerShell:

Copy-Item .env.example .env

Configure the application

At minimum, set the application URL and database credentials:

APP_DEBUG=true
BASE_URL=http://127.0.0.1:8000
APP_TIMEZONE=UTC

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=bhitti
DB_USERNAME=root
DB_PASSWORD=

Run migrations:

php run migrate

Optionally seed the database:

php run db:seed

Local development server

php -S 127.0.0.1:8000 -t public

The built-in PHP server is for local development. In production, point the web server document root at public/ and run PHP through your chosen PHP-FPM deployment.

Production caches

Before production traffic, generate configuration and route caches:

php run config:cache
php run route:cache

Generated files are stored under storage/cache/.