PHPackages                             samrap/gestalt - 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. samrap/gestalt

ActiveLibrary

samrap/gestalt
==============

Gestalt is a simple, elegant PHP package for managing your framework's configuration values.

v0.3.1(9y ago)163.6k↓100%2[2 issues](https://github.com/samrap/gestalt/issues)1MITPHPPHP >=5.6

Since Sep 3Pushed 9y ago3 watchersCompare

[ Source](https://github.com/samrap/gestalt)[ Packagist](https://packagist.org/packages/samrap/gestalt)[ RSS](/packages/samrap-gestalt/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (6)Dependencies (2)Versions (9)Used By (1)

Gestalt
=======

[](#gestalt)

[![StyleCI](https://camo.githubusercontent.com/e15927b9d9e4489e9bb46355ab7ccaaebc6fed27ead43f808bf8c33c31e24974/68747470733a2f2f7374796c6563692e696f2f7265706f732f36373237363235332f736869656c643f7374796c653d666c6174)](https://styleci.io/repos/67276253)[![Build Status](https://camo.githubusercontent.com/b8c84e22ed9bb91a9d8985500d7729a20d2014b569266ec7e99c0abfcad25a52/68747470733a2f2f7472617669732d63692e6f72672f73616d7261702f67657374616c742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/samrap/gestalt)[![Latest Stable Version](https://camo.githubusercontent.com/1145cd5971c33fe5412fb5f4d1b3c42c8302bcdc01bcfe6fc5d41e4592abb901/68747470733a2f2f706f7365722e707567782e6f72672f73616d7261702f67657374616c742f762f737461626c65)](https://packagist.org/packages/samrap/gestalt)[![Total Downloads](https://camo.githubusercontent.com/6327a3caa593d722d302c9b102c2a5c39542fef6276df342f182a5b6fed9f280/68747470733a2f2f706f7365722e707567782e6f72672f73616d7261702f67657374616c742f646f776e6c6f616473)](https://packagist.org/packages/samrap/gestalt)[![Latest Unstable Version](https://camo.githubusercontent.com/3b75a6c28aaf838b74ded78c505bba0a74e0e3835bd7db85b4ea33ee6f7d116c/68747470733a2f2f706f7365722e707567782e6f72672f73616d7261702f67657374616c742f762f756e737461626c65)](https://packagist.org/packages/samrap/gestalt)

> **ge·stalt (n):** *Something that is made of many parts and yet is somehow more than or different from the combination of its parts; broadly : the general quality or character of something.*

Gestalt is a simple and elegant PHP package for managing your framework's configuration values. It is lightweight, flexible, framework agnostic, and has no dependencies other than PHP itself.

### Features

[](#features)

- **Lightweight:** Gestalt is built to be lightweight. No dependencies, no bloat, just an object-oriented wrapper around your framework's configuration.
- **Powerful:** Who said lightweight means powerless? Gestalt has a small footprint but packs a mean punch. Just take a look at its [Custom Loaders](https://github.com/samrap/gestalt-docs/blob/master/loaders.md) and [Observers](https://github.com/samrap/gestalt-docs/blob/master/observers.md) and you'll see for yourself.
- **Flexible:** Developers like to do things *our* way. Gestalt gives you the flexibility to integrate seamlessly with your application.
- **Expressive syntax**: With its clean, collection-like syntax, code artisans will feel right at home. Messy developers will like it too!

### Examples

[](#examples)

The following are just a few of the features Gestalt has to offer. [Visit the docs](https://github.com/samrap/gestalt-docs) for more on installation, usage, and features.

**Basic Usage** ([Learn More](https://github.com/samrap/gestalt-docs/blob/master/introduction.md))

```
$config = new Configuration([
    'app' => [
        'debug' => true,
        'version' => '1.0',
    ],
]);

// Get values using dot notation or ArrayAccess.
$config->get('app.debug');
$config['app'];

// Add values using dot notation or ArrayAccess.
$config->add('app.locale', 'en');
$config['mail'] = ['driver' => 'MailMonkey'];
```

**Custom Loading** ([Learn More](https://github.com/samrap/gestalt-docs/blob/master/loaders.md))

```
$config = Configuration::load(new JsonFileLoader);

$config->get('app.debug');
```

**Observers** ([Learn More](https://github.com/samrap/gestalt-docs/blob/master/observers.md))

```
$config = new Configuration($values);

$config->attach(new StatefulObserver);

// Notifies the StatefulObserver that the
// Configuration has been updated.
$config->set('app.debug', false);
```

Interested? [Check out the docs](https://github.com/samrap/gestalt-docs) to see all of the features in action!

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community12

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

Recently: every ~18 days

Total

7

Last Release

3463d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/78e66e2a9fc45b509f43164b07af8521a71941b081abfbbaec6597bd6d4f4a21?d=identicon)[samrap](/maintainers/samrap)

---

Top Contributors

[![dsmithhayes](https://avatars.githubusercontent.com/u/3150059?v=4)](https://github.com/dsmithhayes "dsmithhayes (1 commits)")

---

Tags

configconfig-managementphpphpconfigurationwrapperboilerplate

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[stefangabos/zebra_curl

A high performance solution for making multiple HTTP requests concurrently, asynchronously from your PHP projects using cURL

21971.3k2](/packages/stefangabos-zebra-curl)[php-tmdb/laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

16553.3k1](/packages/php-tmdb-laravel)[automattic/wistia-php

PHP wrapper for Wistia API

1431.9k](/packages/automattic-wistia-php)

PHPackages © 2026

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