PHPackages                             valkyrja/valkyrja - 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. valkyrja/valkyrja

ActiveProject[Framework](/categories/framework)

valkyrja/valkyrja
=================

The Valkyrja Framework.

v26.3.0(1mo ago)510.6k[1 PRs](https://github.com/valkyrjaio/valkyrja/pulls)6MITPHPPHP >=8.4CI passing

Since May 9Pushed 1w ago1 watchersCompare

[ Source](https://github.com/valkyrjaio/valkyrja)[ Packagist](https://packagist.org/packages/valkyrja/valkyrja)[ Docs](https://www.valkyrja.io)[ RSS](/packages/valkyrja-valkyrja/feed)WikiDiscussions 26.x Synced 3w ago

READMEChangelog (10)Dependencies (51)Versions (124)Used By (6)

[ ![](https://raw.githubusercontent.com/valkyrjaio/art/refs/heads/master/long-banner/orange/php.png)](https://valkyrja.io)

Valkyrja
========

[](#valkyrja)

[Valkyrja](https://valkyrja.io) is a PHP framework for web and console applications.

Valkyrja (pronounced "Valk-ear-ya") is the Old Norse spelling for Valkyrie, a mythical creature that would guide warriors to Valhalla (the afterlife and a better place) after death. In a similar sense, the Valkyrja framework guides your application to be in a better state. Fast, light, and robust, Valkyrja does the heavy lifting so you can focus on your application.

 [![PHP Version Require](https://camo.githubusercontent.com/0d2acd96a184f18fb123477c33507a5c9bcdfd7c7f52de8a969aa715d394e694/68747470733a2f2f706f7365722e707567782e6f72672f76616c6b79726a612f76616c6b79726a612f726571756972652f706870)](https://packagist.org/packages/valkyrja/valkyrja) [![Latest Stable Version](https://camo.githubusercontent.com/5193c2db3becb6fc69e66e7761c3ea9b5665c9f384436fd6dc03800725af5ed4/68747470733a2f2f706f7365722e707567782e6f72672f76616c6b79726a612f76616c6b79726a612f76)](https://packagist.org/packages/valkyrja/valkyrja) [![License](https://camo.githubusercontent.com/968660e59fddeddda5f1372f49b4ec53d357fa109502858acee91ea78f25abc5/68747470733a2f2f706f7365722e707567782e6f72672f76616c6b79726a612f76616c6b79726a612f6c6963656e7365)](https://packagist.org/packages/valkyrja/valkyrja) [![CI Status](https://github.com/valkyrjaio/valkyrja-php/actions/workflows/ci.yml/badge.svg?branch=26.x)](https://github.com/valkyrjaio/valkyrja-php/actions/workflows/ci.yml?query=branch%3A26.x) [![Scrutinizer](https://camo.githubusercontent.com/5d9a25fd73e201a1a423e85aa16f9adc2b8fd978d5650cab5faa129f03ccca89/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f76616c6b79726a61696f2f76616c6b79726a612d7068702f6261646765732f7175616c6974792d73636f72652e706e673f623d32362e78)](https://scrutinizer-ci.com/g/valkyrjaio/valkyrja-php/?branch=26.x) [![Coverage Status](https://camo.githubusercontent.com/918df55cc9051b38cb7b89942238b9948c9e0a618613d606b73a7a475187c082/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f76616c6b79726a61696f2f76616c6b79726a612d7068702f62616467652e7376673f6272616e63683d32362e78)](https://coveralls.io/github/valkyrjaio/valkyrja-php?branch=26.x) [![Psalm Shepherd](https://camo.githubusercontent.com/26d822272844221cb4c0ba157bc76c3eaaa02fa4a23d2968f70d12fb5f966d48/68747470733a2f2f73686570686572642e6465762f6769746875622f76616c6b79726a61696f2f76616c6b79726a612d7068702f636f7665726167652e737667)](https://shepherd.dev/github/valkyrjaio/valkyrja-php) [![Maintainability Rating](https://camo.githubusercontent.com/cb1a85a2906809c68f8f0b0223fbd1270f67d6c8a829d4ede16246c4405578ab/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d76616c6b79726a61696f5f76616c6b79726a61266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/summary/new_code?id=valkyrjaio_valkyrja)

What's Included
---------------

[](#whats-included)

- **HTTP and CLI kernels** — unified application architecture serving both web requests and command-line invocations
- **Dependency injection container** — deferred bindings, contextual resolution, and compiled configuration for fast resolution at runtime
- **Routing** — expressive route definitions with middleware, constraints, and reverse resolution
- **Event dispatcher** — decoupled event handling with typed listeners
- **ORM and data layer** — database access with repository patterns and migrations
- **Persistent worker support** — first-class integration with OpenSwoole, FrankenPHP, and RoadRunner for production-grade performance

Installation
------------

[](#installation)

### Start a New Application

[](#start-a-new-application)

The fastest way to start a new Valkyrja application is with the starter template or the Sindri build tool:

- Use the [`valkyrja-starter-app-php`](https://github.com/valkyrjaio/valkyrja-starter-app-php) GitHub template ("Use this template" button on the repository page)
- Or run `composer create-project valkyrja/application your-project`
- Or use [Sindri](https://github.com/valkyrjaio/sindri-php): `composer create-project valkyrja/sindri your-project`

### Add to an Existing Project

[](#add-to-an-existing-project)

To require the framework as a dependency:

```
composer require valkyrja/valkyrja

```

Documentation
-------------

[](#documentation)

Full [documentation](./src/Valkyrja/README.md) is baked into the repository so you can browse it offline. Major areas include:

- [HTTP](./src/Valkyrja/Http/README.md) — routing, controllers, middleware, requests, responses
- [CLI](./src/Valkyrja/Cli/README.md) — commands, input, output, and dispatch
- [Container](./src/Valkyrja/Container/README.md) — dependency injection bindings and resolution
- [Events](./src/Valkyrja/Event/README.md) — event dispatch and listeners
- [ORM](./src/Valkyrja/Orm/README.md) — database access, repositories, and migrations

Ecosystem
---------

[](#ecosystem)

Valkyrja is the core framework. Surrounding it is an ecosystem of related projects in the Valkyrjaio organization:

- [**Sindri**](https://github.com/valkyrjaio/sindri-php) — build tool and application creator
- [**Starter (App)**](https://github.com/valkyrjaio/valkyrja-starter-app-php) — starter template for new applications
- **Worker runtimes** — [OpenSwoole](https://github.com/valkyrjaio/valkyrja-openswoole-php), [FrankenPHP](https://github.com/valkyrjaio/valkyrja-frankenphp-php), [RoadRunner](https://github.com/valkyrjaio/valkyrja-roadrunner-php)
- [**Docker**](https://github.com/valkyrjaio/valkyrja-docker-php) — ready-made Docker configurations

See the [Valkyrjaio organization page](https://github.com/valkyrjaio) for the complete listing.

Versioning and Release Process
------------------------------

[](#versioning-and-release-process)

Valkyrja follows [semantic versioning](https://semver.org/) with a major release every year, and support for each major version for 2 years from the date of release.

For more information see our [Versioning and Release Process documentation](./src/Valkyrja/VERSIONING_AND_RELEASE_PROCESS.md).

### Supported Versions

[](#supported-versions)

Bug fixes are provided until 3 months after the next major release. Security fixes are provided for 2 years after the initial release.

VersionPHPReleaseBug Fixes UntilSecurity Fixes Until25 (\*)8.4 – 8.6December 11th, 2025March 31, 2026March 31, 2026268.4 – 8.6March 31, 2026Q2 2027Q1 2028278.5 – 8.6Q1 2027Q2 2028Q1 2029288.6+Q1 2028Q2 2029Q1 2030(\*) Pre-release. Version 25 is not supported once version 26 is released.

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

[](#contributing)

Valkyrja is an open-source, community-driven project. Thank you for your interest in helping develop, maintain, and release it.

See [`CONTRIBUTING.md`](https://github.com/valkyrjaio/.github/blob/master/CONTRIBUTING.md) for the submission process and [`VOCABULARY.md`](https://github.com/valkyrjaio/.github/blob/master/VOCABULARY.md) for the terminology used across Valkyrja.

Security Issues
---------------

[](#security-issues)

If you discover a security vulnerability within Valkyrja, please follow our [disclosure procedure](https://github.com/valkyrjaio/.github/blob/master/SECURITY.md).

License
-------

[](#license)

Valkyrja is open-source software licensed under the [MIT license](https://opensource.org/licenses/MIT). See [`LICENSE.md`](./LICENSE.md).

###  Health Score

66

—

FairBetter than 99% of packages

Maintenance95

Actively maintained with recent releases

Popularity31

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity98

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 96.3% 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 ~31 days

Recently: every ~11 days

Total

105

Last Release

49d ago

Major Versions

v1.0.0 → v2.0.02025-01-13

v2.0.2 → v3.0.02025-06-15

v3.0.0 → v25.0.02025-12-12

v25.34.4 → v26.0.02026-03-31

25.x-dev → v26.1.02026-05-05

PHP version history (6 changes)v0.1PHP >=7.1

v0.9.0PHP >=7.2

v1.0.0PHP >=7.4

v2.0.0PHP >=8.1

v3.0.0PHP >=8.3

v25.0.0PHP >=8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/fbb43a59fb790365b014e53f82e3f26893867e4a47a249fc92962b6dc76878f2?d=identicon)[MelechMizrachi](/maintainers/MelechMizrachi)

---

Top Contributors

[![MelechMizrachi](https://avatars.githubusercontent.com/u/1179171?v=4)](https://github.com/MelechMizrachi "MelechMizrachi (3633 commits)")[![valkyrja-volundr[bot]](https://avatars.githubusercontent.com/in/2462900?v=4)](https://github.com/valkyrja-volundr[bot] "valkyrja-volundr[bot] (110 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (21 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![valkyrja-gha[bot]](https://avatars.githubusercontent.com/u/27898137?v=4)](https://github.com/valkyrja-gha[bot] "valkyrja-gha[bot] (2 commits)")[![NicolasCARPi](https://avatars.githubusercontent.com/u/3043706?v=4)](https://github.com/NicolasCARPi "NicolasCARPi (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

cliframeworkhttpmitmit-licensephpphp-frameworkphp8php84php85valkyrjaframeworkvalkyrja

### Embed Badge

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

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

###  Alternatives

[symfony/symfony

The Symfony PHP framework

31.4k87.2M2.2k](/packages/symfony-symfony)[cakephp/cakephp

The CakePHP framework

8.9k19.5M1.8k](/packages/cakephp-cakephp)[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)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[typo3/cms-core

TYPO3 CMS Core

3713.2M5.1k](/packages/typo3-cms-core)

PHPackages © 2026

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