PHPackages                             jeyson/mezzio-skeleton - 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. [HTTP & Networking](/categories/http)
4. /
5. jeyson/mezzio-skeleton

ActiveProject[HTTP & Networking](/categories/http)

jeyson/mezzio-skeleton
======================

Laminas mezzio skeleton. Begin developing PSR-15 middleware applications in seconds!

v1.0.0(4y ago)04BSD-3-ClausePHPPHP ^7.4 || ~8.0.0 || ~8.1.0

Since Feb 10Pushed 4y ago1 watchersCompare

[ Source](https://github.com/jeysonlr/mezzio-skeleton)[ Packagist](https://packagist.org/packages/jeyson/mezzio-skeleton)[ Docs](https://mezzio.dev)[ RSS](/packages/jeyson-mezzio-skeleton/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (15)Versions (2)Used By (0)

### Execute with docker

[](#execute-with-docker)

```
$ docker-compose up -d --build

# access container
$ docker exec -it skeleton bash

# install dependencies
$ composer install   or compose install --ignore-platform-reqs

# enable development-mode
$ composer-development-enable

```

### Acess aplication in [click here](http://localhost:8094)

[](#acess-aplication-in-click-here)

```
$ http://localhost:8094 or http://localhost:8094/api/ping

```

Mezzio Skeleton and Installer
=============================

[](#mezzio-skeleton-and-installer)

[![Build Status](https://github.com/mezzio/mezzio-skeleton/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/mezzio/mezzio-skeleton/actions/workflows/continuous-integration.yml)

*Begin developing PSR-15 middleware applications in seconds!*

[mezzio](https://github.com/mezzio/mezzio) builds on [laminas-stratigility](https://github.com/laminas/laminas-stratigility) to provide a minimalist PSR-15 middleware framework for PHP with routing, DI container, optional templating, and optional error handling capabilities.

This installer will setup a skeleton application based on mezzio by choosing optional packages based on user input as demonstrated in the following screenshot:

[![screenshot-installer](https://user-images.githubusercontent.com/1011217/90332191-55d32200-dfbb-11ea-80c0-27a07ef5691a.png)](https://user-images.githubusercontent.com/1011217/90332191-55d32200-dfbb-11ea-80c0-27a07ef5691a.png)

The user selected packages are saved into `composer.json` so that everyone else working on the project have the same packages installed. Configuration files and templates are prepared for first use. The installer command is removed from `composer.json` after setup succeeded, and all installer related files are removed.

Getting Started
---------------

[](#getting-started)

Start your new Mezzio project with composer:

```
$ composer create-project mezzio/mezzio-skeleton
```

After choosing and installing the packages you want, go to the `` and start PHP's built-in web server to verify installation:

```
$ composer run --timeout=0 serve
```

You can then browse to .

> ### Linux users
>
> [](#linux-users)
>
> On PHP versions prior to 7.1.14 and 7.2.2, this command might not work as expected due to a bug in PHP that only affects linux environments. In such scenarios, you will need to start the [built-in web server](http://php.net/manual/en/features.commandline.webserver.php) yourself, using the following command:
>
> ```
> $ php -S 0.0.0.0:8080 -t public/ public/index.php
> ```

> ### Setting a timeout
>
> [](#setting-a-timeout)
>
> Composer commands time out after 300 seconds (5 minutes). On Linux-based systems, the `php -S` command that `composer serve` spawns continues running as a background process, but on other systems halts when the timeout occurs.
>
> As such, we recommend running the `serve` script using a timeout. This can be done by using `composer run` to execute the `serve` script, with a `--timeout` option. When set to `0`, as in the previous example, no timeout will be used, and it will run until you cancel the process (usually via `Ctrl-C`). Alternately, you can specify a finite timeout; as an example, the following will extend the timeout to a full day:
>
> ```
> $ composer run --timeout=86400 serve
> ```

Installing alternative packages
-------------------------------

[](#installing-alternative-packages)

There is a feature to install alternative packages: Instead of entering one of the selection **you can actually type the package name and version**.

> ```
>   Which template engine do you want to use?
>   [1] Plates
>   [2] Twig
>   [3] zend-view installs zend-servicemanager
>   [n] None of the above
>   Make your selection or type a composer package name and version (n): infw/pug:0.1
>   - Searching for infw/pug:0.1
>   - Adding package infw/pug (0.1)
>
> ```

That feature allows you to install any alternative package you want. It has its limitations though:

- The alternative package must follow this format `namespace/package:1.0`. It needs the correct version.
- Templates are not copied, but the ConfigProvider can be configured in such way that it uses the default templates directly from the package itself.
- This doesn't work for containers as the container.php file needs to be copied.

Troubleshooting
---------------

[](#troubleshooting)

If the installer fails during the `composer create-project` phase, please go through the following list before opening a new issue. Most issues we have seen so far can be solved by `self-update` and `clear-cache`.

1. Be sure to work with the latest version of composer by running `composer self-update`.
2. Try clearing Composer's cache by running `composer clear-cache`.

If neither of the above help, you might face more serious issues:

- Info about the [zlib\_decode error](https://github.com/composer/composer/issues/4121).
- Info and solutions for [composer degraded mode](https://getcomposer.org/doc/articles/troubleshooting.md#degraded-mode).

Application Development Mode Tool
---------------------------------

[](#application-development-mode-tool)

This skeleton comes with [laminas-development-mode](https://github.com/laminas/laminas-development-mode). It provides a composer script to allow you to enable and disable development mode.

### To enable development mode

[](#to-enable-development-mode)

**Note:** Do NOT run development mode on your production server!

```
$ composer development-enable
```

**Note:** Enabling development mode will also clear your configuration cache, to allow safely updating dependencies and ensuring any new configuration is picked up by your application.

### To disable development mode

[](#to-disable-development-mode)

```
$ composer development-disable
```

### Development mode status

[](#development-mode-status)

```
$ composer development-status
```

Configuration caching
---------------------

[](#configuration-caching)

By default, the skeleton will create a configuration cache in `data/config-cache.php`. When in development mode, the configuration cache is disabled, and switching in and out of development mode will remove the configuration cache.

You may need to clear the configuration cache in production when deploying if you deploy to the same directory. You may do so using the following:

```
$ composer clear-config-cache
```

You may also change the location of the configuration cache itself by editing the `config/config.php` file and changing the `config_cache_path` entry of the local `$cacheConfig` variable.

Skeleton Development
--------------------

[](#skeleton-development)

This section applies only if you cloned this repo with `git clone`, not when you installed mezzio with `composer create-project ...`.

If you want to run tests against the installer, you need to clone this repo and setup all dependencies with composer. Make sure you **prevent composer running scripts** with `--no-scripts`, otherwise it will remove the installer and all tests.

```
$ composer update --no-scripts
$ composer test
```

Please note that the installer tests remove installed config files and templates before and after running the tests.

Before contributing read [the contributing guide](https://github.com/mezzio/.github/blob/master/CONTRIBUTING.md).

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

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

Unknown

Total

1

Last Release

1551d ago

### Community

Maintainers

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

---

Top Contributors

[![jeysonlr](https://avatars.githubusercontent.com/u/46712375?v=4)](https://github.com/jeysonlr "jeysonlr (1 commits)")

---

Tags

psrpsr-7middlewarePSR-11laminaspsr-15mezzioSkeleton

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jeyson-mezzio-skeleton/health.svg)

```
[![Health](https://phpackages.com/badges/jeyson-mezzio-skeleton/health.svg)](https://phpackages.com/packages/jeyson-mezzio-skeleton)
```

###  Alternatives

[mezzio/mezzio-skeleton

Laminas mezzio skeleton. Begin developing PSR-15 middleware applications in seconds!

12726.2k](/packages/mezzio-mezzio-skeleton)[mezzio/mezzio

PSR-15 Middleware Microframework

3883.6M97](/packages/mezzio-mezzio)[mezzio/mezzio-tooling

Migration and development tooling for Mezzio

191.1M21](/packages/mezzio-mezzio-tooling)[mezzio/mezzio-fastroute

FastRoute integration for Mezzio

162.7M52](/packages/mezzio-mezzio-fastroute)[mezzio/mezzio-router

Router subcomponent for Mezzio

265.0M61](/packages/mezzio-mezzio-router)[mezzio/mezzio-helpers

Helper/Utility classes for Mezzio

134.3M67](/packages/mezzio-mezzio-helpers)

PHPackages © 2026

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