Download the PHP package code-distortion/options without Composer

On this page you can find all versions of the php package code-distortion/options. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package options

Options

Latest Version on Packagist PHP Version GitHub Workflow Status Buy The World a Tree

code-distortion/options is a PHP library for managing options in a simple, flexible and expressive way.

Installation

Install the package via composer:

Usage

The parse() method will take your string and break it down into separate options:

Value types

You can specify option values as either key-value-pairs.

Expressive string format

Multiple string values can joined together and separated with either spaces "`" or a comma,` (or both):

Note: Regular expressions are used to examine the string values above. You may wish to use them for convenience, or use plain arrays like below for faster speed.

Array key-value-pairs

You can specify values simply as arrays:

Note: You can specify non-scalar values with this library (eg. nested arrays), however they aren't dealt with in any special way. They are currently treated like scalar values.

Using in your code

You can use an Options instance to handle values for you programmatically. The resolve() method will parse the input and return the Options object which you can then interrogate in your code:

Specifying default values

You can specify default fall-back values to use by calling defaults():

Resolving a set of options with defaults

To combine default values and custom values, use the defaults() method and then resolve():

Note: If you specify default values, any values passed to resolve() that aren't present in the defaults will generate an exception unless allowUnexpected() is called before hand:

Validation

If you want to validate the given values you can pass a callback closure to validator(). Each value that is picked will be passed to your callback to check that it's valid. If it returns a false-y value, an exception will be raised.

Chaining

The methods below may be chained together, and any of them can be called statically to instantiate an Options object:

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

SemVer

This library uses SemVer 2.0.0 versioning. This means that changes to X indicate a breaking change: 0.0.X, 0.X.y, X.y.z. When this library changes to version 1.0.0, 2.0.0 and so forth, it doesn't indicate that it's necessarily a notable release, it simply indicates that the changes were breaking.

Treeware

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

Contributing

Please see CONTRIBUTING for details.

Code of Conduct

Please see CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.


All versions of options with dependencies

PHP Build Version
Package Version
Requires php Version 7.1.* | 7.2.* | 7.3.* | 7.4.* | 8.0.* | 8.1.* | 8.2.* | 8.3.*
ext-mbstring Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package code-distortion/options contains the following files

Loading the files please wait ....