PHPackages                             superruzafa/settings - 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. superruzafa/settings

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

superruzafa/settings
====================

A collection of custom selectable elements

1.1.0(11y ago)020MITPHPPHP >=5.3.0

Since Oct 12Pushed 11y ago1 watchersCompare

[ Source](https://github.com/superruzafa/settings)[ Packagist](https://packagist.org/packages/superruzafa/settings)[ Docs](https://github.com/superruzafa/settings)[ RSS](/packages/superruzafa-settings/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

Settings
========

[](#settings)

[![Build Status](https://camo.githubusercontent.com/38428362248baf9310a8f2c1815b6da9357567c9ee1ebd99a23bae4b98e093f7/68747470733a2f2f7472617669732d63692e6f72672f737570657272757a6166612f73657474696e67732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/superruzafa/settings)

Settings is a library for manage collection of elements. Each element is included into the collection along with some metadata. This metadata could be used later for enumerate a subset of elements. The elements are selected using selectors.

Built-in selectors
------------------

[](#built-in-selectors)

Settings comes with some predefined selectors:

### Tag selectors

[](#tag-selectors)

This kind of selector allow to store the elements with some associated tags. There is two classes of tags:

- Required tags: `'required'`, `'necessary`
- Optional tags (between brackets): `'[optional]'`, `'[redundant]'`

Both required and optional tags have special meanings depending on th type of tag selector. Optional tags are usually used for disambiguation purposes.

#### Strict tag selector

[](#strict-tag-selector)

This selector selects only those items whose metatags intersect with the selector tags:

```