PHPackages                             arsengoian/viper-framework - 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. arsengoian/viper-framework

ActiveLibrary[Framework](/categories/framework)

arsengoian/viper-framework
==========================

A lightweight multi-purpose PHP MVC framework

1.2.2(4y ago)228421Apache-2.0PHPPHP &gt;=7.1.0

Since Dec 18Pushed 1y ago3 watchersCompare

[ Source](https://github.com/arsengoian/viper-framework)[ Packagist](https://packagist.org/packages/arsengoian/viper-framework)[ RSS](/packages/arsengoian-viper-framework/feed)WikiDiscussions master Synced yesterday

READMEChangelog (7)Dependencies (2)Versions (10)Used By (1)

Viper
=====

[](#viper)

Viper is a lightweight universal PHP MVC framework with its own models and templating engine

Starting developing on Viper is as easy as typing in the console:

```
composer create-project arsengoian/viper PROJECT_NAME dev-master

```

and configuring DB credentials.

To check out the application build which is deployed with this command (or contribute) check out:

Configuration
-------------

[](#configuration)

The web application is configured by an array of YAML files at `config/` directory. They contain a list of instructions on every setting. `local.yaml` contains configuration related to the current server environment while `global.config` sets up overall application settings.

Settings may be accessed at any time using `Config` class:

```
if (Config::get('DEBUG'))     // From local.yaml -> local.yaml and global.yaml don't need a preffix
    return Config::get('Bots.VERIFY_TOKEN')    // From bots.yaml
```

Features
--------

[](#features)

### YAML routing

[](#yaml-routing)

Requests are routed automatically, for example a GET request to `http://website.com/chairs` will invoke the `get` method of `ChairsController`

Routing example:

```
welcome: DefaultController         # directs DOMAIN/welcome -> DefaultController::get($http_params)
hello: DefaultController.main      # directs DOMAIN/hello   -> DefaultController::main($http_params)
products:                          # 1-level hierarchies are also supported
    parse: DefaultController
    count: DefaultController.main
```

### Easy-to-use controllers and built-in validation

[](#easy-to-use-controllers-and-built-in-validation)

A controller function implementing a POST request:

```
public function post (...$args): ?Viewable
{
    $v = new Required($this -> params());                                 // Create validator
    $v -> email('email');                                                 // Validate "email" field

    Client::registerWithImages($this -> params(), $this -> files());      // Create new model in the database
    return new RedirectView('/');                                         // Redirect to main page
}
```

### Auto-completing models

[](#auto-completing-models)

Viper deals with databases automatically, miminizing the need to edit SQL manually. A YAML setup like this:

```
 allowOverwrite: true

 fields:
  fname: VARCHAR(255) NOT NULL
  lname: VARCHAR(255) NOT NULL
  email: VARCHAR(255) NOT NULL
  age: INT NOT NULL
  img: TEXT NOT NULL
```

will create the needed database structure if needed and update it along with the file if needed.

### Filters

[](#filters)

Will be applied to all routes before any controller actions:

```
class Application extends \Viper\Core\Application
{
    /**
     * Defines the list of filters to be run
     * before any controller actions
     * @return FilterCollection
     */
    protected function declareFilters (): FilterCollection
    {
        return new FilterCollection([
            LocalizationFilter::class,
            Authorization::class
        ]);
    }
}
```

### Logging and utilities

[](#logging-and-utilities)

Viper supports built-in logging and a collection of useful utilities, including caching, advanced string handling etc.

### Caching capabilities

[](#caching-capabilities)

All views and parsed .yaml files are recovered, if possible, from cache

Features in early development
-----------------------------

[](#features-in-early-development)

- Background processes and services
- Windows background tasks
- Viper templating engine
- Console commands
- Full Mysql support
- Full SQL Server support
- Other SQL dialects support
- Numerous feature and structure improvements

Contributing and development
----------------------------

[](#contributing-and-development)

Since the framework is on an early stage of development, it may feature structural irreversable changes without reverse compatibility.

Please contribute to the project if you also feel passionate about making PHP development more elegant and intuitive =)

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 64.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 ~270 days

Recently: every ~250 days

Total

7

Last Release

1492d ago

Major Versions

0.2 → 1.02019-08-31

### Community

Maintainers

![](https://www.gravatar.com/avatar/6d8ab20cc931cdd85e854b1c05e2064aaf36d9ca92d300db89c06a0f89f1c6ac?d=identicon)[arsengoian](/maintainers/arsengoian)

---

Top Contributors

[![arsengoian](https://avatars.githubusercontent.com/u/18646968?v=4)](https://github.com/arsengoian "arsengoian (9 commits)")[![Troyan911](https://avatars.githubusercontent.com/u/7659490?v=4)](https://github.com/Troyan911 "Troyan911 (4 commits)")[![romanbalickij](https://avatars.githubusercontent.com/u/40278257?v=4)](https://github.com/romanbalickij "romanbalickij (1 commits)")

---

Tags

frameworkviper

### Embed Badge

![Health badge](/badges/arsengoian-viper-framework/health.svg)

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

###  Alternatives

[marketplacekit/marketplacekit

Open source Marketplace Platform

8185.2k](/packages/marketplacekit-marketplacekit)[pestphp/pest-plugin-stressless

Stressless plugin for Pest

68943.9k18](/packages/pestphp-pest-plugin-stressless)

PHPackages © 2026

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