https://github.com/lapinskas/roadrunner-ubiquity
RoadRunner and Ubiquity integration
https://github.com/lapinskas/roadrunner-ubiquity
php roadrunner ubiquity
Last synced: 10 months ago
JSON representation
RoadRunner and Ubiquity integration
- Host: GitHub
- URL: https://github.com/lapinskas/roadrunner-ubiquity
- Owner: Lapinskas
- License: mit
- Created: 2020-02-16T19:46:16.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-03-20T19:36:28.000Z (over 5 years ago)
- Last Synced: 2024-12-29T12:30:29.442Z (over 1 year ago)
- Topics: php, roadrunner, ubiquity
- Language: PHP
- Homepage:
- Size: 49.8 KB
- Stars: 9
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# [RoadRunner][link_roadrunner] and [Ubiquity][link_ubiquity] Integration
[![Version][badge_packagist_version]][link_packagist]
Makes [the fastest PHP framework][link_php_bench] even faster.
## Installation
### Automatic installation
Just tell Ubiquity to run with RoadRunner
```shell
$ Ubiquity serve -t=roadrunner
```
All required components (except of PHP-CGI) will be installed at the first launch.
### Manual installation
If you need package for your own projects, just require it via composer
```shell
$ composer require lapinskas/roadrunner-ubiquity
```
## Dependencies
### Ubiquity
Get [Ubiquiry Framework](https://github.com/phpMv/ubiquity) if you have not done it yet
### PHP-CGI
php-cgi 7.4 is required for this package.
> Please note it's php-cgi, not php, so most probably you have not it installed by default.
#### php-cgi installation on Ubuntu 18.04 LTS
As of today, PHP 7.4 is not available in Ubuntu default repositories. In order to install it, you will have to get it from third-party repositories.
```shell
$ sudo add-apt-repository ppa:ondrej/php
```
Then update and upgrade to PHP 7.4
```shell
$ sudo apt update
```
and install php-cgi
```shell
$ sudo apt-get install php7.4-cgi
```
## Usage
As an example of a basic usage, let's create default Ubiquity project and run it using RoadRunner
### Create sample Ubiquity project
Let's create new project called 'firstProject' in a folder of your choice.
Flag -a adds rather powerful UbiquityMyadmin application that we can use for usage testing.
```shell
$ Ubiquity new firstProject -a
$ cd firstProject
```
> Note: if Ubiquity is not in your path, you can find it at ~/.composer/vendor/phpmv/ubiquity-devtools/src/Ubiquity
### Run Ubiquity
Tell Ubiquity to run using RoadRunner
```shell
$ Ubiquity serve -t=roadrunner
```
### Alternative - Run RoadRunner directly
Run RoadRunner in debug mode
```
$ ./rr serve -v -d
```
### Open UbiquityMyadmin page
Open admin page of Ubiquity application in your browser
[http://127.0.0.1:8090/Admin](http://127.0.0.1:8090/Admin)
Ubiquity application is exactly the same and could be run using command "Ubiquity serve", NGINX or Apache servers. The only change is the entry point of the application.
### Benchmarking
Each worker takes some time for the bootstraping / initialization for the very first request.
The consecutive requests do not require the bootstraping that results in much faster processing after all workers have been initialized.
Please feel free to run some benchmarking tests of RoadRunner+Ubiquity vs NGINX+Ubiquity or Apache+Ubiquity.
Preliminary tests have shown more than 100% increase in the number of requests per second and twice quicker response time.
## Changelog
[![Version][badge_packagist_version]][link_packagist]
[![Release date][badge_release_date]][link_releases]
Changelog can be [found here][link_changes_log].
## License
[](https://packagist.org/packages/lapinskas/roadrunner-ubiquity)
This is open-sourced software licensed under the [MIT License][link_license].
[badge_packagist_version]:https://img.shields.io/packagist/v/lapinskas/roadrunner-ubiquity.svg?maxAge=180
[badge_release_date]:https://img.shields.io/github/release-date/Lapinskas/roadrunner-ubiquity.svg?style=flat-square&maxAge=180
[link_roadrunner]:https://github.com/spiral/roadrunner
[link_ubiquity]:https://github.com/phpMv/ubiquity
[link_packagist]:https://packagist.org/packages/lapinskas/roadrunner-ubiquity
[link_php_bench]:http://www.phpbenchmarks.com/en/
[link_releases]:https://github.com/Lapinskas/roadrunner-ubiquity/releases
[link_changes_log]:https://github.com/Lapinskas/roadrunner-ubiquity/blob/master/CHANGELOG.md
[link_license]:https://github.com/Lapinskas/roadrunner-ubiquity/blob/master/LICENSE