Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

[Form] "Component" doc does not link to "Framework" doc #9357

Copy link
Copy link
Closed
@alsciende

Description

@alsciende
Issue body actions

The Form component documentation at http://symfony.com/doc/current/components/form.html does not explain how and why users can define their forms as PHP classes.

The main article explains how to build and use a form right inside the controller code, with no mention of Form classes or the $formFactory->createForm() method.

The "Learn more" links don't mention "Forms as classes".

The first "Learn more" article (http://symfony.com/doc/2.8/form/action_method.html) mentions "When using a form type class...", but at that point, the reader hasn't been presented with that option and, likely, does not understand the mention.

None of the "Learn more" articles, as far as I can say, explain how to build and use a form as a PHP class.

Nevertheless, the "Best Practices - Forms" article (https://symfony.com/doc/current/best_practices/forms.html) recommends "defining forms as PHP classes." (and explains how to do that in a few lines and an example).

I think there's an article missing here, right at the top of the "Learn more" section of the Form component, which explains "How to define your forms as PHP classes".

Metadata

Metadata

Assignees

No one assigned

    Labels

    FormhasPRA Pull Request has already been submitted for this issue.A Pull Request has already been submitted for this issue.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      Morty Proxy This is a proxified and sanitized view of the page, visit original site.