README

The framework engine powering LitePHP applications. This package contains all the internals — routing, HTTP, database, auth, validation, events, queue, and more. It is not meant to be used directly; start from the app template instead.

PHP 8.1+ · Zero runtime dependencies · 225 passing tests

What's inside

Bootstrap/
├── app.php         Application bootstrap (container, router, session, kernel)
└── container.php   Service bindings for the IoC container

Core/
├── Auth/           JwtGuard, TokenGuard, Auth, Gate, PasswordReset
├── Cache/          File-based cache driver
├── Config/         Env loader, Config registry
├── Console/        CLI kernel + command base
├── Database/       QueryBuilder, Model, Factory, Migration, Seeder, SoftDeletes, Schema
├── Events/         EventDispatcher
├── Exceptions/     Global error/exception handler
├── Facades/        Route facade
├── Http/           Request, Response, JsonResponse, Kernel, Paginator, UploadedFile, FormRequest, Client
├── Mail/           Mailer, Mailable
├── Middleware/     CSRF, CORS, SecurityHeaders, Throttle, Pipeline, MiddlewareManager
├── Queue/          Job, Queue, QueueWorker
├── Routing/        Router, Route, RouteCache
├── Support/        Arr, Collection, Str, Hash, Storage, Facade, ServiceProvider
├── Validation/     Validator, Rule, Rules (Boolean, Confirmed, Date, Email, In, Integer,
│                   Max, Min, Nullable, Numeric, Regex, Required, Sometimes, Unique, Url)
├── View/           Compiler (Blade-inspired template engine)
├── Container.php   PSR-11 IoC container with auto-resolution
├── Database.php    PDO wrapper
├── Session.php     Session manager
└── helpers.php     Global helper functions

Installation

This package is installed automatically when you create a new app via Composer:

composer create-project litephp/app my-app

To add it to an existing project manually:

composer require litephp/core

Requirements: PHP 8.1+, PDO extension, Fileinfo extension

For app developers

If you want to build an application with LitePHP, use the app template — not this package directly:

👉 github.com/your-username/litephp-app

The app template includes the project structure, bootstrap sequence, example controller, routes, views, middleware, and the php lite CLI — everything you need to start building.

For contributors

See CONTRIBUTING.md for how to set up the development environment, coding standards, and the PR process.

Security

See SECURITY.md for the full list of built-in security protections and how to report vulnerabilities responsibly.

Running tests

composer install
vendor/bin/phpunit --testdox

Expected: 225 tests, 0 failures.

License

MIT — see LICENSE for details.