PHPackages                             toporia/toporia - 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. toporia/toporia

ActiveProject[Framework](/categories/framework)

toporia/toporia
===============

Toporia - A modern PHP application skeleton built with Clean Architecture

00PHP

Since Dec 18Pushed 6mo agoCompare

[ Source](https://github.com/Minhphung7820/toporia-toporia)[ Packagist](https://packagist.org/packages/toporia/toporia)[ RSS](/packages/toporia-toporia/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Toporia
=======

[](#toporia)

A modern PHP application skeleton built with Clean Architecture principles.

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

[](#requirements)

- **PHP**: >= 8.1
- **Composer**: For dependency management

Installation
------------

[](#installation)

### Via Composer Create-Project (Recommended)

[](#via-composer-create-project-recommended)

```
composer create-project toporia/toporia my-app
cd my-app
```

### Via Git Clone

[](#via-git-clone)

```
git clone https://github.com/Minhphung7820/toporia-toporia.git my-app
cd my-app
composer install
cp .env.example .env
php console key:generate
```

### Docker Setup

[](#docker-setup)

```
make up           # Start services (app, nginx, mysql, redis)
make setup        # Install dependencies and run migrations
make shell        # Access PHP container
```

Project Structure
-----------------

[](#project-structure)

```
app/
├── Domain/              # Pure business entities and repository interfaces
├── Application/         # Use cases, services, handlers
├── Infrastructure/      # Repository implementations, external services
└── Presentation/        # Controllers, Middleware, Views

bootstrap/               # Application bootstrap
config/                  # Configuration files
database/
├── migrations/          # Database migrations
├── factories/           # Model factories
└── seeders/             # Database seeders
public/                  # Public assets and entry point
resources/
├── js/                  # Frontend JavaScript (Vue.js)
├── lang/                # Language files
└── views/               # View templates
routes/                  # Route definitions
storage/                 # Logs, cache, uploads
tests/                   # Test suites

```

Quick Start
-----------

[](#quick-start)

### Start Development Server

[](#start-development-server)

```
php -S localhost:8000 -t public
```

### Run Migrations

[](#run-migrations)

```
php console migrate
```

### Create a Controller

[](#create-a-controller)

```
php console make:controller UserController
```

### Create a Model

[](#create-a-model)

```
php console make:model User
```

### Run Tests

[](#run-tests)

```
composer test
```

Optional Packages
-----------------

[](#optional-packages)

Install additional features as needed:

```
# Role & Permission Management
composer require toporia/dominion

# OAuth Authentication (Google, Facebook, GitHub, etc.)
composer require toporia/socialite

# Webhook Handling
composer require toporia/webhook

# MongoDB Support
composer require toporia/mongodb

# Audit Logging
composer require toporia/audit

# Multi-tenancy
composer require toporia/tenancy

# API Versioning
composer require toporia/api-versioning
```

All packages support **auto-discovery** - providers and configs are registered automatically.

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

[](#documentation)

See the [docs/](docs/) directory for detailed documentation on:

- Architecture patterns
- ORM and relationships
- Queue and jobs
- Authentication
- And more...

License
-------

[](#license)

MIT License

###  Health Score

16

—

LowBetter than 4% of packages

Maintenance46

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

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://avatars.githubusercontent.com/u/110077842?v=4)[Minhphung7820](/maintainers/Minhphung7820)[@Minhphung7820](https://github.com/Minhphung7820)

---

Top Contributors

[![Minhphung7820](https://avatars.githubusercontent.com/u/110077842?v=4)](https://github.com/Minhphung7820 "Minhphung7820 (13 commits)")

### Embed Badge

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

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

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M299](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

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