Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/biurad/php-framework

๐Ÿ˜Ž A high performance scalable framework with expressive, elegant syntax and maintainable development
https://github.com/biurad/php-framework

biurad flange framework php php-framework symfony

Last synced: about 2 months ago
JSON representation

๐Ÿ˜Ž A high performance scalable framework with expressive, elegant syntax and maintainable development

Awesome Lists containing this project

README

        

# Application Skeleton for [PHP-Flange] ๐Ÿ‘Š

This is a skeleton application for creating applications using [PHP-Flange]. It is pre-configured, clean and easy to use. If you interested, you might check out our demo applications:

* [Distributed Chat App][] - This application implements an simple and real-time messaging system in PHP.
* [Symfony Like Blog App][] - This application is a simple and a [symfony's demo][sf-demo] like application.
* [Distributed Blog App][] - This application implements an advanced viral media blogging system in PHP.

## ๐Ÿ”ฐ Introduction

This project is structured using [Separation of Concerns][SOC] principle, instead of strictly following [MVC] design pattern.
Which provides modern and rapid development, with the flexibility to customized and use with any php library out there.

## ๐Ÿ”ฅ Features

- Flexible URI routing.
- Code reusable and easier to maintain.
- High-performance Lightweight PHP framework
- Perfect Container management, Dependency Injection (DI)
- PSR-{2,3,4,6,7,11,15,16,17} compliant
- Integration with external libraries
- Shipped with Tracy exceptions handler and debugger
- Flexible configuration's setup, highly scalable
- Supports hybrid runtime: [RoadRunner], [ReactPHP], [AmPHP], or [Swoole]
- And MORE ...

## ๐Ÿ“ฆ Getting Started & Installation

For getting started with this project or contributing, you have to follow the below procedure. First navigate to a main directory. Then run below command on terminal for getting started.

```sh
git clone https://github.com/biurad/php-framework.git flange
cd flange
```

OR

```sh
composer create-project biurad/framework my_project
```

Once installed, you can test it out immediately using PHP's built-in web server:

```sh
$ php flange serve
# OR use php command
$ php -S 127.0.0.1:8000 -t public
# OR use the composer alias:
$ composer run --timeout 0 serve
```

To update the project directory's structure to the latest version, run the following command:

```sh
php rade self-update
```

## ๐Ÿ““ Documentation

For in-depth documentation before using this library. Full documentation on advanced usage, configuration, and customization can be found at [docs.biurad.com](https://docs.biurad.com).

## โซ Upgrading

Information on how to upgrade to newer versions of this library can be found in the [UPGRADE].

## ๐Ÿท๏ธ Changelog

[SemVer](http://semver.org/) is followed closely. Minor and patch releases should not introduce breaking changes to the codebase; See [CHANGELOG] for more information on what has changed recently.

## ๐Ÿ‘ทโ€โ™€๏ธ Contributing

To report a security vulnerability, please use the [Biurad Security](https://security.biurad.com). We will coordinate the fix and eventually commit the solution in this project.

Contributions to this library are **welcome**, please see [CONTRIBUTING] for additional details.

## ๐Ÿงช Testing

To run the tests you'll have to start the included node based server first if any in a separate terminal window.

With the server running, you can start testing.

```bash
composer test
```

## ๐Ÿ‘ฅ Credits & Acknowledgements

- [Divine Niiquaye Ibok][@divineniiquaye]
- [All Contributors][]

## ๐Ÿ™Œ Sponsors

Are you interested in sponsoring development of this project? Reach out and support us on [Patreon](https://www.patreon.com/biurad) or see for a list of ways to contribute.

## ๐Ÿ“„ License

**biurad/php-framework** is licensed under the BSD-3 license. See the [`LICENSE`](LICENSE) file for more details.

[@divineniiquaye]: https://github.com/divineniiquaye
[UPGRADE]: UPGRADE.md
[CHANGELOG]: CHANGELOG.md
[CONTRIBUTING]: ./.github/CONTRIBUTING.md
[All Contributors]: https://github.com/divineniiquaye/php-framework/contributors
[PHP]: https://php.net
[Composer]: https://getcomposer.org/
[PHP-Flange]: https://github.com/biurad/flange
[RoadRunner]: https://github.com/spiral/roadrunner
[ReactPHP]: https://github.com/reactphp/reactphp
[AmPHP]: https://github.com/amphp/http-server
[Swoole]: https://www.swoole.co.uk/
[Distributed Chat App]: https://github.com/biurad/spacechat
[Distributed Blog App]: https://github.com/biurad/spaceblog
[Symfony Like Blog App]: https://github.com/divineniiquaye/rade-blog
[sf-demo]: https://github.com/symfony/demo
[SOC]: https://en.wikipedia.org/wiki/Separation_of_concerns
[MVC]: https://en.wikipedia.org/wiki/Model-view-controller