valkyrja/valkyrja

The Valkyrja Framework.

v26.0.0 2026-03-31 18:23 UTC

Requires

• php: >=8.4
• psr/container: ^2.0.2
• psr/event-dispatcher: ^1.0.0
• psr/http-message: ^2.0
• psr/http-server-handler: ^1.0.2
• psr/log: ^3.0.2

Requires (Dev)

• filp/whoops: ^2.18.4
• firebase/php-jwt: ^7.0.4
• guzzlehttp/guzzle: ^7.10.0
• league/flysystem: ^3.33.0
• league/flysystem-aws-s3-v3: ^3.32.0
• mailgun/mailgun-php: ^4.4.0
• monolog/monolog: ^3.10.0
• phpmailer/phpmailer: ^7.0.2
• predis/predis: ^3.4.2
• pusher/pusher-php-server: ^7.2.7
• twig/twig: ^3.24.0
• vonage/client-core: ^4.12.0

Suggests

• ext-curl: Required to use the default Client adapter (*)
• ext-pdo: Required to use the default ORM adapter (*)
• ext-redis: Required to use the default Cache store (^4.0|^5.0).
• ext-sodium: Required to use the default Crypt adapters and/or JWT EdDSA Algorithm (*)
• filp/whoops: Required to use the default Throwable handler (^2.18.4)
• firebase/php-jwt: Required to use the default Jwt adapter (^7.0.4)
• guzzlehttp/guzzle: Required to use the default Client adapter (^7.10.0).
• league/flysystem: Required to use the default Filesystem adapter (^3.33.0).
• league/flysystem-aws-s3-v3: Required to use the s3 Filesystem adapter (^3.32.0)
• mailgun/mailgun-php: Required to use the Mailgun Mail adapter (^4.4.0).
• monolog/monolog: Required to use the default Log adapter (^3.10.0).
• phpmailer/phpmailer: Required to use the default Mail adapter (^7.0.2).
• predis/predis: Required to use the Redis Cache store (^3.4.2).
• pusher/pusher-php-server: Required to use the Pusher Broadcast adapter (^7.2.7).
• twig/twig: Required to use the Twig View engine (^3.24.0).
• vonage/client-core: Required to use the default SMS adapter (^4.12.0).

Conflicts

• filp/whoops: <2.18.4
• firebase/php-jwt: <7.0.4
• guzzlehttp/guzzle: <7.10.0
• league/flysystem: <3.33.0
• league/flysystem-aws-s3-v3: <3.32.0
• mailgun/mailgun-php: <4.4.0
• monolog/monolog: <3.10.0
• phpmailer/phpmailer: <7.0.2
• predis/predis: <3.4.2
• pusher/pusher-php-server: <7.2.7
• twig/twig: <3.24.0
• vonage/client-core: <4.12.0

MIT

• Melech Mizrachi

• framework
• valkyrja

README

Valkyrja

Valkyrja is a PHP framework for web and console applications.

About Valkyrja

This repository contains the core code of the Valkyrja framework.

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. Let this fast, light, and robust framework do the heavy lifting for your app.

Build Status

Linting
Coding Rules
Static Analysis
Testing

Documentation

The Valkyrja documentation is baked into the repo so you can access it even when working offline.

Installation

There are two ways to install the Valkyrja framework.

Composer

You can either choose to install via composer as a dependency to a new or existing project.

Run the command below to require the framework in your existing composer json:

composer require valkyrja/valkyrja

If you are adding Valkyrja to a new blank project there are some files you'll need to create. You can follow the New Project Guide for more details.

Application Skeleton

Clone the Valkyrja Application and start from there.

Versioning and Release Process

Valkyrja uses semantic versioning with a major release every year, and support for each major version for 2 years from the date of release.

For more information view our Versioning and Release Process documentation.

Supported Versions

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

Version	PHP (*)	Release	Bug Fixes Until	Security Fixes Until
25 (**)	8.4 - 8.6	December 11th, 2025	March 31, 2026	March 31, 2026
26	8.4 - 8.6	March 31, 2026	Q2 2027	Q1 2028
27	8.5 - 8.6	Q1 2027	Q2 2028	Q1 2029
28	8.6+	Q1 2028	Q2 2029	Q1 2030

(*) Supported PHP versions (**) Pre-release that is not supported once v26 is released

Contributing

Valkyrja is an Open Source, community-driven project.

Thank you for your interest in helping us develop, maintain, and release the Valkyrja framework!

You can find more information in our Contributing documentation.

Security Issues

If you discover a security vulnerability within Valkyrja, please follow our disclosure procedure.

License

The Valkyrja framework is open-sourced software licensed under the MIT license. You can view the Valkyrja License here.