PHPackages                             cape-dev/php-framework - 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. cape-dev/php-framework

ActiveProject

cape-dev/php-framework
======================

A lightweight PHP web application framework for rapid development (routing, DI, database, views, console, caching).

v1.0.3(1mo ago)01↓100%MITPHPPHP >=8.1

Since Mar 17Pushed 1mo agoCompare

[ Source](https://github.com/joel767443/cape-dev-framework)[ Packagist](https://packagist.org/packages/cape-dev/php-framework)[ RSS](/packages/cape-dev-php-framework/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (23)Versions (4)Used By (0)

cape-dev
========

[](#cape-dev)

A lightweight custom PHP backend (routing + middleware + DI + validation + migrations) with a server-rendered landing page.

What’s included (backend)
-------------------------

[](#whats-included-backend)

- **Routing**: Symfony Routing (`symfony/routing`) via `routes/api.php` + `src/Http/Kernel.php`
- **HTTP layer**: Symfony HttpFoundation (`symfony/http-foundation`)
- **DI container**: PHP-DI (`php-di/php-di`) + service providers (`src/Providers/*`)
- **Validation**: Symfony Validator (`symfony/validator`) + `App\Requests\FormRequest`
- **Database**: Eloquent/Illuminate Database (`illuminate/database`) + migrations (`php run migrate`)
- **ORM (optional)**: Doctrine ORM (`doctrine/orm`) with `php run doctrine:schema:update`
- **Outbound HTTP**: Guzzle (`guzzlehttp/guzzle`) via `WebApp\Http\Client\HttpClient`
- **Auth**: JWT (`firebase/php-jwt`) middleware alias `auth_jwt` + token endpoint `POST /api/auth/token`
- **Queue**: custom Redis queue + **optional** Symfony Messenger (`symfony/messenger`)
- **Logging**: Monolog (`monolog/monolog`)
- **Testing**: PHPUnit + Pest
- **Extras**: Dotenv, Carbon (`now()`), UUID (`uuid()`)

Installation + quickstart
-------------------------

[](#installation--quickstart)

### Start the backend

[](#start-the-backend)

```
chmod +x bin/dev
./bin/dev
```

### One-word CLI (`php run`)

[](#one-word-cli-php-run)

`run` still works, but you can also run the console as:

```
php run
php run route:list
php run dev
```

### Backend (PHP)

[](#backend-php)

```
composer install

# start HTTP server (from repo root)
php -S localhost:8001 -t public public/index.php
```

Open `http://localhost:8001/` for the landing page, or `http://localhost:8001/docs` for docs.

API endpoints (current routes)
------------------------------

[](#api-endpoints-current-routes)

Routes are defined in `routes/api.php`.

MethodPathDescriptionPOST`/api/auth/token`Issue a JWT tokenGET`/api/secure/ping`JWT-protected example endpointPOST`/api/validate`Validation example (returns validated payload or 422)Backend architecture (source of truth)
--------------------------------------

[](#backend-architecture-source-of-truth)

- **Entrypoint**: `public/index.php` loads routes from `routes/api.php` (and `routes/web.php`) and runs `WebApp\Application`.
- **HTTP kernel**: `src/Http/Kernel.php` matches routes (Symfony Routing), runs middleware, invokes controllers, and enforces that controllers return a `Symfony\Component\HttpFoundation\Response`.
- **Middleware**: global middleware is wired in `src/Application.php`. Route middleware is attached per route (or via `Router::group()`) and resolved via `src/Http/Middleware/MiddlewareRegistry.php`.
- **Validation**: request validation is Symfony Validator via `App\Requests\FormRequest` + `WebApp\Validation\RequestValidator`. If a controller action type-hints a `FormRequest`, it is automatically validated by the kernel before the controller runs.
- **Database**: configured in `config/database.php` and wired via `src/Providers/DatabaseServiceProvider.php` (Illuminate Database / Eloquent).
- **Migrations**: discovered in `app/Database/Migrations` and run via `php run migrate`.

CLI (run)
---------

[](#cli-run)

```
php run route:list
php run make:request StoreItemRequest
php run make:migration create_items_table
php run migrate
```

Docs
----

[](#docs)

- [Docs index](docs/README.md)
- [Installation + quickstart](docs/installation-and-quickstart.md)
- [Routing + middleware](docs/routing-and-middleware.md)
- [Controllers/requests/responses](docs/controllers-requests-responses.md)
- [Validation](docs/validation.md)
- [Database + migrations](docs/database-and-migrations.md)
- [DI container + providers](docs/di-container-and-providers.md)
- [Testing](docs/testing.md)
- [Authentication (JWT)](docs/auth.md)
- [Queue](docs/queue.md)
- [Upgrade guide](docs/upgrade-guide.md)
- [Changelog](CHANGELOG.md)

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance96

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

3

Last Release

53d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c5892a06b5cc3a1f6adaa3fa3d0cb5e9f77c6fc613425df614e2c4778b2e0a7?d=identicon)[joel767443](/maintainers/joel767443)

---

Top Contributors

[![joel767443](https://avatars.githubusercontent.com/u/985991?v=4)](https://github.com/joel767443 "joel767443 (44 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/cape-dev-php-framework/health.svg)

```
[![Health](https://phpackages.com/badges/cape-dev-php-framework/health.svg)](https://phpackages.com/packages/cape-dev-php-framework)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M646](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

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