Eacode Kernel

Eacode Kernel is a lightweight PHP micro kernel based on Slim 4. It provides a minimal HTTP bootstrap, simple controllers, and a tiny migration runner for MariaDB.

Requirements

• PHP 8.2+
• Docker + Docker Compose (recommended for local development)

Quick Start (Docker)

docker compose up -d --build

Open:

• http://localhost:8181/test → OK
• http://localhost:8181/test/db/1 → JSON row from test_items
• http://localhost:8181/api/ping → pong

Database

The web container connects to MariaDB using environment variables from docker-compose.yml:

• DB name: eak
• user: user
• password: qwerty

Migrations

Run migrations manually (inside container or locally with env vars):

php bin/migrate.php

Makefile Shortcuts

Common developer commands are available via make:

make up
make down
make restart
make migrate
make logs
make shell

Project Structure

• public/ front controller (index.php) and rewrite rules
• config/ routes, DI container, DB settings
• src/ controllers, API handlers, models, repositories
• db/migrations/ SQL migrations

Use as Template

You can use this repository as a project skeleton:

git clone https://github.com/eliasadvansys/eacode-kernel.git my-new-project
cd my-new-project
git remote remove origin
git remote add origin <new-repo-url>

Then update:

• composer.json name/description/homepage
• config/routes.php (remove test routes you do not need)
• db/migrations/ (remove test migration if not needed)
• docker-compose.yml database settings

License

MIT. Slim and its dependencies remain under their respective licenses.