PHP cheat-sheets¶

<?php
namespace MyVendor\MyExtension\Form;

use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
use Romm\Formz\Form\FormInterface;
use Romm\Formz\Form\FormTrait;

/**
 * Example form
 */
class ExampleForm extends AbstractEntity implements FormInterface {

    use FormTrait;

    /**
     * @var string
     */
    protected $email;

    /**
     * @var string
     */
    protected $name;

    /**
     * @return string
     */
    public function getEmail(){
       return $this->email;
    }

    /**
     * @return string
     */
    public function getName(){
       return $this->name;
    }
}

<?php
namespace MyVendor\MyExtension\Controller;

use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
use MyVendor\MyExtension\Form\ExampleForm;

class ExampleController extends ActionController {
    /**
     * Show an example form.
     */
    public function showFormAction()
    {
        // Do anything you need in here...
    }

    /**
     * Action called when the Example form is submitted.
     *
     * @param ExampleForm $exForm
     * @validate $exForm MyVendor.MyExtension:Form\ExampleFormValidator
     */
    public function submitFormAction(ExampleForm $exForm)
    {
        // The form is valid: should you save it? Process it? Your call!
    }
}

<?php
namespace MyVendor\MyExtension\Validation\Validator\Form;

use Romm\Formz\Validation\Validator\Form\AbstractFormValidator;
use MyVendor\MyExtension\Utility\SimulationUtility;
use MyVendor\MyExtension\Utility\SessionUtility;
use MyVendor\MyExtension\Utility\GeographyUtility;
use MyVendor\MyExtension\Form\SimulationForm;

class ExampleFormValidator extends AbstractFormValidator {

    /**
     * @var SimulationForm
     */
    protected $form;

    /**
     * Before validation begins, we check if the user is still connected: if
     * not he will be automatically redirected.
     *
     * We also activate the rule `required` for the fields `name` and `first
     * name` if at least one of them is filled.
     */
    protected function beforeValidationProcess()
    {
        SessionUtility::checkUserIsConnected();

        if (empty($this->form->getName())
            && empty($this->form->getFirstName())
        ) {
            $this->deactivateFieldValidator('name', 'required');
            $this->deactivateFieldValidator('firstName', 'required');
        }
    }

    /**
     * When the zip code has been validated, we try to fetch the city which
     * matches this code. If no city was find we do nothing: the city value
     * submitted by the user will be validated next. If we find a city, we
     * fill the form with this new value and deactivate the field `city`,
     * because it is no more a user value.
     */
    protected function zipCodeValidated()
    {
        $zipCode = $this->form->getZipCode();
        $city = GeographyUtility::getCityFromZipCode($zipCode);
        if (null !== $city) {
            $this->form->setCity($city);
            $this->deactivateField('city');
        }
    }

    /**
     * If there was no error in the form submission, the simulation process
     * runs. If the simulation result contains errors, we cancel the form
     * validation.
     */
    protected function afterValidationProcess()
    {
        if (false === $this->result->hasErrors()) {
            $simulation = SimulationUtility::simulate($this->form);

            if (null === $simulation) {
                $error = new Error('Simulation error!', 1454682865)
                $this->result->addError($error);
            } else {
                $this->form->setSimulationResult($simulation);
            }
        }
    }
}

<?php
namespace Romm\Formz\Validation\Validator;

class NumberLengthValidator extends AbstractValidator
{

    /**
     * @var array
     */
    protected static $javaScriptValidationFiles = [
        'EXT:formz/Resources/Public/JavaScript/Validators/Formz.Validator.NumberLength.js'
    ];

    /**
     * @var array
     */
    protected $supportedOptions = [
        'minimum' => [0, 'The minimum length to accept', 'integer'],
        'maximum' => [PHP_INT_MAX, 'The maximum length to accept', 'integer'],
    ];

    /**
     * @var array
     */
    protected $supportedMessages = [
        'default' => [
            'key'       => 'validator.form.number_length.error',
            'extension' => null
        ]
    ];

    /**
     * @inheritdoc
     */
    public function isValid($value)
    {
        $pattern = '/^[0-9]{' . $this->options['minimum'] . ',' . $this->options['maximum'] . '}$/';
        if (false === preg_match($pattern, $value)) {
            $this->addError(
                'default',
                1445862696,
                [$this->options['minimum'], $this->options['maximum']]
            );
        }
    }
}