alexdodonov / mezon-application

Controller.php

<?php
namespace Mezon\Application;

use Mezon\Transport\RequestParamsInterface;

/**
 * Class Controller
 *
 * @package Mezon
 * @subpackage Controller
 * @author Dodonov A.A.
 * @version v.1.0 (2020/01/12)
 * @copyright Copyright (c) 2020, aeon.org
 */

/**
 * Base class for all views
 *
 * @deprecated since 2020-06-26
 */
class Controller extends ControllerInterface

The class Mezon\Application\ControllerInterface has been deprecated: since 2020-06-26

{

    /**
     * Router
     *
     * @var RequestParamsInterface
     */
    private $requestParams = null;

    /**
     * Constructor
     *
     * @param string $controllerName
     *            Controller name to be executed
     * @param ?RequestParamsInterface $requestParams
     *            request params fetcher
     */
    public function __construct(string $controllerName = '', ?RequestParamsInterface $requestParams = null)
    {
        $this->setControllerName($controllerName);

        $this->requestParams = $requestParams;
    }

    /**
     * Method return $requestParams and thrown exception if it was not set
     *
     * @return RequestParamsInterface request params fetcher
     * @deprecated since 2020-07-06 use getRequestParamsFetcher
     * @codeCoverageIgnore
     */
    public function getParamsFetcher(): RequestParamsInterface
    {
        return $this->getRequestParamsFetcher();
    }

    /**
     * Method returns $this->requestParams and creates this object if necessery
     *
     * @return RequestParamsInterface
     */
    public function getRequestParamsFetcher(): RequestParamsInterface
    {
        if ($this->requestParams === null) {
            throw (new \Exception('Param fetcher was not setup'));
        }

        return $this->requestParams;
    }

    /**
     * Method runs controller
     *
     * @param
     *            string ControllerName
     *            Controller name to be run
     * @return mixed result of the controller
     */
    public function run(string $controllerName = '')
    {
        if ($controllerName === '') {
            $controllerName = $this->getControllerName();
        }

        if ($controllerName === '') {
            $controllerName = 'Default';
        }

        if (method_exists($this, 'controller' . $controllerName)) {
            return call_user_func([
                $this,
                'controller' . $controllerName
            ]);
        }

        throw (new \Exception('Controller ' . $controllerName . ' was not found'));
    }

    /**
     * May be these functions should be excluded to base class common with View
     */

    /**
     * Method redirects user to another page
     *
     * @param string $url
     * @codeCoverageIgnore
     */
    public function redirectTo(string $url): void
    {
        header("Location: $url");
        exit(0);
    }

    /**
     * Method builds route data
     *
     * @param string $route
     *            route
     * @param string $method
     *            HTTP method
     * @param string $function
     *            controller's function name
     * @return array built route data
     */
    public function buildRoute(string $route, string $method, string $function): array
    {
        return [
            'route' => $route,
            'method' => $method,
            'callback' => [
                $this,
                $function
            ]
        ];
    }
}