eserozvataf / scabbia2-helpers

src/Helpers/Runtime.php

<?php
/**
 * Scabbia2 Helpers Component
 * https://github.com/eserozvataf/scabbia2
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @link        https://github.com/eserozvataf/scabbia2-helpers for the canonical source repository
 * @copyright   2010-2016 Eser Ozvataf. (http://eser.ozvataf.com/)
 * @license     http://www.apache.org/licenses/LICENSE-2.0 - Apache License, Version 2.0
 */

namespace Scabbia\Helpers;

/**
 * A bunch of utility methods for runtime hacks
 *
 * @package     Scabbia\Helpers
 * @author      Eser Ozvataf <eser@ozvataf.com>
 * @since       2.0.0
 *
 * @scabbia-compile
 */
class Runtime
{
    /**
     * Default variables for runtime hacks
     *
     * @type array $defaults array of default variables
     */
    public static $defaults = [
    ];


    /**
     * Constructor to prevent new instances of Runtime class
     *
     * @return Runtime

Adding a @return annotation to constructors is generally not recommended as a constructor does not have a meaningful return value.

     */
    final private function __construct()
    {
    }

    /**
     * Clone method to prevent duplication of Runtime class
     *
     * @return Runtime
     */
    final private function __clone()
    {
    }

    /**
     * Unserialization method to prevent restoration of Runtime class
     *
     * @return Runtime
     */
    final private function __wakeup()
    {
    }

    /**
     * Sets the default variables
     *
     * @param array $uDefaults variables to be set
     *
     * @return void
     */
    public static function setDefaults($uDefaults)
    {
        self::$defaults = $uDefaults + self::$defaults;
    }

    /**
     * Allows on-the-fly construction of classes
     *
     * @param mixed    $uCallback  callback
     *
     * @return mixed   callback
     */
    public static function callbacks($uCallback)
    {
        if (is_string($uCallback) && ($tPos = strrpos($uCallback, "@")) !== false) {
            $tClassName = substr($uCallback, 0, $tPos);
            $uCallback = [new $tClassName (), substr($uCallback, $tPos + 1)];
        }

        return $uCallback;
    }
}