PHPackages                             mrhdolek/php-vanilla-boilerplate - 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. [DevOps &amp; Deployment](/categories/devops)
4. /
5. mrhdolek/php-vanilla-boilerplate

ActiveProject[DevOps &amp; Deployment](/categories/devops)

mrhdolek/php-vanilla-boilerplate
================================

php-vanilla-boilerplate

20[1 issues](https://github.com/MrHDOLEK/php-vanilla-boilerplate/issues)[1 PRs](https://github.com/MrHDOLEK/php-vanilla-boilerplate/pulls)NixCI passing

Since Oct 30Pushed 1mo agoCompare

[ Source](https://github.com/MrHDOLEK/php-vanilla-boilerplate)[ Packagist](https://packagist.org/packages/mrhdolek/php-vanilla-boilerplate)[ RSS](/packages/mrhdolek-php-vanilla-boilerplate/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

PHP Vanilla Boilerplate
=======================

[](#php-vanilla-boilerplate)

[![PHP](https://camo.githubusercontent.com/bd33b80293f98e14a0999785ced4bb282e8a17bd8045a9de1038ada6f13e3506/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342d3737374242343f7374796c653d666c6174266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/bd33b80293f98e14a0999785ced4bb282e8a17bd8045a9de1038ada6f13e3506/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342d3737374242343f7374796c653d666c6174266c6f676f3d706870266c6f676f436f6c6f723d7768697465)[![License](https://camo.githubusercontent.com/263c32340fd391444f6ebe69fe55b8bc166e75b41309d5a5869c946dda95a1d3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d7268646f6c656b2f7068702d76616e696c6c612d626f696c6572706c6174653f636f6c6f723d343238663765266c6f676f3d6f70656e253230736f75726365253230696e6974696174697665266c6f676f436f6c6f723d7768697465)](https://github.com/your-username/php-vanilla-boilerplate/blob/master/LICENSE)

---

#### A simple PHP Vanilla Boilerplate for modern web development

[](#a-simple-php-vanilla-boilerplate-for-modern-web-development)

Clean, simple, and modern PHP boilerplate with Docker support, testing, and development tools.

Project setup
-------------

[](#project-setup)

You can run this project using either **Docker** (via Make commands) or **Nix**. Choose the option that best fits your workflow.

🐳 Docker Environment
--------------------

[](#-docker-environment)

### Prerequisites

[](#prerequisites)

- Docker and Docker Compose
- Make (for Windows: install from [here](http://gnuwin32.sourceforge.net/packages/make.htm))

### Setup and Usage

[](#setup-and-usage)

#### Development

[](#development)

If you have problems with permissions please add sudo before make example:

- `sudo make install`
- `sudo make start`

#### Mac/Linux

[](#maclinux)

```
make install
make start
```

#### Windows

[](#windows)

```
make install
make start
```

#### Address where the environment is available

[](#address-where-the-environment-is-available)

- `http://localhost:8000`

#### All Docker commands

[](#all-docker-commands)

- `make help` - Show all available commands

❄️ Nix Environment
------------------

[](#️-nix-environment)

### Prerequisites

[](#prerequisites-1)

- [Nix package manager](https://nixos.org/download.html)

### Setup and Usage

[](#setup-and-usage-1)

#### Enter development environment

[](#enter-development-environment)

```
# Enter the Nix shell (automatically installs all dependencies)
nix-shell
```

#### Development workflow with Nix

[](#development-workflow-with-nix)

```
# Enter Nix shell
nix-shell

# Check PHP version and path
type php
php --version

# Install PHP dependencies
composer install

# Start development server
php -S localhost:8000 -t public/

# Run tests
composer test

# Code quality checks
composer phpstan
composer cs-fix
```

All commands
------------

[](#all-commands)

- `make help`

### Running tests

[](#running-tests)

```
# Run all tests
composer test
```

### Code quality tools

[](#code-quality-tools)

The boilerplate includes several code quality tools:

- **PHPStan** - Static analysis tool
- **PHP-CS-Fixer** - Code style fixer
- **PHPUnit** - Testing framework

### Running development server

[](#running-development-server)

```
# Using PHP built-in server
php -S localhost:8000 -t public/
```

### Dependency management

[](#dependency-management)

```
# Install dependencies
composer install

# Update dependencies
composer update

# Add new dependency
composer require vendor/package

# Add development dependency
composer require --dev vendor/package
```

Documentation
-------------

[](#documentation)

Learn more about the tools used in this boilerplate:

- [PHP Official Documentation](https://www.php.net/docs.php)
- [Composer](https://getcomposer.org/doc/)
- [PHPUnit](https://phpunit.de/documentation.html)
- [PHPStan](https://phpstan.org/user-guide/getting-started)
- [Docker](https://docs.docker.com/)
- [PHP-CS-Fixer](https://cs.symfony.com/)

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance51

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 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/ea66aa634465dd5f5208dc9de30ff4207f1952da8dc109406279ef89e700f84b?d=identicon)[MrHDOLEK](/maintainers/MrHDOLEK)

---

Top Contributors

[![MrHDOLEK](https://avatars.githubusercontent.com/u/27227621?v=4)](https://github.com/MrHDOLEK "MrHDOLEK (3 commits)")

---

Tags

composerdockernixnixosphpvanilla-php

### Embed Badge

![Health badge](/badges/mrhdolek-php-vanilla-boilerplate/health.svg)

```
[![Health](https://phpackages.com/badges/mrhdolek-php-vanilla-boilerplate/health.svg)](https://phpackages.com/packages/mrhdolek-php-vanilla-boilerplate)
```

###  Alternatives

[deployer/deployer

Deployment Tool

11.0k25.4M207](/packages/deployer-deployer)[appwrite/server-ce

End to end backend server for frontend and mobile apps.

55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health

Laravel Server &amp; App Health Monitor and Notifier

2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[heroku/heroku-buildpack-php

Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku

8161.3M10](/packages/heroku-heroku-buildpack-php)[tiamo/phpas2

PHPAS2 is a php-based implementation of the EDIINT AS2 standard

4674.7k](/packages/tiamo-phpas2)

PHPackages © 2026

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