Download the PHP package k2gl/pragmatic-franken without Composer

On this page you can find all versions of the php package k2gl/pragmatic-franken. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package pragmatic-franken

Pragmatic FrankenPHP

CI Latest Stable Version PHP 8.5 FrankenPHP 1.x Symfony 8 PHPStan Level 10 License

Pragmatic FrankenPHP is a PHP 8.5 / Symfony 8 / FrankenPHP starter that real production projects actually grew out of — and the lessons were ported back. Vertical Slices + CQRS over Messenger, PostgreSQL 17, worker mode, real prod image, supply-chain attestations. The goal: fork it and ship a real product on day one, operated by humans and AI agents alike.

The promises are CI-proven, not vibes:

For architecture rules and code-level guidance, see AGENTS.md — the single source of truth, ≤ 2 000 tokens, equally usable by developers and AI tools.

Stack

Layer Choice Why
Application server FrankenPHP 1.x (Caddy + worker mode) one binary, HTTP/3, kernel kept hot
Framework Symfony 8.0 mature, attribute-based wiring
Bus Symfony Messenger (CQRS) sync commands/queries, async events
Database PostgreSQL 17 Doctrine ORM 3
Queue Messenger on Doctrine transport no extra extension, inspectable, production-proven
Cache Redis 7 (Predis) ready for caching and custom needs
Frontend (default) AssetMapper + Twig no Webpack/Vite needed for HTML-first
Code style Laravel Pint (PSR-12) one-flag autofix
Static analysis PHPStan level 10 enforced in CI
Tests PHPUnit 12 + Zenstruck (Foundry, Browser, Messenger-Test) + DAMA + Faker + Fluent Assertions pyramid 60/30/10

Quickstart

Path 1 — template + Docker (nothing but Docker needed):

Path 2 — composer create-project (needs PHP ≥ 8.5 on the host):

The app comes up at https://my-app.localhost:${HTTPS_PORT:-4750} (browsers resolve *.localhost automatically — no /etc/hosts edits). Try the example API: POST /tasks, GET /tasks, POST /tasks/{id}/complete — completion pushes a Mercure live update on /tasks.

Why not just symfony/skeleton?

pragmatic-franken symfony/skeleton dunglas/symfony-docker API Platform
Architecture opinion Vertical Slices + CQRS, 18 ADRs none none API-first framework
Prod image built, booted & scanned per PR — built built
Real example vertical entity→migration→factory→tests — — generated CRUD
Deploy story blue-green to a VDS + backups + DR drill — — k8s helm
Supply chain attestations + offline verifier + gate — — —
Agent affordances AGENTS.md (≤2k tokens) + CI-proven scaffolding — — —
Best when product API/app on one VDS, agents in the loop you want vanilla you want plain Docker your product is the API

Honest non-goals: no auth in core (recipe instead), no bundled SPA, no Kubernetes, no multi-DB.

Daily commands

Command Effect
make up / make down start / stop containers
make shell (alias make e) shell inside the app container
make test PHPUnit, fail-fast
make check Pint + PHPStan (pre-commit gate)
make ci lint-check + analyze + test (CI parity)
make smoke end-to-end smoke check
make slice context=Foo feature=Bar scaffold a vertical slice
make adr title="My Decision" scaffold a new ADR
make docs-check lint docs against reality (routes, targets, budgets)
make agent-smoke prove scaffolded code passes all gates untouched
make db-seed demo data (app:seed)

Project layout

The example slices (Health/Healthz, Home/Index, Task) are reference implementations — Healthz is normative for ADR-0005 health checks, Task for the full entity → migration → factory → tests vertical; Home/Index is non-normative (drop it for API-only or SPA projects).

Architecture decisions

All decisions live in docs/adr/. Each ADR carries YAML front-matter (status, date, audience, summary) so agents can skim without loading the full body.

ADR Topic Status
0001 Vertical Slices Accepted
0002 Messenger Transport Accepted
0003 Pragmatism Charter Accepted
0004 FrankenPHP Runtime Accepted
0005 Health Checks Accepted
0006 Memory Management Accepted
0007 AssetMapper Accepted
0008 Testing Strategy Accepted
0009 Shared Architecture Accepted
0010 Documentation & AI Layout Accepted
0011 Event Sourcing Lite Accepted
0012 Ubiquitous Language & Entity Placement Accepted
0013 Doctrine Repository Pattern Accepted
0014 Supply-Chain Security Accepted
0015 Scheduler & Periodic Tasks Accepted
0016 HTTP Response Contract Accepted
0017 Parallel Agent Sessions Accepted
0018 Input Validation & Domain Invariants Accepted

Guides

Recipes (opt-in capabilities)

Proven in real production projects grown from this skeleton, documented instead of bundled: JWT auth · feature flags · SPA frontend · preview environments.

Staying close to the template

Forks don't merge templates — they apply changes. Each release ships an UPGRADE.md entry with the few changes worth porting; see docs/guides/fork-maintenance.md.

AI agents

The repository ships with a single AGENTS.md at the root, intended to be read by every AI tool by convention. There are no .cursorrules, .windsurfrules, .cursor/rules/* or per-tool prompt files — see ADR-0010 for the rationale.

Machine-local Claude Code settings live in .claude/settings.local.json (gitignored); parallel agent sessions get isolated stacks via dev/worktree.sh (ADR-0017).

Contributing

See .github/CONTRIBUTING.md. Conventional Commits required for the message header. CI gates: Pint, PHPStan level 10, PHPUnit. make ci mirrors the pipeline locally.

License

MIT.

All versions of pragmatic-franken with dependencies

PHP Build Version
Package Version
Requires php Version >=8.5
ext-pdo_pgsql Version *
doctrine/dbal Version ^4.0
doctrine/doctrine-bundle Version ^3.2.2
doctrine/doctrine-migrations-bundle Version ^4.0
doctrine/migrations Version ^3.8
doctrine/orm Version ^3.3
k2gl/app-env Version ^1.0
k2gl/entity-exist Version ^1.14
k2gl/enum Version ^2.1
k2gl/sigstore-verify Version ^1.2
k2gl/slsa-provenance Version ^1.1
nelmio/api-doc-bundle Version ^5.9
nelmio/cors-bundle Version ^2.6
predis/predis Version ^3.3
symfony/asset Version ^8.0
symfony/asset-mapper Version ^8.0
symfony/console Version ^8.0
symfony/doctrine-bridge Version ^8.0
symfony/doctrine-messenger Version ^8.1
symfony/dotenv Version ^8.0
symfony/framework-bundle Version ^8.0
symfony/http-kernel Version ^8.0
symfony/mercure-bundle Version ^0.4.2
symfony/messenger Version ^8.0
symfony/monolog-bridge Version ^8.0
symfony/property-access Version ^8.0
symfony/property-info Version ^8.0
symfony/routing Version ^8.0
symfony/runtime Version ^8.0
symfony/scheduler Version ^8.1
symfony/security-bundle Version ^8.0
symfony/serializer Version ^8.0
symfony/twig-bundle Version ^8.0
symfony/uid Version ^8.0
symfony/validator Version ^8.0
symfony/var-exporter Version ^8.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package k2gl/pragmatic-franken contains the following files

Loading the files please wait ...