glueful/framework

Glueful API Framework - High-performance PHP API framework

v1.7.3 2025-10-21 07:08 UTC

Requires

• php: ^8.2
• dragonmantank/cron-expression: ^3.4
• intervention/image: ^3.11
• league/flysystem: ^3.30
• league/flysystem-local: ^3.30
• monolog/monolog: ^3.8
• nyholm/psr7: ^1.8
• nyholm/psr7-server: ^1.1
• psr/http-client: ^1.0
• psr/http-factory: ^1.1
• psr/http-server-middleware: ^1.0
• psr/simple-cache: ^3.0
• symfony/console: ^7.3
• symfony/finder: ^7.3
• symfony/http-client: ^7.3
• symfony/http-foundation: ^7.2
• symfony/lock: ^7.3
• symfony/mailer: ^7.3
• symfony/mime: ^7.3
• symfony/process: ^7.3
• symfony/psr-http-message-bridge: ^7.3
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• league/flysystem-memory: ^3.29
• phpstan/phpstan: ^1.0
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-phpunit: ^1.3
• phpstan/phpstan-strict-rules: ^1.0
• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^3.6
• symfony/var-dumper: ^7.3

MIT

• Michael Tawiah Sowah

• framework
• database
• queue
• php
• rest
• api
• cache
• jwt
• high-performance

README

High‑performance PHP API framework components for building secure, scalable backends. This repository contains the framework runtime (router, DI, HTTP, caching, security, queues, etc.). For a ready‑to‑use application skeleton, see the API skeleton link below.

Requirements

• PHP 8.2+
• Composer 2+

Installation

Install as a library into your application:

composer require glueful/framework

If you want a pre‑scaffolded app, use the API skeleton instead (recommended to get started quickly).

Quick Start (framework usage)

Bootstrap and handle a request:

<?php
declare(strict_types=1);

use Glueful\Framework;
use Symfony\Component\HttpFoundation\Request;

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

$framework = Framework::create(__DIR__)
    ->withConfigDir(__DIR__ . '/config')
    ->withEnvironment($_ENV['APP_ENV'] ?? 'development');

$app = $framework->boot();

// Define a quick route (see cookbook for best practices)
$router = $app->getContainer()->get(Glueful\Routing\Router::class);
$router->get('/ping', fn() => new Glueful\Http\Response(['ok' => true]));

$request = Request::createFromGlobals();
$response = $app->handle($request);
$response->send();
$app->terminate($request, $response);

Getting Started

• Getting started guide: https://glueful.com/getting-started
• New to Glueful? Begin with:
  • Routing: https://glueful.com/essentials/routing
• Prefer a pre‑scaffolded app? Use the API skeleton (see below).

Documentation

• Official docs website: https://glueful.com (mirror: https://glueful.dev)
• Changelog: CHANGELOG.md
• Roadmap: ROADMAP.md
• Breaking changes process: BREAKING_CHANGE_PROCESS.md

Highlights

• Next‑gen Router (fast static/dynamic matching, groups, named routes, PSR‑15 middleware bridge)
• Clean DI over Symfony Container, service providers, lazy services
• Structured config with environment layering and caching
• Observability: logging, metrics, tracing hooks
• Cache drivers (array/file/redis/memcached) with tagging and warmup utilities
• Security: rate limiting, CSRF, headers, lockdown, permission system hooks
• Queues, scheduling, console commands

API Skeleton (recommended to start)

For a ready‑to‑run project scaffold, use the API skeleton and follow its README. It wires this framework, public entrypoints, config, and examples:

• Packagist: https://packagist.org/packages/glueful/api-skeleton

Quick start:

composer create-project glueful/api-skeleton my-app
cd my-app
php glueful serve

Contributing

Contributions are welcome. Please open issues or PRs. For larger proposals, consider starting with a discussion referencing the implementation plans in docs/implementation_plans/.

License

MIT — see LICENSE.