PHPackages                             daranger/php-starter - 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. daranger/php-starter

ActiveProject[Framework](/categories/framework)

daranger/php-starter
====================

A modern PHP starter kit with MVC.

v1.0.26(1mo ago)271MITPHPPHP &gt;=8.1CI passing

Since Jul 2Pushed 1mo agoCompare

[ Source](https://github.com/daranger/php-starter)[ Packagist](https://packagist.org/packages/daranger/php-starter)[ Docs](https://github.com/daranger/php-starter)[ RSS](/packages/daranger-php-starter/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (15)Versions (28)Used By (0)

PHP Starter Framework
=====================

[](#php-starter-framework)

A modern, lightweight PHP starter kit and micro-framework with a built-in admin panel, MVC architecture, and Docker support. Designed as a robust foundation for building secure and scalable web applications without the overhead of heavy frameworks.

[![Dashboard](public/assets/sc/1.png)](public/assets/sc/1.png)

[![Admin Settings](public/assets/sc/2.png)](public/assets/sc/2.png)

[![User Management](public/assets/sc/3.png)](public/assets/sc/3.png)

[![Login / 2FA](public/assets/sc/4.png)](public/assets/sc/4.png)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a992a385d6292ccd443721cd9af1a021d8760fda0b6ba69078d723c8f9f4f4a8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646172616e6765722f7068702d737461727465722e7376673f7374796c653d737175617265)](https://packagist.org/packages/daranger/php-starter)[![Total Downloads](https://camo.githubusercontent.com/038e569f67c5d65277324aabce1e70ea482c71392e71ecea058df7feeb30bccf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646172616e6765722f7068702d737461727465722e7376673f7374796c653d737175617265)](https://packagist.org/packages/daranger/php-starter)[![GitHub Tests](https://github.com/daranger/php-starter/actions/workflows/ci.yml/badge.svg)](https://github.com/daranger/php-starter/actions)[![PHP](https://camo.githubusercontent.com/189cb4b083328dcccac0c8c43be5004a1f4287761827ffdb3b143d5c3a212e1c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d626c75653f7374796c653d737175617265)](https://camo.githubusercontent.com/189cb4b083328dcccac0c8c43be5004a1f4287761827ffdb3b143d5c3a212e1c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d626c75653f7374796c653d737175617265)[![License](https://camo.githubusercontent.com/2e4a8a89cf342c968aea3b548ba28ee0a0eb873b72766933a3305482264f8e6b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f646172616e6765722f7068702d737461727465722e7376673f7374796c653d737175617265)](https://packagist.org/packages/daranger/php-starter)

---

Core Features &amp; Architecture
--------------------------------

[](#core-features--architecture)

### 🛠️ Custom MVC Micro-framework

[](#️-custom-mvc-micro-framework)

Built from scratch with zero heavy dependencies to keep the application blazing fast:

- **Routing Engine** — Supports GET, POST, route groups, prefixes, and parameter extraction.
- **Dependency Injection Container** — Intelligent container featuring **autowiring via Reflection**. Resolves dependencies recursively and supports singletons (`getInstance()->bind(...)`).
- **Middleware Pipeline** — Clean request filtering before hitting controllers. Includes built-in `AuthMiddleware`, `AdminMiddleware` (with dynamic IP whitelisting), and `CsrfMiddleware`.

### 🛡️ Security &amp; Authentication

[](#️-security--authentication)

- **Secure Sessions** — Stored in Redis with automatic TTL for performance and security.
- **CSRF Protection** — Integrated middleware automatically generates and validates `_csrf` tokens on every POST request.
- **Authentication** — Bcrypt hashed passwords, rate-limiting against brute force, and ready-to-use 2FA logic.
- **Role-based Access Control (RBAC)** — Distinct permissions for regular users and administrators.

### 🌐 Localization (i18n)

[](#-localization-i18n)

- **Built-in Translation System** — A robust helper `__('key')` maps dictionary files from the `lang/` directory to strings in the current user's locale.
- **Session &amp; DB tied** — Language preferences persist across sessions.

### 🎨 Themes &amp; UI

[](#-themes--ui)

- **Dark &amp; Light Modes** — Native support for theme switching out of the box.
- **Dynamic Settings** — App name, mail host, UI settings are driven by the `settings` database table, configurable directly from the Admin Panel instead of hardcoded `.env` files.

### 📋 Logging &amp; Telemetry

[](#-logging--telemetry)

- **Database &amp; File Logging** — User actions (`user_logs`) and daemon background jobs (`daemon_jobs_log`) are tracked.
- **System Dashboard** — Built-in `SystemService` that tracks server metrics (RAM, Disk, CPU Load Average, Uptime) and outputs them to the admin dashboard.

### 🐳 Docker Ready

[](#-docker-ready)

- Comes with a complete `docker-compose.yml` for instant local development.
- Bundles Nginx, PHP-FPM 8.2, MySQL 8.0, and Redis 7.2.

---

Stack
-----

[](#stack)

LayerTechnologyLanguagePHP 8.1+Web serverNginx (via Docker) / ApacheDatabaseMySQL 8.0 / MariaDBCache / SessionsRedis (Predis)MailPHPMailerFrameworkCustom MVC (Container, Router, Middleware)TestsPHPUnit 11---

Requirements
------------

[](#requirements)

- PHP 8.1+ (if running bare-metal)
- Composer
- MySQL 8.0+ or MariaDB
- Redis server
- **Or simply Docker &amp; Docker Compose** for local development.

---

Installation via Composer
-------------------------

[](#installation-via-composer)

The easiest way to start a new project is via Composer:

```
composer create-project daranger/php-starter my-new-app
cd my-new-app
```

Composer will automatically clone the repository, remove the git history, and install all dependencies.

---

Installation via Docker (Alternative)
-------------------------------------

[](#installation-via-docker-alternative)

1. **Clone the repository**

    ```
    git clone https://github.com/daranger/php-starter.git
    cd php-starter
    ```
2. **Setup environment**

    ```
    cp .env.example .env
    # Edit .env to set your database credentials if needed
    ```
3. **Start the containers**

    ```
    docker-compose up -d
    ```
4. **Install PHP dependencies**

    ```
    docker-compose exec app composer install
    ```
5. **Run migrations &amp; seed**

    ```
    # Make sure to run your database migrations/seeds here
    # e.g., import database/Migrations/*.sql
    ```
6. **Access the application**Open your browser and navigate to `http://localhost`.

---

Testing
-------

[](#testing)

The framework includes a comprehensive test suite powered by PHPUnit.

```
composer dump-autoload
vendor/bin/phpunit
```

---

License
-------

[](#license)

This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance91

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

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 ~0 days

Total

27

Last Release

41d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6069061?v=4)[Web Developer](/maintainers/daranger)[@daranger](https://github.com/daranger)

---

Top Contributors

[![daranger](https://avatars.githubusercontent.com/u/6069061?v=4)](https://github.com/daranger "daranger (40 commits)")

---

Tags

phpframework2famvcboilerplatestarter-kitadmin-panel

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/daranger-php-starter/health.svg)

```
[![Health](https://phpackages.com/badges/daranger-php-starter/health.svg)](https://phpackages.com/packages/daranger-php-starter)
```

###  Alternatives

[leantime/leantime

Open source project management system for non-project managers. Simple like Trello, powerful like Jira. Built with neurodiversity in mind.

11.3k4.0k](/packages/leantime-leantime)[unopim/unopim

UnoPim Laravel PIM

10.8k2.5k](/packages/unopim-unopim)[doppar/framework

The Doppar Framework

4112.6k14](/packages/doppar-framework)[abydahana/aksara

Aksara is a modern, developer-friendly framework and CMS built on CodeIgniter 4, featuring rapid CRUD development, modular architecture, smart routing, flexible access control, API integration, and an AI assistant to make content management faster and smarter.

1141.2k](/packages/abydahana-aksara)[sproutcms/cms

Enterprise content management and framework

243.0k4](/packages/sproutcms-cms)

PHPackages © 2026

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