PHPackages                             nonaje/quill - 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. [API Development](/categories/api)
4. /
5. nonaje/quill

ActiveLibrary[API Development](/categories/api)

nonaje/quill
============

A simple framework to make lightweight PHP APIs

0.1.0(2y ago)312PHP

Since Apr 4Pushed 1mo ago1 watchersCompare

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

READMEChangelog (5)Dependencies (7)Versions (10)Used By (0)

Quill Framework
===============

[](#quill-framework)

`quill-framework` is a reusable HTTP kernel: a container, router, middleware pipeline, request/response contracts, and supporting loaders that can be embedded inside any composition root. It does **not** ship a runtime executable or starter project—those responsibilities move to `quill-app`.

- Read `docs/framework-boundary.md` for the canonical split between the framework and consumers.
- Read `docs/quill-app-skeleton.md` for the minimal responsibilities planned for the official starter.

Programmatic Bootstrap
----------------------

[](#programmatic-bootstrap)

Provide the framework with explicit filesystem inputs and service overrides, then let your own runtime feed PSR-7 requests into the resulting application:

```
use Nyholm\Psr7Server\ServerRequestCreator;
use Quill\Contracts\Response\ResponseSenderInterface;
use Quill\Factory\QuillFactory;

require __DIR__ . '/vendor/autoload.php';

$root = __DIR__;

$app = QuillFactory::shared($root, [
    'config' => [
        'paths' => [$root . '/config'],
        'env_paths' => [$root . '/.env', $root . '/.env.local'],
        'defaults' => ['app' => ['debug' => false]],
        'overrides' => ['app' => ['debug' => getenv('APP_DEBUG') === 'true']],
    ],
    'routes' => [
        'paths' => [$root . '/routes'],
    ],
    'singletons' => [
        ResponseSenderInterface::class => static fn () => new CustomSender(),
    ],
]);

$app->get('/health', static fn ($request, $response) => $response->json(['ok' => true]));

$creator = ServerRequestCreator::fromGlobals();
$app->handle($creator->fromGlobals());
```

- `QuillFactory::make($root, $options)` returns a fresh container every call.
- `QuillFactory::shared($root, $options)` caches one instance per root; call `QuillFactory::forget($root)` (or without arguments) when workers/tests need a reset.
- `app($root, $options)` is a thin helper that records the default root and proxies to `QuillFactory::shared()`. Once the root is set you may call `app()` without arguments.
- `QuillFactory::container($root)` exposes the DI container if you need lower-level access.

Nothing is auto-loaded anymore: if you want `.env` files, configuration directories, or route trees to load, pass those paths under `config.env_paths`, `config.paths`, and `routes.paths` respectively.

Composition Responsibilities
----------------------------

[](#composition-responsibilities)

This package provides loaders (`Quill\Loaders\ConfigurationFilesLoader`, `Quill\Loaders\DotEnvLoader`, `Quill\Loaders\RouteFilesLoader`) and contracts, but it is up to your repository to decide **when** they run. A typical consumer will:

1. Define its own filesystem layout (`config/*.php`, `routes/**/*.php`, `.env*`).
2. Call `QuillFactory` with explicit paths and per-environment overrides.
3. Supply runtime adapters (PSR-7 factories, event loop, web server) and wire them to `$app->handle($psrRequest)` or `$app->processRequest($psrRequest)`.
4. Register application services via the `bindings`, `singletons`, or `boot` hooks instead of touching internal container state.

Contracts & Extension Points
--------------------------------

[](#contracts--extension-points)

The following contracts form the public boundary that other repositories can depend on (see the boundary doc for the authoritative list):

- Container & lifecycle: `Quill\Contracts\ApplicationInterface`, `Quill\Contracts\Container\ContainerInterface`.
- Configuration: `Quill\Contracts\Configuration\ConfigurationInterface` plus the loaders mentioned above.
- HTTP: `Quill\Contracts\Request\RequestInterface`, `Quill\Contracts\Request\RequestFactoryInterface`, `Quill\Contracts\Response\ResponseInterface`, `Quill\Contracts\Response\ResponseSenderInterface`.
- Routing & middleware: `Quill\Contracts\Router\RouterInterface`, `RouteInterface`, `RouteGroupInterface`, `RouteStoreInterface`, `MiddlewareStoreInterface`, `Quill\Contracts\Middleware\MiddlewarePipelineInterface`, `Quill\Contracts\Middleware\MiddlewareFactoryInterface`.
- Error handling & support: `Quill\Contracts\ErrorHandler\ErrorHandlerInterface`, `Quill\Contracts\Support\PathResolverInterface`.

All extension takes place through those contracts: register singletons/bindings, run configuration overrides, or contribute routes/middleware with the exposed router APIs.

Runtime Expectations
--------------------

[](#runtime-expectations)

`quill-framework` no longer couples to Nyholm or any specific server runtime. Tests rely on Nyholm inside `require-dev` purely to create PSR-7 requests; consumers are free to swap in any PSR-7 implementation or server runner as long as they feed PSR-7 messages into the application and honour the interfaces above.

The upcoming `quill-app` repository will ship the default runtime entrypoints, DX tooling, and scaffolding expected by most projects. Until then, this package focuses exclusively on the reusable framework surface.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance60

Regular maintenance activity

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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 ~181 days

Total

5

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9a47d54f4efebd2945b6daf109bb6847fd8bc8220f416d4941c42905400830b7?d=identicon)[nonaje](/maintainers/nonaje)

---

Top Contributors

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

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/nonaje-quill/health.svg)

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

###  Alternatives

[thecodingmachine/graphqlite

Write your GraphQL queries in simple to write controllers (using webonyx/graphql-php).

5723.1M30](/packages/thecodingmachine-graphqlite)[jaxon-php/jaxon-core

Jaxon is an open source PHP library for easily creating Ajax web applications

73142.3k25](/packages/jaxon-php-jaxon-core)[wordpress/php-ai-client

A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.

26236.6k14](/packages/wordpress-php-ai-client)[neos/flow

Flow Application Framework

862.0M451](/packages/neos-flow)[neos/flow-development-collection

Flow packages in a joined repository for pull requests.

144179.3k3](/packages/neos-flow-development-collection)[chartmogul/chartmogul-php

ChartMogul API PHP Client

181.4M](/packages/chartmogul-chartmogul-php)

PHPackages © 2026

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