smtech\StMarksSearch\RequireParameter

Complexity

Total Complexity

5

Size/Duplication

Total Lines	44
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	requireParameter()	0	14	3
A	forceBooleanParameter()	0	4	2

<?php

namespace smtech\StMarksSearch;

use Exception;

/**
 * Require parameters
 *
 * @author Seth Battis <SethBattis@stmarksschool.org>
 */
trait RequireParameter
{
    /**
     * Require that a specific parameter key exists (and optionally has a
     * particular class as one of its parents)
     *
     * @param mixed[string] $params

The doc-type mixed[string] could not be parsed: Expected "]" at position 2, but found "string". (view supported doc-types)

     * @param string $key
     * @param string|false $class (Optional, defaults to `FALSE`) name of class
     *                            to require as a parent
     * @return void
     * @throws Exception If the required parameter is not set (or does not
     *         have the correct parent class, if `$class` is specified)
     */
    protected function requireParameter($params, $key, $class = false)
    {
        assert(isset($params[$key]), new Exception("`$key` param required"));

        if ($class !== false && is_string($class)) {
            assert(
                is_a($params[$key], $class),
                new Exception(
                    "`$key` must be an instance of `$class`, instance of " .
                    get_class($params[$key]) . ' passed instead'
                )
            );
        }
    }


    /**
     * Force a boolean result from a particular parameter key
     *
     * @param mixed[string] $params

The doc-type mixed[string] could not be parsed: Expected "]" at position 2, but found "string". (view supported doc-types)

     * @param string $key    [description]
     * @return boolean `TRUE` iff `$params[$key]` exists and has a true value
     *                        (`1`, `'yes'`, `'true'`, `true`, etc.), `FALSE`
     *                        otherwise.
     */
    protected function forceBooleanParameter($params, $key)
    {
        return isset($params[$key]) && filter_var($params[$key], FILTER_VALIDATE_BOOLEAN);
    }
}