Form组件

use Symfony\Component\Form\Forms;
 
$formFactory = Forms::createFormFactory();

$form->handleRequest();

use Symfony\Component\Form\Forms;
use Symfony\Component\HttpFoundation\Session\Session;
use Symfony\Component\Form\Extension\Csrf\CsrfExtension;
use Symfony\Component\Security\Csrf\TokenStorage\SessionTokenStorage;
use Symfony\Component\Security\Csrf\TokenGenerator\UriSafeTokenGenerator;
use Symfony\Component\Security\Csrf\CsrfTokenManager;
 
// create a Session object from the HttpFoundation component
// 从HttpFoundation组件中创建一个Session对象
$session = new Session();
 
$csrfGenerator = new UriSafeTokenGenerator();
$csrfStorage = new SessionTokenStorage($session);
$csrfManager = new CsrfTokenManager($csrfGenerator, $csrfStorage);
 
$formFactory = Forms::createFormFactoryBuilder()
// ...
->addExtension(new CsrfExtension($csrfStorage))
->getFormFactory();

{
"require": {
"symfony/twig-bridge": "~3.0"
}
}

use Symfony\Component\Form\Forms;
use Symfony\Bridge\Twig\Extension\FormExtension;
use Symfony\Bridge\Twig\Form\TwigRenderer;
use Symfony\Bridge\Twig\Form\TwigRendererEngine;
 
// the Twig file that holds all the default markup for rendering forms
// this file comes with TwigBridge
// TwigBridge自带的、拥有表单渲染所需的全部默认的HTML标记
$defaultFormTheme = 'form_div_layout.html.twig';
 
$vendorDir = realpath(__DIR__.'/../vendor');
// the path to TwigBridge library so Twig can locate the
// form_div_layout.html.twig file
// TwigBride类库的路径，用于让Twig锁定form_div_layout.html.twig文件
$appVariableReflection = new \ReflectionClass('\Symfony\Bridge\Twig\AppVariable');
$vendorTwigBridgeDir = dirname($appVariableReflection->getFileName());
// the path to your other templates
// 你自己的模板之路径
$viewsDir = realpath(__DIR__.'/../views');
 
$twig = new Twig_Environment(new Twig_Loader_Filesystem(array(
$viewsDir,
$vendorTwigBridgeDir.'/Resources/views/Form',
)));
$formEngine = new TwigRendererEngine(array($defaultFormTheme));
$formEngine->setEnvironment($twig);
 
// ... (see the previous CSRF Protection section for more information)
// ...（参考前述CSRF防护小节以了解更多）
// add the FormExtension to Twig
// 添加FormExtension到Twig
$twig->addExtension(
new FormExtension(new TwigRenderer($formEngine, $csrfManager))
);
 
// create your form factory as normal
// 按照常规创建form factory
$formFactory = Forms::createFormFactoryBuilder()
// ...
->getFormFactory();

{
"require": {
"symfony/translation": "~3.0",
"symfony/config": "~3.0"
}
}

use Symfony\Component\Form\Forms;
use Symfony\Component\Translation\Translator;
use Symfony\Component\Translation\Loader\XliffFileLoader;
use Symfony\Bridge\Twig\Extension\TranslationExtension;
 
// create the Translator 创建Translator
$translator = new Translator('en');
// somehow load some translations into it 加载翻译信息源到translator
$translator->addLoader('xlf', new XliffFileLoader());
$translator->addResource(
'xlf',
__DIR__.'/path/to/translations/messages.en.xlf',
'en'
);
 
// add the TranslationExtension (gives us trans and transChoice filters)
// 添加Twig模板所需之TranslationExtension（以便能够使用|trans和|transChoice调节器）
$twig->addExtension(new TranslationExtension($translator));
 
$formFactory = Forms::createFormFactoryBuilder()
// ...
->getFormFactory();

{
"require": {
"symfony/validator": "~3.0"
}
}

use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Validator\ValidatorExtension;
use Symfony\Component\Validator\Validation;
 
$vendorDir = realpath(__DIR__.'/../vendor');
$vendorFormDir = $vendorDir.'/symfony/form';
$vendorValidatorDir = $vendorDir.'/symfony/validator';
 
// create the validator - details will vary
// 创建一个validator - 具体可以不同
$validator = Validation::createValidator();
 
// there are built-in translations for the core error messages
// 对于核心错误信息已经有内置的翻译
$translator->addResource(
'xlf',
$vendorFormDir.'/Resources/translations/validators.en.xlf',
'en',
'validators'
);
$translator->addResource(
'xlf',
$vendorValidatorDir.'/Resources/translations/validators.en.xlf',
'en',
'validators'
);
 
$formFactory = Forms::createFormFactoryBuilder()
// ...
->addExtension(new ValidatorExtension($validator))
->getFormFactory();

{{ form_start(form) }}
{{ form_widget(form) }}
 
<input type="submit" />
{{ form_end(form) }}

$form = ...;
 
// ...
 
// a FormErrorIterator instance, but only errors attached to this
// form level (e.g. "global errors)
// FormErrorIterator实例，包含了整个表单（form level）的错误
$errors = $form->getErrors();
 
// a FormErrorIterator instance, but only errors attached to the
// "firstName" field
// FormErrorIterator实例，仅含有指定字段的错误
$errors = $form['firstName']->getErrors();
 
// a FormErrorIterator instance in a flattened structure
// use getOrigin() to determine the form causing the error
// FormErrorIterator实例，是扁平数组结构
// 使用getOrigin()方法来找出导致错误的表单
$errors = $form->getErrors(true);
 
// a FormErrorIterator instance representing the form tree structure
// FormErrorIterator实例，以表单树状结构来呈现
$errors = $form->getErrors(true, false);