revolution/laravel-zend-form

This package is abandoned and no longer maintained. The author suggests using the revolution/laravel-laminas-form package instead.

Laravel Zend Form

1.3.0 2020-08-28 07:12 UTC

This package is auto-updated.

Last update: 2020-10-27 07:27:07 UTC


README

Build Status Maintainability Test Coverage

Laravel Zend Form

https://docs.zendframework.com/zend-form/

Laminas

https://github.com/kawax/laravel-laminas-form

Requirements

  • PHP >= 7.1
  • Laravel >= 5.5

Installation

composer require revolution/laravel-zend-form

Suggest from ZendForm

https://github.com/zendframework/zend-form/blob/master/composer.json

        "zendframework/zend-captcha": "^2.7.1, required for using CAPTCHA form elements",
        "zendframework/zend-code": "^2.6 || ^3.0, required to use zend-form annotations support",
        "zendframework/zend-eventmanager": "^2.6.2 || ^3.0, reuired for zend-form annotations support",
        "zendframework/zendservice-recaptcha": "in order to use the ReCaptcha form element"

Demo

https://github.com/kawax/laravel-zend-form-project

Artisan command

php artisan make:form SampleForm

app/Http/Forms/SampleForm.php

Form class

namespace App\Http\Forms;

use Revolution\ZendForm\Form as ZendForm;
use Zend\Form\Element;

class SampleForm extends ZendForm
{
    /**
     * Create a new form.
     *
     * @param null|string $name
     *
     * @return void
     */
    public function __construct($name = null)
    {
        parent::__construct($name);

        $this->setAttributes([
            'action' => url('/'),
            'method' => 'post',
        ]);

        $name = new Element\Text('name');
        $name->setAttributes([
            'id'    => 'name',
            'class' => 'form-control',
            'value' => old('name'),
        ]);
        $name->setLabel('Your name');
        $name->setLabelAttributes([
            'class' => 'col-sm-2 col-form-label',
        ]);
        $name->setOptions([
            'wrapper-class' => 'form-group row',
            'element-class' => 'col-sm-10',
        ]);

        $this->add($name);

        $this->add([
            'type'       => Element\Email::class,
            'name'       => 'email',
            'attributes' => [
                'id'    => 'email',
                'class' => 'form-control',
                'value' => old('email'),
            ],
            'options'    => [
                'label'            => 'Your email address',
                'label_attributes' => [
                    'class' => 'col-sm-2 col-form-label',
                ],
                'wrapper-class'    => 'form-group row',
                'element-class'    => 'col-sm-10',
            ],
        ]);

        $this->add([
            'type'       => Element\Hidden::class,
            'name'       => '_token',
            'attributes' => [
                'value' => csrf_token(),
            ],
        ]);

        $this->add([
            'name'       => 'send',
            'type'       => 'Submit',
            'attributes' => [
                'value' => 'Submit',
                'class' => 'btn btn-primary',
            ],
        ]);
    }
}

Controller

use App\Http\Forms\SampleForm;

    public function __invoke()
    {
        $form = new SampleForm;

        return view('form')->with(compact('form'));
    }
use App\Http\Forms\SampleForm;

    public function __invoke(SampleForm $form)
    {
        return view('form')->with(compact('form'));
    }

View

Simple render

{{ $form->render() }}

Same as ZendForm's echo $this->form($form);

Detail render

@php
    $form->prepare();
@endphp

{!! $form->form()->openTag($form) !!}

{{ csrf_field() }}

<div class="form-group row">
    <label for="name" class="col-sm-3 col-form-label">{!! $form->get('name')->getLabel()  !!}</label>
    <div class="col-sm-9">
        {!! $form->formInput($form->get('name')) !!}
    </div>
</div>

<div class="form-group row">
    <label for="email" class="col-sm-3 col-form-label">{!! $form->get('email')->getLabel()  !!}</label>
    <div class="col-sm-9">
        {!! $form->formInput($form->get('email')) !!}
    </div>
</div>

<div class="form-group row">
    <div class="col-sm-9 offset-sm-3">
        {!! $form->formSubmit($form->get('send')) !!}
    </div>
</div>

{!! $form->form()->closeTag($form) !!}

Form object can call Zend's ViewHelper by magic method.

See https://docs.zendframework.com/zend-form/quick-start/

ViewHelper render

{{ $form->render('bootstrap4horizon') }}

https://github.com/kawax/laravel-zend-form/blob/master/docs/helpers.md

Validation

Use Laravel's FormRequest.

LICENSE

MIT
Copyright kawax