Download the PHP package lkrms/dice without Composer

On this page you can find all versions of the php package lkrms/dice. 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 dice

Note: this is a fork of Tom Butler's project. It reflects the requirements and priorities of a PHP toolkit that uses it, which may or may not align with your own.

Dice PHP Dependency Injection Container

Dice is a minimalist Dependency Injection Container for PHP with a focus on being lightweight and fast as well as requiring as little configuration as possible.

Project Goals

1) To be lightweight and not a huge library with dozens of files (Dice is a single class) yet support all features (and more) offered by much more complex containers

2) To "just work". Basic functionality should work with zero configuration

3) Where configuration is required, it should be as minimal and reusable as possible as well as easy to use.

4) Speed! (See the section on performance)

Installation

Install the latest version of this fork with Composer:

Alternatively, include the lightweight Dice.php in your project and it's usable without any further configuration:

Simple example:

Full Documentation

For complete documentation please see the Dice PHP Dependency Injection container home page

PHP version compatibility

Dice is compatible with PHP 7.0 and up, including PHP 8+.

Performance

Dice uses reflection which is often wrongly labelled "slow". Reflection is considerably faster than loading and parsing a configuration file. There are a set of benchmarks here and here (to download the benchmark tool yourself see this repository) and Dice is faster than the others in most cases.

In the real world test (test 6) Dice is neck-and-neck with Pimple (which requires writing an awful lot of configuration code) and although Symfony\DependencyInjection is faster at creating objects, it has a larger overhead and you need to create over 500 objects on each page load until it becomes faster than Dice. The same is true of Phalcon, the overhead of loading the Phalcon extension means that unless you're creating well over a thousand objects per HTTP request, the overhead is not worthwhile.

Credits

Originally developed by Tom Butler (@TomBZombie), with many thanks to daniel-meister (@daniel-meister), Garrett W. (@garrettw), maxwilms (@maxwilms) for bug fixes, suggestions and improvements.

This fork is maintained by Luke Arms (@lkrms).

Updates

15/11/2018 4.0 Release - Backwards incompatible

Dice is now immutable and has better support for other immutable objects.

New Features

1. Dice is Immutable

This avoids issues surrounding mutability where a Dice instance is passed around the application and reconfigured. The only difference is that addRules and addRule return a new Dice instance with the updated rules rather than changing the state of the existing instance.

From a practical perspective in most cases just put $dice = in front of any $dice->addRule() call and it will work as before.

2. Support for Object Method Chaining

One feature some immutable objects have is they offer object chaining.

Consider the following Object:

It was not possible for Dice to construct the configured object in previous versions. As of 4.0 Dice supports chaining method call using the call rule and the Dice::CHAIN_CALL constant:

Dice will replace the HTTPRequest object with the result of the chained call. This is also useful for factories:

06/03/2018 3.0 Release - Backwards incompatible

New Features

1. The JSON loader has been removed in favour of a new addRules method.

The purpose of this addition is to make the JSON loader redundant. Loading of rules from a JSON file can easily be achieved with the code:

2. Better JSON file support: constants and superglobals

In order to improve support for rules being defined in external JSON files, constants and superglobals can now be passed into objects created by Dice.

For example, passing the $_SERVER superglobal into a router instance and calling PDO's setAttribute with PDO::ATTR_ERRMODE and PDO::ERRMODE_EXCEPTION can be achieved like this in a JSON file:

rules.json

Backwards incompatible changes

  1. Dice 3.0 requires PHP 7.0 or above, PHP 5.6 is no longer supported.

  2. Dice no longer supports 'instance' keys to signify instances. For example:

As noted in issue #125 this made it impossible to pass an array to a constructor if the array had a key 'instance'. Instead, the new \Dice\Dice::INSTANCE constant should be used:

to make the constant shorter to type out, you can use \Dice\Dice; and reference Dice::INSTANCE

10/06/2016 - Backwards incompatible change

Based on Issue 110 named instances using instanceOf will now inherit the rules applied to the class they are instances of:

$dice->create('$MyNamedInstance') will now create a class following the rules applied to both MyClass and $MyNamedInstance so the instance will be shared.

Previously only the rules applied to the named instance would be used.

To restore the old behaviour, set inherit to false on the named instance:

29/10/2014

Previously Dice ran closures that were passed as substitutions, constructParams and when calling methods:

This behaviour has changed as it makes it impossible to provide a closure as a construct parameter or when calling a method because the closure was always called and executed.

To overcome this, Dice will now only call a closures if they're wrapped in \Dice\Instance:

04/09/2014

26/08/2014

28/06/2014

06/06/2014

27/03/2014

01/03/2014

28/02/2014


All versions of dice with dependencies

PHP Build Version
Package Version
Requires php Version >=7.0
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 lkrms/dice contains the following files

Loading the files please wait ....