Skip to content

Commit

Permalink
update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
fenric committed Jan 17, 2020
1 parent edf8427 commit 2160b10
Showing 1 changed file with 105 additions and 0 deletions.
105 changes: 105 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,106 @@
## Awesome Skeleton for modern development on PHP 7.3+

[![Build Status](https://scrutinizer-ci.com/g/sunrise-php/awesome-skeleton/badges/build.png?b=master)](https://scrutinizer-ci.com/g/sunrise-php/awesome-skeleton/build-status/master)
[![Code Coverage](https://scrutinizer-ci.com/g/sunrise-php/awesome-skeleton/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/sunrise-php/awesome-skeleton/?branch=master)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/sunrise-php/awesome-skeleton/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/sunrise-php/awesome-skeleton/?branch=master)
[![Total Downloads](https://poser.pugx.org/sunrise/awesome-skeleton/downloads?format=flat)](https://packagist.org/packages/sunrise/awesome-skeleton)
[![Latest Stable Version](https://poser.pugx.org/sunrise/awesome-skeleton/v/stable?format=flat)](https://packagist.org/packages/sunrise/awesome-skeleton)
[![License](https://poser.pugx.org/sunrise/awesome-skeleton/license?format=flat)](https://packagist.org/packages/sunrise/awesome-skeleton)

---

## Installation

```bash
composer create-project 'sunrise/awesome-skeleton:^2.0' app
```

## Setup

```bash
php vendor/bin/doctrine orm:schema-tool:create
```

## Run CLI

```bash
php bin/app
```

## Run via PHP (listen 0.0.0.0:3000)

```bash
composer serve
```

## Run via RoadRunner (listen 0.0.0.0:3000)

```bash
rr -dv serve
```

## Run tests

```bash
composer test
```

## Run benchmarks

```bash
composer bench
```

---

## Useful commands

#### Generate Systemd unit file for RoadRunner

```bash
php bin/app app:roadrunner:generate-systemd-unit > app.service
```

#### Generate OpenApi document

```bash
php bin/app app:openapi:generate-documentation --pretty > openapi.json
```

---

## Used stack

* https://github.com/PHP-DI/PHP-DI
* https://github.com/sunrise-php/http-router
* https://github.com/doctrine/orm
* https://github.com/doctrine/migrations
* https://github.com/justinrainbow/json-schema

## Used technology

#### RoadRunner

* https://roadrunner.dev/
* https://github.com/spiral/roadrunner

#### OpenApi (Swagger) specification

* https://swagger.io/docs/specification/about/
* https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md

#### Json Schema specification

* https://json-schema.org/specification.html

---

## It may be useful to you

#### Awesome middlewares for your application

* https://github.com/middlewares/awesome-psr15-middlewares

---

with :heart: for you

0 comments on commit 2160b10

Please sign in to comment.