PHPackages                             afinogen/laminas-mvc-starter-kit - 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. [Framework](/categories/framework)
4. /
5. afinogen/laminas-mvc-starter-kit

ActiveProject[Framework](/categories/framework)

afinogen/laminas-mvc-starter-kit
================================

Laminas MVC Starter kit

1.0.0(5y ago)013BSD-3-ClausePHPPHP ^7.3

Since Jul 22Pushed 5y agoCompare

[ Source](https://github.com/Afinogen/laminas-mvc-starter-kit)[ Packagist](https://packagist.org/packages/afinogen/laminas-mvc-starter-kit)[ RSS](/packages/afinogen-laminas-mvc-starter-kit/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (21)Versions (3)Used By (0)

laminas-mvc-starter-kit
=======================

[](#laminas-mvc-starter-kit)

Introduction
------------

[](#introduction)

This is a skeleton application using the Laminas MVC layer and module systems. This application is meant to be used as a starting place for those looking to get their feet wet with Laminas MVC.

**This is my vision of the application skeleton. Use as is**

Installation using Composer
---------------------------

[](#installation-using-composer)

The easiest way to create a new Laminas MVC project is to use [Composer](https://getcomposer.org/). If you don't have it already installed, then please install as per the [documentation](https://getcomposer.org/doc/00-intro.md).

To create your new Laminas MVC project:

```
$ composer create-project -sdev afinogen/laminas-mvc-starter-kit path/to/install
```

Once installed, you can test it out immediately using PHP's built-in web server:

```
$ cd path/to/install
$ php -S 0.0.0.0:8080 -t public
# OR use the composer alias:
$ composer run --timeout 0 serve
```

This will start the cli-server on port 8080, and bind it to all network interfaces. You can then visit the site at

- which will bring up Laminas MVC Skeleton welcome page.

**Note:** The built-in CLI server is *for development only*.

Development mode
----------------

[](#development-mode)

The skeleton ships with [laminas-development-mode](https://github.com/laminas/laminas-development-mode)by default, and provides three aliases for consuming the script it ships with:

```
$ composer development-enable  # enable development mode
$ composer development-disable # disable development mode
$ composer development-status  # whether or not development mode is enabled
```

You may provide development-only modules and bootstrap-level configuration in `config/development.config.php.dist`, and development-only application configuration in `config/autoload/development.local.php.dist`. Enabling development mode will copy these files to versions removing the `.dist` suffix, while disabling development mode will remove those copies.

Development mode is automatically enabled as part of the skeleton installation process. After making changes to one of the above-mentioned `.dist` configuration files you will either need to disable then enable development mode for the changes to take effect, or manually make matching updates to the `.dist`-less copies of those files.

Modules used
------------

[](#modules-used)

laminas/laminas-db - connect to DB
laminas/laminas-mvc-form - use forms
laminas/laminas-session - use session for save auth user
symfony/console - run console commands
robmorgan/phinx - db migration
vlucas/phpdotenv - use .env files
tekill/env-diff - diff .env and .env.dist files laminas/laminas-authentication - auth user
laminas/laminas-permissions-acl - user roles

Running Unit Tests
------------------

[](#running-unit-tests)

To run the supplied skeleton unit tests, you need to do one of the following:

- During initial project creation, select to install the MVC testing support.
- After initial project creation, install [laminas-test](https://docs.laminas.dev/laminas-test/):

    ```
    $ composer require --dev laminas/laminas-test
    ```

Once testing support is present, you can run the tests using:

```
$ ./vendor/bin/phpunit
```

If you need to make local modifications for the PHPUnit test setup, copy `phpunit.xml.dist` to `phpunit.xml` and edit the new file; the latter has precedence over the former when running tests, and is ignored by version control. (If you want to make the modifications permanent, edit the `phpunit.xml.dist` file.)

Using docker-compose
--------------------

[](#using-docker-compose)

This skeleton provides a `docker-compose.yml` for use with [docker-compose](https://docs.docker.com/compose/).

Docker-compose.yml included services:

- nginx - is an HTTP and reverse proxy server
- laminas - application skeleton
- mysql - db
- phpmyadmin - manager mysql db
- mailhog - mail catcher

The configuration is located at folder docker/ .

Build and start the image and container using:

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

At this point, you can visit  to see the site running.

You can also run commands such as `composer` in the container. The container environment is named "laminas" so you will pass that value to `docker-compose run`:

```
$ docker-compose run laminas composer install
```

Some composer packages may need additional PHP extensions. The Dockerfile contains several examples of commented out commands that add some of the more popular php extensions. For example, to install `intl` support uncomment the lines

```
# RUN apt-get install --yes libicu-dev
# RUN docker-php-ext-configure intl
# RUN docker-php-ext-install intl
```

then re-run the `docker-compose up -d --build` line as above.

Web server setup
----------------

[](#web-server-setup)

### Apache setup

[](#apache-setup)

To setup apache, setup a virtual host to point to the public/ directory of the project and you should be ready to go! It should look something like below:

```

    ServerName laminasapp.localhost
    DocumentRoot /path/to/laminasapp/public

        DirectoryIndex index.php
        AllowOverride All
        Order allow,deny
        Allow from all

        Require all granted

```

### Nginx setup

[](#nginx-setup)

To setup nginx, open your `/path/to/nginx/nginx.conf` and add an [include directive](http://nginx.org/en/docs/ngx_core_module.html#include) below into `http` block if it does not already exist:

```
http {
    # ...
    include sites-enabled/*.conf;
}
```

Create a virtual host configuration file for your project under `/path/to/nginx/sites-enabled/laminasapp.localhost.conf`it should look something like below:

```
server {
    listen       80;
    server_name  laminasapp.localhost;
    root         /path/to/laminasapp/public;

    location / {
        index index.php;
        try_files $uri $uri/ @php;
    }

    location @php {
        # Pass the PHP requests to FastCGI server (php-fpm) on 127.0.0.1:9000
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_param  SCRIPT_FILENAME /path/to/laminasapp/public/index.php;
        include fastcgi_params;
    }
}
```

Restart the nginx, now you should be ready to go!

QA Tools
--------

[](#qa-tools)

The skeleton does not come with any QA tooling by default, but does ship with configuration for each of:

- [phpcs](https://github.com/squizlabs/php_codesniffer)
- [phpunit](https://phpunit.de)

Additionally, it comes with some basic tests for the shipped `Application\Controller\IndexController`.

If you want to add these QA tools, execute the following:

```
$ composer require --dev phpunit/phpunit squizlabs/php_codesniffer laminas/laminas-test
```

We provide aliases for each of these tools in the Composer configuration:

```
# Run CS checks:
$ composer cs-check
# Fix CS errors:
$ composer cs-fix
# Run PHPUnit tests:
$ composer test
```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

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

2120d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4a856f992e632236d6a7f362a3f182d099d0a3fec56a233e2ec88117da724512?d=identicon)[Afinogen89](/maintainers/Afinogen89)

---

Tags

frameworklaminasmvcSkeleton

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/afinogen-laminas-mvc-starter-kit/health.svg)

```
[![Health](https://phpackages.com/badges/afinogen-laminas-mvc-starter-kit/health.svg)](https://phpackages.com/packages/afinogen-laminas-mvc-starter-kit)
```

###  Alternatives

[laminas/laminas-mvc-skeleton

Laminas MVC Skeleton Application

18088.0k](/packages/laminas-laminas-mvc-skeleton)

PHPackages © 2026

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