Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/divergence/framework

PHP Framework providing ActiveRecord models and out of the box CRUD controllers with versioning and ORM support
https://github.com/divergence/framework

activerecord composer coverage crud-api divergence ffmpeg http-api-generator modern-practices mvc-framework mysql-orm orm php php-framework phpunit phpunit-tests psr15 psr7 restful-api twig

Last synced: about 2 months ago
JSON representation

PHP Framework providing ActiveRecord models and out of the box CRUD controllers with versioning and ORM support

Awesome Lists containing this project

README 

        
[![Code Coverage](https://scrutinizer-ci.com/g/Divergence/framework/badges/coverage.png?b=develop)](https://scrutinizer-ci.com/g/Divergence/framework/?branch=develop) [![Latest Stable Version](https://poser.pugx.org/divergence/divergence/downloads)](https://packagist.org/packages/divergence/divergence) [![Build Status](https://scrutinizer-ci.com/g/Divergence/framework/badges/build.png?b=develop)](https://scrutinizer-ci.com/g/Divergence/framework/build-status/develop) [![Latest Unstable Version](https://poser.pugx.org/divergence/divergence/v/stable)](https://packagist.org/packages/divergence/divergence) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/Divergence/framework/badges/quality-score.png?b=develop)](https://scrutinizer-ci.com/g/Divergence/framework/?branch=release) [![License](https://poser.pugx.org/divergence/divergence/license)](https://packagist.org/packages/divergence/divergence)



---

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



## [Documentation](https://github.com/Divergence/docs#divergence-framework-documentation)

## [Getting Started](https://github.com/Divergence/docs/blob/release/gettingstarted.md#getting-started)



[![asciicast](https://asciinema.org/a/FhE9hATLKDhH7oQfFbeNG5hzs.png)](https://asciinema.org/a/FhE9hATLKDhH7oQfFbeNG5hzs)



## Purpose

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](http://github.com/Divergence/framework) repository.**



### License



The Divergence framework is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)



### Credits

- Much of the original code in this framework was published as part of the [PHP framework portion](https://github.com/JarvusInnovations/Emergence-Skeleton) of [Emergence](https://github.com/JarvusInnovations/Emergence) by [Chris Alfano](https://github.com/themightychris).

 - This project is maintained by [Henry Paradiz](https://github.com/hparadiz)