PHPackages                             thbighead/wordless-framework - 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. thbighead/wordless-framework

ActiveLibrary[Framework](/categories/framework)

thbighead/wordless-framework
============================

Wordless Framework.

v8.46.1(5mo ago)53591MITPHPPHP ^8.2

Since Oct 4Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/thbighead/wordless-framework)[ Packagist](https://packagist.org/packages/thbighead/wordless-framework)[ RSS](/packages/thbighead-wordless-framework/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (23)Versions (389)Used By (1)

Wordless Framework
==================

[](#wordless-framework)

The [Wordless](https://github.com/thbighead/Wordless) project framework.

Directory and files organization
--------------------------------

[](#directory-and-files-organization)

### Main directories and files

[](#main-directories-and-files)

```
| assets (Publishable directories)
| \
|  | config (Keep base configuration files)
|  | stubs (Keep files stubs to generate new ones)
| docker (Local development environment containers to work with framework changes)
| logs (Local development environment log files)
| src
| \
|  | Application (Classes implementation, just like in project app directory)
|  | \
|  |  | Cachers (Classes to keep internal caches)
|  |  | Commands (Wordless CLI commands. Make new as you wish, customize carefully)
|  |  | Guessers (Classes to guess values)
|  |  | Helpers (Keep helper classes)
|  |  | Libraries (Library directories with useful abstractions)
|  |  | Listeners (Keep listener classes for Wordpress hooks (Events))
|  |  | Mounters (Class implementations which mount files with dynamic contents from stubs)
|  |  | Providers (Classes which register any Application class as a group)
|  | Core (Core Wordless classes, they raise all framework functionalities)
|  | Infrastructure (Abstract classes used by Application and Wordpress)
|  | Wordpress (Wordpress adapted class abstractions)
|  |>ide_helper.php (File to help IDEs helping the developers using or improving this framework)
| tests (Automated tests)
| \
|  | coverage (files with test coverage results in any format)
|  | Unit (Class methods unitary tests)
|>composer.json (Composer)
|>console (Wordless CLI file)
|>docker-compose.yml (Docker Compose configurations for local environment to work with framework changes)
|>env.php (Adapted file to load environment variables needed when changing Frameworn into local development environment)
|>phpunit.xml (PHP Unit configuration)
|>wp-cli.yml (WP CLI configuration)
|>wp-config.php (Adapted Wordpress configuration for Framework local development environment)

```

### Relative directories

[](#relative-directories)

Inside any [main directory](#main-directories-and-files) we may have the following directories:

```
| Contracts (Useful Interfaces or abstract classes with abstract methods)
| DTO (Useful DTO implementations to avoid complex array data configuration)
| Enums (Useful Enums to avoid magic values)
| Exceptions (Keeps custom Exceptions. Better then if-else)
| Traits (Traits used to group methods, properties and constants in a scope or to be used in more than one specialized class.)

```

Docker
------

[](#docker)

To provide a development environment, Wordless Framework offers the following containers:

### Workspace

[](#workspace)

This is the main container, where you can access PHP, Composer, NPM and the Wordless CLI console. Generally, this is where you will interact with your application most of the time. To access it follow the [access guide](#accessing-containers) after you have [started the containers](#starting-containers).

### MariaDB

[](#mariadb)

This container is responsible for creating and managing your database.

### Adminer

[](#adminer)

Adminer is a container that allows database interactions through the browser, providing an interface to perform various tasks necessary for database-related development. Access it via `localhost:8081` with your browser.

### Commands

[](#commands)

#### Starting containers

[](#starting-containers)

To start the containers, use the `up` command, which will initiate each container. If the containers haven't been created, this command will also build them.

> The `-d` flag allows you to execute this command in non-verbose mode. In other words, you won't receive the outputs of your containers, leaving the terminal free for other tasks.
>
> ```
> docker compose up -d
> ```

#### Accessing containers

[](#accessing-containers)

Once the containers are created and started, you can navigate inside them using the `exec` command. Inside each container, you can leverage all its specific functionalities characteristic of each container. Specify which container to execute; in this case, we are executing the workspace.

> The `--user` flag indicates the user for logging into the container. Usually, `laradock` is the default, but in some cases where a profile with greater responsibility is needed, you can use `root` by just don't using this flag.
>
> ```
> docker compose exec --user=laradock workspace bash
> docker compose exec workspace bash # as root
> ```

Exception codes
---------------

[](#exception-codes)

Our Exception classes uses standardized codes to give information about the raised problem. The meaning of them is as follows:

1. *Caught internally*: those exceptions should never interrupt application because they are (or should be) always caught by the framework itself everytime it would be thrown;
2. *Development error*: it's a kind of exception that should only interrupt application when a develop mistake occurs;
3. *Logic control*: it controls any application logic. It may be wrapped by a try-catch code or not depending on what developers expect;
4. *Intentional interrupt*: should never be caught, those exceptions are made to ALWAYS interrupt application.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance81

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 91.3% 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 ~4 days

Recently: every ~23 days

Total

371

Last Release

150d ago

Major Versions

v2.0.0 → v3.0.02022-07-20

v3.4.3 → v4.0.02022-09-01

v4.1.0 → v5.0.02022-10-03

v5.0.8 → v6.0.02022-11-30

v6.1.4 → v8.0.02024-03-27

PHP version history (2 changes)v0.1.0PHP ^7.4

v8.0.0PHP ^8.2

### Community

Maintainers

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

---

Top Contributors

[![thales-infobase](https://avatars.githubusercontent.com/u/108365651?v=4)](https://github.com/thales-infobase "thales-infobase (2132 commits)")[![mex3890](https://avatars.githubusercontent.com/u/90221921?v=4)](https://github.com/mex3890 "mex3890 (123 commits)")[![thbighead](https://avatars.githubusercontent.com/u/8725866?v=4)](https://github.com/thbighead "thbighead (77 commits)")[![fabiobap](https://avatars.githubusercontent.com/u/24209013?v=4)](https://github.com/fabiobap "fabiobap (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thbighead-wordless-framework/health.svg)

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

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