PHPackages                             floknapp/faulancer - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. floknapp/faulancer

Abandoned → [nixphp/framework](/?search=nixphp%2Fframework)ArchivedLibrary[Utility &amp; Helpers](/categories/utility)

floknapp/faulancer
==================

A collection of helpers to kickstart your project

v0.3(7y ago)1198[1 issues](https://github.com/FloKnapp/faulancer/issues)MITPHPPHP ^7.1

Since Jan 4Pushed 7y ago1 watchersCompare

[ Source](https://github.com/FloKnapp/faulancer)[ Packagist](https://packagist.org/packages/floknapp/faulancer)[ RSS](/packages/floknapp-faulancer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (22)Used By (0)

[![Build Status](https://camo.githubusercontent.com/9e1a452cd1b704e89102cecb46aa0ae64934a772d8dd7bd34e97f9fe1d9d7846/68747470733a2f2f7472617669732d63692e6f72672f466c6f4b6e6170702f6661756c616e6365722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/FloKnapp/faulancer)[![Coverage Status](https://camo.githubusercontent.com/f8e2dc4d14525cfece1ad0dc918c9755ead7cbd68e173520c25f4b7dcc8b3d1e/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f466c6f4b6e6170702f6661756c616e6365722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/FloKnapp/faulancer?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/5b52c4c64648334e9a594511be7ea38f92fefbecc85eaa570ae35b269148bfc0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f466c6f4b6e6170702f6661756c616e6365722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/FloKnapp/faulancer/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/149183db526b59f01d4e8f74975f20e510b300b502e4ca1dcb9f4509bbaba67f/68747470733a2f2f706f7365722e707567782e6f72672f666c6f6b6e6170702f6661756c616e6365722f762f737461626c65)](https://packagist.org/packages/floknapp/faulancer)[![Total Downloads](https://camo.githubusercontent.com/9aabf9fb058f385ff7d2dd11218fcb27db4fb1c45cc47440dbb93a7de0c4687b/68747470733a2f2f706f7365722e707567782e6f72672f666c6f6b6e6170702f6661756c616e6365722f646f776e6c6f616473)](https://packagist.org/packages/floknapp/faulancer)[![License](https://camo.githubusercontent.com/266af9b00e646af7a1cfab5a4c39352a78bbf3ae93d5fbd7e45215c3134e1ad4/68747470733a2f2f706f7365722e707567782e6f72672f666c6f6b6e6170702f6661756c616e6365722f6c6963656e7365)](https://packagist.org/packages/floknapp/faulancer)

PHPDox Documentation
====================

[](#phpdox-documentation)

Introduction
============

[](#introduction)

This repository provides default configuration files and a very basic directory structure to kickstart your project with the Faulancer Framework. This framework is maintained in my spare time with the goal to simplify every process and to provide you the possibility to understand the process behind every core functionality.

This means that there are some techniques which are meanwhile considered 'deprecated' or not suitable for tests (wrong), but provides robust and reliable functionality. For example, the ServiceLocator- and Factory-Pattern. In my opinion there are many positive aspects:

- really simple, understandable and fast
- well proven technique over the past decade
- it forces 'separation of concerns' automatically

---

Get started
===========

[](#get-started)

Navigate to your preferred directory where the application should be installed and enter the following command into console:

```
user@machine> composer create-project floknapp/faulancer-kickstart path-to-your-directory/
```

If you already created the target directory, navigate to it and type:

```
user@machine> composer create-project floknapp/faulancer-kickstart .
```

---

Overview
========

[](#overview)

### Controllers

[](#controllers)

You can define controllers wherever you want. But i strongly suggest to stick with the current directory structure, which provides a simple yet clear overall view about the responsibilities.

### Services

[](#services)

Everything is a service. For better separation all services are located in the 'Service'-Folder. The services file- and classname should be suffixed with the term 'Service'.

Note: Use services to get data from an API endpoint which logic should not be live within a controller.

Naming example: `RegistrationService`

### Factories

[](#factories)

The managing ServiceLocator automatically searches for a 'Factory'-Folder within the 'Service'-Folder which is the home for Factories. These factories create the service and inject dependencies into the constructor.

Note: Factories must have the same name as the service itself, but suffixed with the term 'Factory'.

Naming example: `RegistrationServiceFactory`

### Views

[](#views)

Views are highly flexible due to template inheritance. You can easily swap the parent layout within the content view. Just take a look at the files '/templates/layout.phtml' and '/templates/pages/index.phtml'. You may immediately understand what's going on.

Note: In 'app.conf.php' there is the template root path defined without a trailing slash. So whenever you reference a template you write it as it would be an absolute path beginning from that directory. IMHO it prevents confusion if you got a few more templates there.

Call example (within a controller): `$this->render('/path/to/template.phtml)`

### Routes

[](#routes)

The route structure is pretty straightforward. You define an array with the name of the route as the key. The value holds (next to the basic options like 'path' and 'action') multiple route specific options like i18n-Keys for automatic language specific link generation or role names to permit only logged in users access to that site. Just take a look at the file 'routes.conf.php'.

### ORM and Entities

[](#orm-and-entities)

The Faulancer Framework is based on a third party library from Thomas Flori for simple and fast yet powerful database operations. For further informations and documentation please navigate to [tflori/orm](https://github.com/tflori/orm).

###  Health Score

22

—

LowBetter than 23% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

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.

###  Release Activity

Cadence

Every ~44 days

Recently: every ~33 days

Total

14

Last Release

2832d ago

PHP version history (2 changes)0.1.0-alpha1PHP ^7.0

v0.3PHP ^7.1

### Community

Maintainers

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

---

Top Contributors

[![FloKnapp](https://avatars.githubusercontent.com/u/3774820?v=4)](https://github.com/FloKnapp "FloKnapp (255 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/floknapp-faulancer/health.svg)

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

PHPackages © 2026

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