symfony/symfony-docsPublic

NotificationsYou must be signed in to change notification settings
Fork5.3k
Star2.3k

Commit73d241a

committed

Merge branch '4.1'

* 4.1: review doc chapter for belittling words review getting started chapter for belittling words review best practice chapter for belittling words

2 parents9be63a9 +0b5d88c commit73d241aCopy full SHA for 73d241a

File tree

110 files changed

+249

-249

lines changed

best_practices
- business-logic.rst
- controllers.rst
- introduction.rst
- templates.rst
- tests.rst
bundles
- best_practices.rst
- override.rst
configuration
- configuration_organization.rst
- environments.rst
- front_controllers_and_kernel.rst
- micro_kernel_trait.rst
- multiple_kernels.rst
- override_dir_structure.rst
console
- input.rst
- lazy_commands.rst
- style.rst
contributing
- code
  - git.rst
  - reproducer.rst
- community
  - review-comments.rst
controller.rst
controller
- error_pages.rst
- service.rst
- soap_web_service.rst
create_framework
- event_dispatcher.rst
- front_controller.rst
- http_foundation.rst
- http_kernel_controller_resolver.rst
- http_kernel_httpkernel_class.rst
- http_kernel_httpkernelinterface.rst
- introduction.rst
- routing.rst
- templating.rst
- unit_testing.rst
doctrine
- associations.rst
- dbal.rst
- event_listeners_subscribers.rst
- multiple_entity_managers.rst
- registration_form.rst
email
- dev_environment.rst
- spool.rst
event_dispatcher
- before_after_filters.rst
form
- bootstrap4.rst
- create_custom_field_type.rst
- data_transformers.rst
- direct_submit.rst
- embedded.rst
- events.rst
- form_collections.rst
- form_customization.rst
- form_themes.rst
- inherit_data_option.rst
- type_guesser.rst
- without_class.rst
frontend/encore
- advanced-config.rst
- faq.rst
- page-specific-assets.rst
- versioning.rst
- vuejs.rst
http_cache
- expiration.rst
- validation.rst
- varnish.rst
introduction
- from_flat_php_to_symfony2.rst
- http_fundamentals.rst
logging
- channels_handlers.rst
- formatter.rst
- monolog_email.rst
- processors.rst
quick_tour
- flex_recipes.rst
- the_architecture.rst
- the_big_picture.rst
routing.rst
routing
- custom_route_loader.rst
- optional_placeholders.rst
security
- _supportsToken.rst.inc
- access_control.rst
- auth_providers.rst
- form_login_setup.rst
- guard_authentication.rst
- impersonating_user.rst
- json_login_setup.rst
- ldap.rst
- multiple_guard_authenticators.rst
service_container
- 3.3-di-changes.rst
- injection_types.rst
- lazy_services.rst
- optional_dependencies.rst
- parameters.rst
- parent_services.rst
- request.rst
session
- php_bridge.rst
- proxy_examples.rst
- sessions_directory.rst
setup.rst
setup
- _vendor_deps.rst.inc
- built_in_web_server.rst
- bundles.rst
- file_permissions.rst
- flex.rst
- upgrade_major.rst
- upgrade_patch.rst
- web_server_configuration.rst
templating.rst
templating
- PHP.rst
- formats.rst
- render_without_controller.rst
testing
- doctrine.rst
validation
- custom_constraint.rst
- groups.rst
- raw_values.rst
- translations.rst

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

110 files changed

+249

-249

lines changed

`‎best_practices/business-logic.rst‎`

Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -110,7 +110,7 @@ Both formats have the same performance, so this is ultimately a matter of`
`110`	`110`	`personal taste.`
`111`	`111`
`112`	`112`	`We recommend YAML because it's friendly to newcomers and concise. You can`
`113`		`-ofcourse use whatever format youlike.`
	`113`	`+use anyofthe other formats if youprefer another format.`
`114`	`114`
`115`	`115`	`Using a Persistence Layer`
`116`	`116`	`-------------------------`

`‎best_practices/controllers.rst‎`

Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -181,7 +181,7 @@ When Things Get More Advanced`
`181`	`181`
`182`	`182`	`The above example works without any configuration because the wildcard name`
`183`	`183`	``{id}`` matches the name of the property on the entity. If this isn't true, or
`184`		`-if you have even more complex logic,the easiest thing to doisjust query for`
	`184`	`+if you have even more complex logic,your best choiceisto query for`
`185`	`185`	`the entity manually. In our application, we have this situation in`
`186`	`186`	``CommentController``::
`187`	`187`

`‎best_practices/introduction.rst‎`

Lines changed: 2 additions & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -49,8 +49,8 @@ It's also a moving target that will continue to improve.`
`49`	`49`
`50`	`50`	`Keep in mind that these are optional recommendations that you and your`
`51`	`51`	`team may or may not follow to develop Symfony applications. If you want to`
`52`		`-continue using your own best practices and methodologies, you canof course`
`53`		`-do it. Symfony is flexible enough to adapt to your needs. That will never`
	`52`	`+continue using your own best practices and methodologies, you canstill do`
	`53`	`+that. Symfony is flexible enough to adapt to your needs. That will never`
`54`	`54`	`change.`
`55`	`55`
`56`	`56`	`Who this Book Is for (Hint: It's not a Tutorial)`

`‎best_practices/templates.rst‎`

Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -58,7 +58,7 @@ Twig Extensions`
`58`	`58`
`59`	`59`	Our application needs a custom ``md2html`` Twig filter so that we can transform
`60`	`60`	`the Markdown contents of each post into HTML. To do this, create a new`
`61`		-``Markdown`` class that will be used later by the Twig extension. Itjustneeds
	`61`	+``Markdown`` class that will be used later by the Twig extension. It needs
`62`	`62`	`to define one single method to transform Markdown content into HTML::`
`63`	`63`
`64`	`64`	`namespace App\Utils;`

`‎best_practices/tests.rst‎`

Lines changed: 2 additions & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -27,8 +27,8 @@ functional tests, you can quickly spot any big errors before you deploy them:`
`27`	`27`	`Define a functional test that at least checks if your application pages`
`28`	`28`	`are successfully loading.`
`29`	`29`
`30`		`-A functional test like this is simple toimplement thanks to`
`31`		-:ref:`PHPUnit data providers<testing-data-providers>`::
	`30`	+:ref:`PHPUnit data providers<testing-data-providers>` help youimplement
	`31`	`+functional tests::`
`32`	`32`
`33`	`33`	`// tests/ApplicationAvailabilityFunctionalTest.php`
`34`	`34`	`namespace App\Tests;`

`‎bundles/best_practices.rst‎`

Lines changed: 4 additions & 3 deletions

Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@ vendor segment, followed by zero or more category segments, and it ends with the`
`23`	`23`	namespace short name, which must end with ``Bundle``.
`24`	`24`
`25`	`25`	`A namespace becomes a bundle as soon as you add a bundle class to it. The`
`26`		`-bundle class name must follow thesesimplerules:`
	`26`	`+bundle class name must follow these rules:`
`27`	`27`
`28`	`28`	`* Use only alphanumeric characters and underscores;`
`29`	`29`	`* Use a StudlyCaps name (i.e. camelCase with the first letter uppercased);`
`@@ -467,8 +467,9 @@ Retrieve the configuration parameters in your code from the container::`
`467`	`467`
`468`	`468`	`$container->getParameter('acme_blog.author.email');`
`469`	`469`
`470`		`-Even if this mechanism is simple enough, you should consider using the more`
`471`		-advanced:doc:`semantic bundle configuration</bundles/configuration>`.
	`470`	`+While this mechanism requires the least effort, you should consider using the`
	`471`	+more advanced:doc:`semantic bundle configuration</bundles/configuration>` to
	`472`	`+make your configuration more robust.`
`472`	`473`
`473`	`474`	`Versioning`
`474`	`475`	`----------`

`‎bundles/override.rst‎`

Lines changed: 1 addition & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -68,7 +68,7 @@ the routes from any bundle, then they must be manually imported from somewhere`
`68`	`68`	in your application (e.g. ``config/routes.yaml``).
`69`	`69`
`70`	`70`	`The easiest way to "override" a bundle's routing is to never import it at`
`71`		`-all. Instead of importing a third-party bundle's routing,simplycopy`
	`71`	`+all. Instead of importing a third-party bundle's routing, copy`
`72`	`72`	`that routing file into your application, modify it, and import it instead.`
`73`	`73`
`74`	`74`	`Controllers`

`‎configuration/configuration_organization.rst‎`

Lines changed: 4 additions & 4 deletions

Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@ How to Organize Configuration Files`
`5`	`5`	`===================================`
`6`	`6`
`7`	`7`	The Symfony skeleton defines three:doc:`execution environments</configuration/environments>`
`8`		-called ``dev``, ``prod`` and ``test``. An environmentsimplyrepresents a way
	`8`	+called ``dev``, ``prod`` and ``test``. An environment represents a way
`9`	`9`	`to execute the same codebase with different configurations.`
`10`	`10`
`11`	`11`	`In order to select the configuration file to load for each environment, Symfony`
`@@ -129,9 +129,9 @@ Global Configuration Files`
`129`	`129`
`130`	`130`	`Some system administrators may prefer to store sensitive parameters in files`
`131`	`131`	`outside the project directory. Imagine that the database credentials for your`
`132`		-website are stored in the ``/etc/sites/mysite.com/parameters.yaml`` file.Loading
`133`		`-this file is as simple asindicating the full file path when importing it from`
`134`		`-any other configuration file:`
	`132`	+website are stored in the ``/etc/sites/mysite.com/parameters.yaml`` file.You
	`133`	`+can load files from outside the project folder byindicating the full file path`
	`134`	`+when importing it fromany other configuration file:`
`135`	`135`
`136`	`136`	`..configuration-block::`
`137`	`137`

`‎configuration/environments.rst‎`

Lines changed: 2 additions & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -203,7 +203,7 @@ Creating a new Environment`
`203`	`203`	`--------------------------`
`204`	`204`
`205`	`205`	`Since an environment is nothing more than a string that corresponds to a set of`
`206`		`-configuration,creating a new environment is quite easy.`
	`206`	`+configuration,you can also create your own environments for specific purposes.`
`207`	`207`
`208`	`208`	`Suppose, for example, that before deployment, you need to benchmark your`
`209`	`209`	`application. One way to benchmark the application is to use near-production`
`@@ -359,7 +359,7 @@ includes the following:`
`359`	`359`
`360`	`360`	`..note::`
`361`	`361`
`362`		`- You caneasilychange the directory location and name. For more information`
	`362`	`+ You can change the directory location and name. For more information`
`363`	`363`	read the article:doc:`/configuration/override_dir_structure`.
`364`	`364`
`365`	`365`	`Going further`

`‎configuration/front_controllers_and_kernel.rst‎`

Lines changed: 2 additions & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,7 @@ You can choose the front controller that's used by adding it in the URL, like:`
`51`	`51`	`http://localhost/index.php/some/path/...`
`52`	`52`
`53`	`53`	`As you can see, this URL contains the PHP script to be used as the front`
`54`		`-controller. You can use that toeasilyswitch to a custom made front controller`
	`54`	`+controller. You can use that to switch to a custom made front controller`
`55`	`55`	that is located in the ``public/`` directory.
`56`	`56`
`57`	`57`	`..seealso::`
`@@ -123,7 +123,7 @@ controller to make use of the new kernel.`
`123`	`123`	`The Environments`
`124`	`124`	`----------------`
`125`	`125`
`126`		-Asjustmentioned, the ``Kernel`` has to implement another method -
	`126`	+As mentioned above, the ``Kernel`` has to implement another method -
`127`	`127`	:method:`Symfony\\Bundle\\FrameworkBundle\\Kernel\\MicroKernelTrait::configureContainer`.
`128`	`128`	`This method is responsible for loading the application's configuration from the`
`129`	`129`	`right environment.`

0 commit comments

Comments

(0)

Movatterモバイル変換

Navigation Menu

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Commit73d241a

File tree

110 files changed

Some content is hidden

110 files changed

`‎best_practices/business-logic.rst‎`

`‎best_practices/controllers.rst‎`

`‎best_practices/introduction.rst‎`

`‎best_practices/templates.rst‎`

`‎best_practices/tests.rst‎`

`‎bundles/best_practices.rst‎`

`‎bundles/override.rst‎`

`‎configuration/configuration_organization.rst‎`

`‎configuration/environments.rst‎`

`‎configuration/front_controllers_and_kernel.rst‎`

0 commit comments