PHPackages                             fridaylabs/service - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. fridaylabs/service

ActiveProject

fridaylabs/service
==================

12 factor service skeleton

11PHP

Since Jul 26Pushed 8y agoCompare

[ Source](https://github.com/FridayLabs/service)[ Packagist](https://packagist.org/packages/fridaylabs/service)[ RSS](/packages/fridaylabs-service/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

12 factor php service skeleton
==============================

[](#12-factor-php-service-skeleton)

TL;DR
=====

[](#tldr)

### install

[](#install)

macOs: `brew install docker`

Linux/Unix:

```
apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
apt-add-repository 'deb https://apt.dockerproject.org/repo ubuntu-xenial main'
apt-get update
apt-get install docker-engine

```

### use

[](#use)

`make` to build

`make dev` to build and run local version

Dev version will appear here:

What's inside
=============

[](#whats-inside)

1. nginx
2. php7.1 + php-fpm
3. slim ^3.0
4. supervisord to rule them all

12 factor Manifest
==================

[](#12-factor-manifest)

Codebase
--------

[](#codebase)

Create project

```
composer create-project fridaylabs/service -s dev --no-install --ignore-platform-reqs

```

and push it to your repo

Dependencies
------------

[](#dependencies)

Solved by composer

Config
------

[](#config)

1. All configs should be pulled from environment.
2. **Don't use variables like APPLICATION\_ENVIRONMENT!**
3. Use `.env` file for local setup

Backing services
----------------

[](#backing-services)

Use config for connecting with DB, Queue or other services

Build, release, run
-------------------

[](#build-release-run)

1. Type `make` to build
2. Type `make dev` to build and run local version
3. **TODO:** Push your branch to run tests, merge branch to release

Processes
---------

[](#processes)

1. Make sure, that your app is stateless.
2. Store all your data into remote services

Port binding
------------

[](#port-binding)

1. App exposing 80 and 443 port.
2. Default dev port is 8081

Concurrency
-----------

[](#concurrency)

Solved by php-fpm

Disposability
-------------

[](#disposability)

Solved by supervisord

Dev/prod parity
---------------

[](#devprod-parity)

Solved by docker and composer

Logs
----

[](#logs)

1. Nginx, php-fpm and app writes logs to stdout
2. Don't write logs to FS

Admin processes
---------------

[](#admin-processes)

**TODO**

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/d62235b256c5b51032931111e588eaf4385b0bae936ea5da5b51ec760c9c2ec0?d=identicon)[neronmoon](/maintainers/neronmoon)

---

Top Contributors

[![neronmoon](https://avatars.githubusercontent.com/u/486922?v=4)](https://github.com/neronmoon "neronmoon (12 commits)")

---

Tags

fridaylabs-cloud

### Embed Badge

![Health badge](/badges/fridaylabs-service/health.svg)

```
[![Health](https://phpackages.com/badges/fridaylabs-service/health.svg)](https://phpackages.com/packages/fridaylabs-service)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)