PHPackages                             justinskolnick/key-value - 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. [Utility & Helpers](/categories/utility)
4. /
5. justinskolnick/key-value

ActiveLibrary[Utility & Helpers](/categories/utility)

justinskolnick/key-value
========================

KeyValue provides an interface for managing associative arrays as a collection of key-value pairs.

1.0.0(7mo ago)063MITPHPPHP >=8.0CI passing

Since Nov 24Pushed 6mo agoCompare

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

READMEChangelogDependencies (4)Versions (2)Used By (0)

KeyValue
========

[](#keyvalue)

KeyValue provides an interface for managing associative arrays as a collection of key-value pairs.

It handles common but often complex operations like confirming membership and overwriting nested values in multi-dimensional arrays. Like so:

```
$collection = new KeyValue();
$collection->set( 'id', 'bffc4d08-1750-41a7-9fdd-345187eb9ff2' );

echo $collection->get( 'id' ); // 'bffc4d08-1750-41a7-9fdd-345187eb9ff2'
```

KeyValue is one of a number of tools I'm hoping to extract from older, larger projects.

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

[](#installation)

To install this library with Composer, type:

```
composer require justinskolnick/key-value

```

Local installation is possible using the `repositories` block of your composer.json. For instance:

```
{
    "repositories": [
        {
            "type": "path",
            "url": "./packages/justinskolnick/key-value",
            "options": {
                "symlink": true
            }
        }
    ],
    "require": {
        "justinskolnick/key-value": "*"
    }
}
```

Usage
-----

[](#usage)

KeyValue collections are associative arrays, with mixed-type values saved at keys. Keys must be strings:

```
$id = $collection->get( 'id' );
```

If a KeyValue item's value is an array, the key can include a slash to access a value at the second level of the array:

```
$timestamp = $collection->get( 'created/timestamp' );
```

To get started, initiate a new KeyValue collection:

```
$collection = new KeyValue();
```

A collection can also be initiated with values:

```
$collection = new KeyValue(
  [
    'id'            => 'bffc4d08-1750-41a7-9fdd-345187eb9ff2',
    'phone_number'  => 8675309,
    'was_saved'     => false,
  ]
);
```

Set a value or many values:

```
$collection->set( 'id', 'bffc4d08-1750-41a7-9fdd-345187eb9ff2' );
$collection->setMany(
  [
    'id'            => 'bffc4d08-1750-41a7-9fdd-345187eb9ff2',
    'phone_number'  => 8675309,
    'was_saved'     => false,
    'created'   => [
      'readable'  => 'November 7, 2025',
      'timestamp' => '2025-11-07 01:23:45',
    ],
  ]
);
```

Confirm that any values have been set:

```
if ( $collection->hasAny() ) {
  return true;
}
```

Confirm that a key exists, or that a value has been set at a given key:

```
if ( $collection->has( 'id' ) ) {
  return true;
}

if ( $collection->hasValueAt( 'id' ) ) {
  return true;
}
```

Get a value for a given key:

```
$id = $collection->get( 'id' );
```

Get all values for all keys, or only the keys, or only the values:

```
$all = $collection->getAll();
$keys = $collection->getKeys();
$values = $collection->getValues();
```

Remove an item (and confirm the deletion):

```
if ( $collection->delete( 'id' ) ) {
  echo $collection->get( 'id' ); // null
}
```

Reset the collection to null (and confirm the reset):

```
$collection = new KeyValue(
  [
    'ducks'   => 3,
    'dogs'    => 4,
    'horses'  => 2,
  ]
);

$collection->set( 'dogs', 6 );

if ( $collection->reset() ) {
  echo $collection->get( 'dogs' ); // 4
}
```

Reset the collection to null (and confirm the reset):

```
$collection = new KeyValue(
  [
    'ducks'   => 3,
    'dogs'    => 4,
    'horses'  => 2,
  ]
);

if ( $collection->reset( true ) ) {
  echo $collection->get( 'dogs' ); // null
}
```

Confirm the collection is empty:

```
if ( $collection->isEmpty() ) {
  return true;
}
```

Confirm the collection is a non-null empty array:

```
$collection = new KeyValue( [] );

if ( $collection->isEmpty( true ) ) {
  return true;
}
```

Confirm the collection is null (such as on init or after a reset):

```
if ( $collection->isNull() ) {
  return true;
}
```

Style
-----

[](#style)

Readers will note that the code, tests, and examples in this README don't meet the requirements of PSR-2 or PSR-12. Instead, they follow conventions I adopted a long time ago to help me scan PHP code. While this personal style is expected to be followed in PRs on this repository, it's not a requirement of use.

License
-------

[](#license)

Copyright (c) 2025 Justin Skolnick. [MIT License](/LICENSE).

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance65

Regular maintenance activity

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

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

Unknown

Total

1

Last Release

221d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/770759c15252bd2d7ed2f2e0a476e1f0be044c7cf32d8285b7818e4267c6c132?d=identicon)[justinskolnick](/maintainers/justinskolnick)

---

Top Contributors

[![justinskolnick](https://avatars.githubusercontent.com/u/235931?v=4)](https://github.com/justinskolnick "justinskolnick (3 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/justinskolnick-key-value/health.svg)

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

###  Alternatives

[learninglocker/learninglocker

The open source learning record store.

5813.0k](/packages/learninglocker-learninglocker)

PHPackages © 2026

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