PHPackages                             blueprintau/lucent - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. blueprintau/lucent

ActiveLibrary[Framework](/categories/framework)

blueprintau/lucent
==================

Lucent PHP web framework

v1.1.6(today)02↑2900%[3 PRs](https://github.com/mineubob/Lucent/pulls)MITPHPPHP >=8.4CI passing

Since Oct 16Pushed todayCompare

[ Source](https://github.com/mineubob/Lucent)[ Packagist](https://packagist.org/packages/blueprintau/lucent)[ RSS](/packages/blueprintau-lucent/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (8)Versions (34)Used By (0)

Lucent PHP Framework
====================

[](#lucent-php-framework)

[![PHP Tests](https://github.com/blueprintau/Lucent/actions/workflows/tests.yml/badge.svg?branch=development)](https://github.com/blueprintau/Lucent/actions/workflows/tests.yml)[![Code Coverage](https://camo.githubusercontent.com/8c88972bbcef86bec88cc1eeb3c0206ce0f43a7a93129c37d8a81fa245e082f5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d5265706f72742d627269676874677265656e)](https://blueprintau.github.io/Lucent/)[![Packagist](https://camo.githubusercontent.com/773711238396d11dc0dedcfe4ad2aabc848136a5e5b463056e1e30cab69aa76a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c75657072696e7461752f6c7563656e742e737667)](https://packagist.org/packages/blueprintau/lucent)

Lucent is a lightweight PHP framework designed for building APIs with minimal overhead. It offers an elegant, intuitive syntax that will feel familiar to developers with experience in Laravel or Spring Boot.

Lucent provides a streamlined approach to building PHP APIs with:

- Simple routing with REST
- [Database abstraction with support for MySQL and SQLite](./docs/database.md)
- [Model-based ORM with relationships](./docs/orm.md)
- [Route Model Binding](./docs/route-model-binding.md)
- [Rules & Validation](./docs/rules-and-validation.md)
- Middleware support
- [Comprehensive PSR-3 compliant logging](./docs/logging.md)
- [PSR-7/15/17 HTTP messages](./docs/http-psr7.md)
- [PSR-18 HTTP client](./docs/http-client.md)
- [Dependency Injection Container](./docs/container.md)
- [CLI tools for development and maintenance](./docs/commandline.md)
- [File System](./docs/filesystem/file.md)
- [UUID's](./docs/facades/uuid.md)
- [Exception & Error handling](./docs/error-handling.md)

Installing and Updating
-----------------------

[](#installing-and-updating)

### Installation

[](#installation)

Create a new Lucent project using Composer:

```
composer create-project blueprintau/lucent myapp
```

Then start the development server:

```
cd myapp
vendor/bin/lucent serve
```

By default the server runs on port `8080`. Pass `--port=9000` to use a different port:

```
vendor/bin/lucent serve --port=9000
```

Alternatively, add Lucent to an existing project:

```
composer require blueprintau/lucent
```

### Updating Lucent

[](#updating-lucent)

To update Lucent to the latest version:

```
composer update blueprintau/lucent
```

Deploying Your Project
----------------------

[](#deploying-your-project)

Lucent includes a built-in deployment system that allows you to deploy and rollback your project directly from the CLI. It works with any zip-based source — GitHub, Gitea, S3, or any URL that returns a zip file.

### Configuration

[](#configuration)

Add the following to your `.env` file:

```
DEPLOY_URL=https://api.github.com/repos/your-org/your-repo/zipball/master
DEPLOY_TOKEN=your_personal_access_token
```

For GitHub private repositories, generate a Access Token with `repo` scope at , then use the API URL format above with the following headers automatically applied by Lucent:

```
Authorization: Bearer {token}

Accept: application/vnd.github+json

X-GitHub-Api-Version: 2022-11-28

```

### Deploying the Latest Version

[](#deploying-the-latest-version)

```
vendor/bin/lucent deploy latest
```

This will:

1. Download the zip from `DEPLOY_URL`
2. Back up your current project to `storage/backups/{timestamp}.zip`
3. Extract the new version over your project

The following paths are never touched during a deploy:

- `.env` — your environment config
- `vendor/` — your Composer dependencies
- `storage/` — your logs, uploads, and temp files

### Rolling Back

[](#rolling-back)

```
vendor/bin/lucent deploy rollback
```

This will:

1. Clean the current project (preserving `.env`, `vendor/`, `storage/backups`, `storage/temp`, and `logs`)
2. Restore the most recent backup zip
3. Remove the used backup

Project Structure
-----------------

[](#project-structure)

After installation, your project will have the following structure:

```
myapp/
├── App/
│   ├── Commands/
│   ├── Controllers/
│   ├── Models/
│   └── Rules/
├── commands/              # CLI command files (auto-loaded)
├── routes/                # Route files (auto-loaded)
├── public/
│   └── index.php
├── storage/
├── logs/
├── vendor/
│   └── blueprintau/
│       └── lucent/        # The framework
├── .env
└── composer.json

```

### Configuration

[](#configuration-1)

Configure your database connection and other settings in the `.env` file:

```
DB_USERNAME=root
DB_PASSWORD=
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=lucent
DB_DRIVER=mysql
```

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

License
-------

[](#license)

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

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance100

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 62% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Recently: every ~0 days

Total

30

Last Release

0d ago

Major Versions

v0.260719.5 → v1.0.02026-07-29

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/19513812?v=4)[mineubob](/maintainers/mineubob)[@mineubob](https://github.com/mineubob)

---

Top Contributors

[![jackharris-personal](https://avatars.githubusercontent.com/u/79836947?v=4)](https://github.com/jackharris-personal "jackharris-personal (625 commits)")[![mineubob](https://avatars.githubusercontent.com/u/19513812?v=4)](https://github.com/mineubob "mineubob (233 commits)")[![jackharrispeninsulainteractive](https://avatars.githubusercontent.com/u/79175344?v=4)](https://github.com/jackharrispeninsulainteractive "jackharrispeninsulainteractive (150 commits)")

---

Tags

phpframeworklucent

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/blueprintau-lucent/health.svg)

```
[![Health](https://phpackages.com/badges/blueprintau-lucent/health.svg)](https://phpackages.com/packages/blueprintau-lucent)
```

###  Alternatives

[cakephp/cakephp

The CakePHP framework

8.9k20.0M1.8k](/packages/cakephp-cakephp)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k19](/packages/tempest-framework)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[typo3/cms-core

TYPO3 CMS Core

3313.6M5.5k](/packages/typo3-cms-core)[symfony/symfony

The Symfony PHP framework

31.4k87.4M2.2k](/packages/symfony-symfony)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

86337.5k](/packages/flow-php-flow)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)