Introduction

I work through a reusable admin module; responsible for handling authentication and ACLs. This module comes with a base controller that any other implemented module can implement. Thus, this controller is Cp\AdminControllerunavailable, but inherited by all other controllers.

Problem

I have a standard / home controller Cp\HomeControllerthat has several actions; login, logout and forgotten / reset password. I'm currently working on Cp\HomeController::indexAction. As part of this method, I just do the following:

// ... controller logic ...
public function indexAction()
{
    if ($this->getAuth()->hasIdentity()) {
        # XXX: This is the authorised view/dashboard.
    } else {
        # XXX: This is the unauthorised view; login page.

        $loginForm = new Form\Login();

        # XXX: validation, and login form handling here.

        return array(
            'form' => $loginForm
        );
    }
}
// ... controller logic ...

The problem is that it Cp\HomeControlleruses a template by default ./module/Cp/view/cp/home/index.phtml; and looks like this:

<h1>Authorisation Required</h1>

<section id="admin-login">
    <?= $form ?>
</section>

Zend\Form ./module/Cp/src/Cp/Form.php, . _ , , .

<?php
// @file: ./module/Cp/src/Cp/Form.php

namespace Cp;

use Zend\Form\Form as ZendForm;
use Zend\Form\Fieldset;
use Zend\InputFilter\Input;
use Zend\InputFilter\InputFilter;
use Zend\View\Model\ViewModel;
use Zend\View\Renderer\PhpRenderer;
use Zend\View\Resolver;

class Form extends ZendForm
{
    /**
     * Define the form template path.
     * @var String
     */

    protected $__templatePath;

    /**
     * Define the view variables.
     * @var Array
     */

    protected $__viewVariables = array();

    /**
     * Set the view variable.
     * @param String $key The index for the variable.
     * @param Mixed $value The value for the view variable.
     * @return Cp\Form
     */

    public function set($key, $value)
    {
        $this->__viewVariables[$key] = $value;
        return $this;
    }

    /**
     * Set the template path.
     * @param String $path The path for the template file.
     * @return Cp\Form
     */

    public function setTemplatePath($path)
    {
        $this->__templatePath = $path;
        return $this;
    }

    /**
     * When the object is buffered in output, we're going to generate the view
     * and render it.
     * @return String
     */

    public function __toString()
    {
        // Define our template file as form for resolver to map.
        $map = new Resolver\TemplateMapResolver(array(
            'form' => $this->__templatePath
        ));

        // Define the render instance responsible for rendering the form.
        $renderer = new PhpRenderer();
        $renderer->setResolver(new Resolver\TemplateMapResolver($map));

        // The form view model will generate the form; parsing the vars to it.
        $view = new ViewModel();
        $view->setVariable('form', $this);
        $view->setTemplate('form');

        foreach ($this->__viewVariables as $key => $value) {
            if (! property_exists($view, $key)) {
                $view->setVariable($key, $value);
            }
        }

        return $renderer->render($view);
    }
}

, , , .

<?php

namespace Cp\Form;

use Zend\Form\Element;

class Login extends \Cp\Form
{
    public function __construct($name = 'Login', $action)
    {
        // Parse the form name to our parent constructor.
        parent::__construct($name);

        // Override default template, defining our form view.
        $this->setTemplatePath(MODULE_DIR . 'Cp/view/cp/form/login.phtml');

        // Create our form elements, and validation requirements.
        $email = new Element\Email('email');
        $email->setLabel('E-mail Address');

        $password = new Element\Password('password');
        $password->setLabel('Password');

        $submit = new Element\Submit('login');

        $this->setAttribute('action', $action)
            ->setAttribute('method', 'post')
            ->setAttribute('autocomplete', 'autocomplete')
            ->add($email)
            ->add($password)
            ->add($submit);
    }
}

__toString . , . (. ) , , HTML. Cp\Form\Login , , .

, Zend HTML? <input type="<?= ... ?>" name="<?= ... ?>" />. , , ; .

<section class="authentication-form">
    <h2>Authentication Required</h2>

    <!-- How-to:  Generate the <form> tag and all it attributes. -->
    <?= $form->openTag() ?>

    <? if ($ipAllowed): ?>
        <p>Please choose an account to log in through.</p>

        <fieldset>
            <?= $form->get('email') ?>
        </fieldset>
    <? else: ?>
        <p>Please log in using your e-mail address and password.</p>

        <fieldset>
            <?= $form->get('email') ?>
            <?= $form->get('password') ?>
        </fieldset>
    <? endif ?>

    <div class="action">
        <!-- How-To:  Generate the <input type="submit" name="" ... attributes ... />
        <?= $form->get('login') ?>
    </div>

    <!-- How-To: Generate the form close tag.
    <?= $form->closeTag() ?>
</section>

, , .