Как работает синтаксис метода "public function direct () {}" в PHP? - PullRequest
2 голосов
/ 30 октября 2010

Я сейчас изучаю Zend Framework и натолкнулся на следующий синтаксис.

class Zend_Controller_Action_Helper_Redirector extends Zend_Controller_Action_Helper_Abstract
{
    /**
     * Perform a redirect to an action/controller/module with params
     *
     * @param  string $action
     * @param  string $controller
     * @param  string $module
     * @param  array  $params
     * @return void
     */
    public function gotoSimple($action, $controller = null, $module = null, array $params = array())
    {
        $this->setGotoSimple($action, $controller, $module, $params);

        if ($this->getExit()) {
            $this->redirectAndExit();
        }
    }

    /**
     * direct(): Perform helper when called as
     * $this->_helper->redirector($action, $controller, $module, $params)
     *
     * @param  string $action
     * @param  string $controller
     * @param  string $module
     * @param  array  $params
     * @return void
     */
    public function direct($action, $controller = null, $module = null, array $params = array())
    {
        $this->gotoSimple($action, $controller, $module, $params);
    }
}

В Zend Framework метод direct () в этом классе может быть вызван с использованием следующего синтаксиса:

$this->_helper->redirector('index','index');

Где редиректор - это объект (!) В объекте _helper,который находится внутри объекта контроллера, в котором мы вызываем метод.Синтаксический сахар здесь заключается в том, что вы можете просто передать параметры объекту, а не методу, который мы бы написали так:

$this->_helper->redirector->gotoSimple('index','index');

.., что все в порядке и конечно же.

Вот мой вопрос : является ли этот метод стандарта direct () стандартным в OO PHP?Или эта функциональность встроена в Zend Framework?Я не могу найти документацию по этому вопросу.

Спасибо!

1 Ответ

11 голосов
/ 30 октября 2010

Это встроенная функциональность в Zend Framework.

Свойство $_helpers в экземпляре Controller содержит экземпляр Action_HelperBroker.Этот экземпляр реализует магический PHP * метод __call .Когда вы вызываете метод, который не существует в этом экземпляре, он попытается использовать имя метода, чтобы получить помощника с тем же именем и вызвать direct() для него (если это возможно).См. Код ниже.

С Zend_Controller_Action

/**
 * Helper Broker to assist in routing help requests to the proper object
 *
 * @var Zend_Controller_Action_HelperBroker
 */
protected $_helper = null;

С Zend_Controller_Action_HelperBroker

/**
 * Method overloading
 *
 * @param  string $method
 * @param  array $args
 * @return mixed
 * @throws Zend_Controller_Action_Exception if helper does not have a direct() method
 */
public function __call($method, $args)
{
    $helper = $this->getHelper($method);
    if (!method_exists($helper, 'direct')) {
        require_once 'Zend/Controller/Action/Exception.php';
        throw new Zend_Controller_Action_Exception('Helper "' . $method . '" does not support overloading via direct()');
    }
    return call_user_func_array(array($helper, 'direct'), $args);
}

Помощник брокера также реализует магический метод __get, поэтому, когдапри попытке доступа к несуществующему свойству брокер будет использовать имя свойства в качестве аргумента для getHelper()

/**
 * Retrieve helper by name as object property
 *
 * @param  string $name
 * @return Zend_Controller_Action_Helper_Abstract
 */
public function __get($name)
{
    return $this->getHelper($name);
}

Обратите внимание, что магические методы не предназначены для замены надлежащего API,Хотя вы можете использовать их, как показано выше, вызов более подробного

$this->_helper->getHelper('redirector')->gotoSimple('index','index');

часто является гораздо более быстрой альтернативой.

...