iescarro/lekoi

Lekoi, PHP Framework inspired by Rails vibe coded with GPT.

v0.0.4 2025-10-09 07:42 UTC

Requires

• php: ^8.2
• doctrine/dbal: ^4.3
• symfony/console: ^7.1

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• Ian

README

🤷 What the Heck is Lekoi?

Lekoi is a lightweight, opinionated PHP framework that stumbled out of an LLM conversation and decided it was going to be the Ruby on Rails of the PHP world.

It embraces the convention over configuration mantra so tightly, it might send you a passive-aggressive email if you name a file wrong. It’s built on the solid back of PSR-4 autoloading and PHP Reflection, so while it makes jokes, its core is serious business (mostly).

🚀 Quick Start (Creating Your First App)

Follow these steps to create a new Lekoi application, generate a simple controller, and start the development server.

1. Installation

Use Composer's create-project command to initialize a new Lekoi application in a directory named blog.

composer create-project iescarro/lekoi blog
cd blog

2. Generate a Controller

Use the included CLI tool to generate a new controller named Hello. This follows the Rails convention of using plural/singular names, though we start simple.

php lekoi generate:controller Hello

3. Start the Server

Serve your new application using the built-in development server command:

php lekoi serve

5. View Your App

Open your browser and navigate to the following URL to see your new controller and view in action:

http://localhost:8000/hello/index 

✨ Features (The Stuff We Got Right)

• MVC Structure: It’s got Models, it’s got Views, and it’s got Controllers. Just like grandma used to make. But better looking.
• Zero-Config Routing: Routes are magically inferred from your URL. Want index.php/hello/index? Just create HelloController with an index() method. Lekoi handles the awkward introductions.
• Dependency Injection (via Reflection): Stop manually instantiating your Request and Response objects. Lekoi peeks into your controller methods, sees what you need, and slips it in there. It's like a highly functional, non-creepy code butler.
• Humiliation-Free Setup: We promise not to make you register 14 different service providers just to see "Hello World."

📄 License

Lekoi is open-sourced software licensed under the MIT license.