wandersonwhcr/zend-romans

Zend Framework Romans Integration

Sunday, April 23, 2017
by wandersonwhcr
Repository
1 Watchers
0 Stars
4 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
18 Versions
33 % Grown

The README.md

zend-romans

DEPRECATED use Laminas Project Romans Integration, _(*1)

, _(*2)

Description

This package provides a Zend Framework integration for Romans library, providing tools to filter a string with a Roman number to int and vice-versa, validate a string that contains this type of number and, finally, hydrate the content to int., _(*3)

Installation

This package uses Composer as default repository. You can install it adding the name of package in require attribute of composer.json, pointing to the last stable version., _(*4)

{
    "require": {
        "wandersonwhcr/zend-romans": "^1.0"
    }
}

Usage

This package provide filters, validators and hydrators to use with Zend Framework projects. Also, this package is provided as a Zend Framework module, automatically configuring services inside application, but this action is not required., _(*5)

Filters

Zend Romans provides a couple of filters to convert a string with Roman number to int and a Integer to a string that represents the input as Roman number., _(*6)

use Zend\Romans\Filter\RomanToInt as RomanToIntFilter;
use Zend\Romans\Filter\IntToRoman as IntToRomanFilter;

$value = 'MCMXCIX';

$filter = new RomanToIntFilter();
$value  = $filter->filter($value); // 1999

$filter = new IntToRomanFilter();
$value  = $filter->filter($value); // MCMXCIX

Validator

Also, this package include a validator to verify if a string contains a valid Roman number., _(*7)

use Zend\Romans\Validator\Roman as RomanValidator;

$validator = new RomanValidator();

$result = $validator->isValid('MCMXCIX'); // true

$result   = $validator->isValid('IAI'); // false
$messages = $validator->getMessages();

/*
$messages = [
    'unknownToken' => 'Unknown token "A" at position 1',
];
*/

$result   = $validator->isValid('XIIIX'); // false
$messages = $validator->getMessages();

/*
$messages = [
    'invalidRoman' => 'Invalid Roman number "XIIX"',
];
 */

Hydrator

There is a hydrator strategy, responsible to handle Roman numbers. Like any other Zend Framework strategy, exceptions will be throw for errors., _(*8)

use InvalidArgumentException;
use Zend\Romans\Hydrator\Strategy\Roman as RomanHydratorStrategy;

$value    = 'MCMXCIX';
$strategy = new RomanHydratorStrategy();

try {
    $value = $strategy->hydrate($value); // 1999
    $value = $strategy->extract($value); // MCMXCIX
} catch (InvalidArgumentException $e) {
    // unable to convert
}

ViewHelper

Finally, there is a view helper to convert int to Roman numbers directly, using an internal filter for this job., _(*9)

use Zend\Romans\View\Helper\Roman as RomanViewHelper;

$helper = new RomanViewHelper();

// Simple Access
echo $helper(1999); // MCMXCIX

// ... or Inside ViewRenderer
echo $this->roman(1999); // MCMXCIX

Module

This package is provided as a Zend Framework module. To initialize this module, add the package namespace into application loaded modules configuration., _(*10)

<?php
return [
    'modules' => [
        // ...
        'Zend\Romans',
        // ...
    ],
];

Using this feature you must require Zend Framework ModuleManager and ServiceManager in your composer.json file., _(*11)

{
    "require": {
        "zendframework/zend-modulemanager": "2.7.*",
        "zendframework/zend-servicemanager": "3.3.*"
    }
}

Services Available

If you configure this package as a Zend Framework module, there is a lot of services configured. The list below shows all services available with Zend\Romans module. Items with double-arrow represents services aliases., _(*12)

Romans\Grammar\Grammar
Romans\Lexer\Lexer
Romans\Parser\Parser
Romans\Filter\IntToRoman
Romans\Filter\RomanToInt
Zend\Romans\Hydrator\Strategy\Roman
FilterManager
- Zend\Romans\Filter\IntToRoman
- Zend\Romans\Filter\RomanToInt
- IntToRoman => Zend\Romans\Filter\IntToRoman
- intToRoman => Zend\Romans\Filter\IntToRoman
- inttoroman => Zend\Romans\Filter\IntToRoman
- RomanToInt => Zend\Romans\Filter\RomanToInt
- romanToInt => Zend\Romans\Filter\RomanToInt
- romantoint => Zend\Romans\Filter\RomanToInt
ValidatorManager
- Zend\Romans\Validator\Roman
- Roman => Zend\Romans\Validator\Roman
- roman => Zend\Romans\Validator\Roman
ViewHelperManager
- Zend\Romans\View\Helper\Roman
- Roman => Zend\Romans\View\Helper\Roman
- roman => Zend\Romans\View\Helper\Roman

License

This package is opensource and available under license MIT described in LICENSE., _(*13)

The Versions

23/04 2017

dev-master

9999999-dev

Zend Framework Romans Integration

library zend-romans

Zend Framework Romans Integration

wandersonwhcr/zend-romans

The README.md

zend-romans

Description

Installation

Usage

Filters

Validator

Hydrator

ViewHelper

Module

Services Available

License

The Versions

dev-master

The Requires

The Development Requires

dev-develop

The Requires

The Development Requires

v1.0.2

The Requires

The Development Requires

v1.0.1

The Requires

The Development Requires

v1.0.0

The Requires

The Development Requires

v0.4.6

The Requires

The Development Requires

v0.4.5

The Requires

The Development Requires

v0.4.4

The Requires

The Development Requires

v0.4.3

The Requires

The Development Requires

v0.4.2

The Requires

The Development Requires

v0.4.1

The Requires

The Development Requires

v0.4.0

The Requires

The Development Requires

v0.3.1

The Requires

The Development Requires

v0.3.0

The Requires

The Development Requires

v0.2.0

The Requires

The Development Requires

v0.1.1

The Requires

The Development Requires

v0.1.0

The Requires

The Development Requires

v0.0.2

The Requires