The Divergence Framework.

v2.1.3 2023-07-28 13:24 UTC

This package is auto-updated.

Last update: 2024-05-28 15:19:12 UTC


Code Coverage Latest Stable Version Build Status Latest Unstable Version Scrutinizer Code Quality License

Divergence is a PHP framework designed for rapid development and modern practices without becoming an over abstracted mess.


Getting Started



This collection of classes contains my favorite building blocks for developing websites with PHP and they have an impressive track record with hundreds of currently active websites using one version or another of the classes in this framework. While they were originally written years ago they are all PSR compatible and support modern practices out of the box.

Unit testing the code base and providing code coverage is a primary goal of this project.

Main Features

  • Models

    • Real PHP classes.
    • Map fields with array or attributes.
    • Built in support for relationships and object versioning.
    • Speed up prototyping and automate new deployments by automatically creates table based on your models when none are found.
    • Built in support for MySQL.
  • Routing

    • Simpler, faster, tree based routing system.
    • Built with basic class inheritance in mind.
  • Controllers

    • Psr7 compatible controllers.
    • Pre-made REST API controllers allow you to build APIs rapidly.
    • 100% Unit test coverage for filters, sorters, and conditions.
    • Build HTTP APIs in minutes by extending RecordsRequestHandler and setting the one config variable: the name of your model class.
    • Use a pre-made security trait with RecordsRequestHandler or extend it and write in your own permissions.
    • Standard permissions interface allows reuse of permission traits from one model to another.
  • Templates

    • Out of the box support for Twig
  • Media

    • Out of the box support for a media storage.
    • Automated thumbnail generation for JPEG, GIF, PNG, and PDF.
    • Built in support for MP4 and WEBM chunkable emitters allowing you to easily host videos with the ability to seek.
    • Manage media remotely with a built in JSON API using the standard permissions interface for all controllers.
    • Supports POST and PUT request types for media uploads.

Contributing To Divergence

All issues and pull requests should be filed on the Divergence/framework repository.


The Divergence framework is open-sourced software licensed under the MIT license