PHPackages                             gammamatrix/playground-directory - 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. [Database &amp; ORM](/categories/database)
4. /
5. gammamatrix/playground-directory

ActiveLibrary[Database &amp; ORM](/categories/database)

gammamatrix/playground-directory
================================

Playground: Provide the Directory models for the Playground Directory System.

026PHPCI passing

Since Sep 21Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/gammamatrix/playground-directory)[ Packagist](https://packagist.org/packages/gammamatrix/playground-directory)[ RSS](/packages/gammamatrix-playground-directory/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Playground: Directory
=====================

[](#playground-directory)

[![Playground CI Workflow](https://github.com/gammamatrix/playground-directory/actions/workflows/ci.yml/badge.svg?branch=develop)](https://raw.githubusercontent.com/gammamatrix/playground-directory/testing/develop/testdox.txt)[![Test Coverage](https://raw.githubusercontent.com/gammamatrix/playground-directory/testing/develop/coverage.svg)](tests)[![PHPStan Level 10](https://camo.githubusercontent.com/022b70e6631d055205dfebf2aa7e53b3f63e7a3ea04a18e86429f279e29a29f1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c25323031302d627269676874677265656e)](.github/workflows/ci.yml#L128)

The Playground Directory is a package for [Laravel](https://laravel.com/docs/12.x) applications.

Playground: Provide the Directory models for the Playground Directory System.

Read more on using [Playground: Directory at Read the Docs](https://gammamatrix-playground.readthedocs.io/en/develop/built-components/directory.html)

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

[](#installation)

**NOTE:** This package is required by:

- [Playground: Directory API](https://github.com/gammamatrix/playground-directory-api): API without UI
- [Playground: Directory Resource](https://github.com/gammamatrix/playground-directory-resource): API with UI

Install this package, with composer, to get access to the Directory Models:

```
composer require gammamatrix/playground-directory
```

`artisan:about`
---------------

[](#artisanabout)

Playground Directory provides information in the `artisan about` command.

Configuration
-------------

[](#configuration)

Migrations are disabled by default. This package may sometimes be installed where another system handles the migrations.

See the contents of the published config file: [config/playground-directory.php](config/playground-directory.php)

You can publish the config file with:

```
php artisan vendor:publish --provider="Playground\Directory\ServiceProvider" --tag="playground-config"
```

### Environment Variables

[](#environment-variables)

env()config()Default`PLAYGROUND_DIRECTORY_ABOUT``playground-directory.about``true``PLAYGROUND_DIRECTORY_LOAD_MIGRATIONS``playground-directory.load.migrations``false`- The loading option for migrations does not take effect if the migrations have been exported to your app. The control for loading is handled in the package [ServiceProvider.](src/ServiceProvider.php)

Models
------

[](#models)

This package includes [factories](database/factories), models and [migrations](database/migrations) for:

- [Location](src/Models/Location.php)
- [LocationRevision](src/Models/LocationRevision.php)
- [Sublocation](src/Models/Sublocation.php)
- [SublocationRevision](src/Models/SublocationRevision.php)

Migrations
----------

[](#migrations)

All migrations are disabled by default.

See the contents of the published config file: [database/migrations](database/migrations)

- NOTE: There are 4 tables that will be created, they do have indexes and unique constraints defined; however, this release does not have the foreign key constraint migrations included at this time.

You can publish the migrations file with:

```
php artisan vendor:publish --provider="Playground\Directory\ServiceProvider" --tag="playground-migrations"
```

Cloc
----

[](#cloc)

```
composer cloc
```

```
➜  playground-directory git:(develop) ✗ composer cloc
      77 text files.
      72 unique files.
       6 files ignored.

github.com/AlDanial/cloc v 2.06  T=0.04 s (2005.9 files/s, 441010.1 lines/s)
-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
JSON                            29              0              0          11866
PHP                             28            320            742           2130
XML                             10              0              7            304
YAML                             1              5              0            275
Markdown                         3             46              0            120
INI                              1              3              0             12
-------------------------------------------------------------------------------
SUM:                            72            374            749          14707
-------------------------------------------------------------------------------

```

PHPStan
-------

[](#phpstan)

Tests at level 10 on:

- `config/`
- `database/`
- `src/`
- `tests/Feature/`
- `tests/Unit/`

```
composer analyse
```

Coding Standards
----------------

[](#coding-standards)

```
composer format
```

Testing
-------

[](#testing)

Unit tests

```
composer test
```

Unit and feature tests

```
composer test-dev
```

Run unit and feature tests in parallel:

```
composer test-parallel
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Credits
-------

[](#credits)

- [Jeremy Postlethwaite](https://github.com/gammamatrix)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance44

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community7

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://www.gravatar.com/avatar/a309c28cee3aff88250942e5bc4d01f2d5a53f8b52456f6352adc338dc9a121b?d=identicon)[gammamatrix](/maintainers/gammamatrix)

---

Top Contributors

[![gammamatrix](https://avatars.githubusercontent.com/u/524724?v=4)](https://github.com/gammamatrix "gammamatrix (15 commits)")

### Embed Badge

![Health badge](/badges/gammamatrix-playground-directory/health.svg)

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

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.3k](/packages/illuminate-database)[mongodb/mongodb

MongoDB driver library

1.6k64.0M545](/packages/mongodb-mongodb)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)

PHPackages © 2026

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