Movatterモバイル変換


[0]ホーム

URL:


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

Sign up
Appearance settings

consistent spelling#4671

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
weaverryan merged 16 commits intosymfony:2.3fromxabbuh:issue-3237
May 22, 2015
Merged
Show file tree
Hide file tree
Changes fromall commits
Commits
Show all changes
16 commits
Select commitHold shift + click to select a range
5b8e84d
consistency, replace "e-mail" with "email"
xabbuhJul 20, 2014
83238aa
consisteny, use "front-end" instead of "frontend" or "front end"
xabbuhJul 20, 2014
85fb0b1
consistency, replace "save-handler" with "save handler"
xabbuhJul 20, 2014
7eb1847
unify "Symfony Standard Edition" usages
xabbuhDec 19, 2014
b2d802e
use "stylesheet" instead of "Stylesheet"
xabbuhDec 19, 2014
1bd33ca
"web debug toolbar" instead of "Web Debug Toolbar"
xabbuhDec 19, 2014
f8db4b0
use "object-oriented" instead of "object oriented"
xabbuhDec 20, 2014
fd52cd3
use boolean instead of Boolean
Dec 22, 2014
9c02eda
unify EventDispatcher/event dispatcher usages
xabbuhDec 22, 2014
95c842c
use "console command" instead of "Console Command"
xabbuhDec 23, 2014
b774651
unify event subscriber usages
xabbuhDec 23, 2014
5b6895a
unify exception usages
xabbuhDec 23, 2014
bd5ca26
use "full-stack" instead of "full stack"
xabbuhDec 29, 2014
07bc4db
use "Form component" instead of "form framework"
xabbuhDec 29, 2014
6b7d536
use "Symfony Framework" instead of "Symfony framework"
xabbuhDec 29, 2014
f182121
uppercase "dependency injection"
xabbuhDec 29, 2014
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletionsbest_practices/introduction.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -4,7 +4,7 @@
The Symfony Framework Best Practices
====================================

The Symfonyframework is well-known for being *really* flexible and is used
The SymfonyFramework is well-known for being *really* flexible and is used
to build micro-sites, enterprise applications that handle billions of connections
and even as the basis for *other* frameworks. Since its release in July 2011,
the community has learned a lot about what's possible and how to do things *best*.
Expand All@@ -19,7 +19,7 @@ What is this Guide About?
-------------------------

This guide aims to fix that by describing the **best practices for developing
web apps with the Symfony full-stackframework**. These are best practices that
web apps with the Symfony full-stackFramework**. These are best practices that
fit the philosophy of the framework as envisioned by its original creator
`Fabien Potencier`_.

Expand All@@ -32,7 +32,7 @@ fit the philosophy of the framework as envisioned by its original creator

This guide is **specially suited** for:

* Websites and web applications developed with the full-stack Symfonyframework.
* Websites and web applications developed with the full-stack SymfonyFramework.

For other situations, this guide might be a good **starting point** that you can
then **extend and fit to your specific needs**:
Expand DownExpand Up@@ -62,8 +62,8 @@ Symfony to follow everything. If you are totally new to Symfony, welcome!
Start with :doc:`The Quick Tour </quick_tour/the_big_picture>` tutorial first.

We've deliberately kept this guide short. We won't repeat explanations that
you can find in the vast Symfony documentation, like discussions aboutdependency
injection or front controllers. We'll solely focus on explaining how to do
you can find in the vast Symfony documentation, like discussions aboutDependency
Injection or front controllers. We'll solely focus on explaining how to do
what you already know.

The Application
Expand Down
2 changes: 1 addition & 1 deletionbook/doctrine.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,7 @@ Databases and Doctrine

One of the most common and challenging tasks for any application
involves persisting and reading information to and from a database. Although
the Symfony full-stackframework doesn't integrate any ORM by default,
the Symfony full-stackFramework doesn't integrate any ORM by default,
the Symfony Standard Edition, which is the most widely used distribution,
comes integrated with `Doctrine`_, a library whose sole goal is to give
you powerful tools to make this easy. In this chapter, you'll learn the
Expand Down
6 changes: 3 additions & 3 deletionsbook/forms.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -198,7 +198,7 @@ it into a format that's suitable for being rendered in an HTML form.
``task`` property via the ``getTask()`` and ``setTask()`` methods on the
``Task`` class. Unless a property is public, it *must* have a "getter" and
"setter" method so that the Form component can get and put data onto the
property. For aBoolean property, you can use an "isser" or "hasser" method
property. For aboolean property, you can use an "isser" or "hasser" method
(e.g. ``isPublished()`` or ``hasReminder()``) instead of a getter (e.g.
``getPublished()`` or ``getReminder()``).

Expand DownExpand Up@@ -1526,7 +1526,7 @@ file, you can see every block needed to render a form and every default field
type.

In PHP, the fragments are individual template files. By default they are located in
the `Resources/views/Form` directory of theframework bundle (`view on GitHub`_).
the ``Resources/views/Form`` directory of theFrameworkBundle (`view on GitHub`_).

Each fragment name follows the same basic pattern and is broken up into two pieces,
separated by a single underscore character (``_``). A few examples are:
Expand DownExpand Up@@ -1867,7 +1867,7 @@ an array.

Be advised, however, that in most cases using the ``getData()`` method is
a better choice, since it returns the data (usually an object) after
it's been transformed by theform framework.
it's been transformed by theForm component.

Adding Validation
~~~~~~~~~~~~~~~~~
Expand Down
10 changes: 5 additions & 5 deletionsbook/http_fundamentals.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -266,7 +266,7 @@ the user is connecting via a secured connection (i.e. HTTPS).

The Request class also has a public ``attributes`` property, which holds
special data related to how the application works internally. For the
Symfonyframework, the ``attributes`` holds the values returned by the
SymfonyFramework, the ``attributes`` holds the values returned by the
matched route, like ``_controller``, ``id`` (if you have an ``{id}``
wildcard), and even the name of the matched route (``_route``). The
``attributes`` property exists entirely to be a place where you can
Expand DownExpand Up@@ -500,7 +500,7 @@ emails, validating user input and handling security.
The good news is that none of these problems is unique. Symfony provides
a framework full of tools that allow you to build your application, not your
tools. With Symfony, nothing is imposed on you: you're free to use the full
Symfonyframework, or just one piece of Symfony all by itself.
SymfonyFramework, or just one piece of Symfony all by itself.

.. index::
single: Symfony Components
Expand DownExpand Up@@ -542,9 +542,9 @@ regardless of how your project is developed. To name a few:
:doc:`Translation </components/translation/introduction>`
A framework for translating strings in your application.

Each one of these components is decoupled and can be used in *any*
PHP project,regardless of whether or not you use the Symfonyframework.
Every part ismade to be used if needed and replaced when necessary.
Each one of these components is decoupled and can be used in *any* PHP project,
regardless of whether or not you use the SymfonyFramework. Every part is
made to be used if needed and replaced when necessary.

.. _the-full-solution-the-symfony2-framework:

Expand Down
4 changes: 2 additions & 2 deletionsbook/installation.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -126,7 +126,7 @@ you can create Symfony applications using the alternative installation method
based on `Composer`_.

Composer is the dependency manager used by modern PHP applications and it can
also be used to create new applications based on the Symfonyframework. If you
also be used to create new applications based on the SymfonyFramework. If you
don't have installed it globally, start by reading the next section.

Installing Composer Globally
Expand DownExpand Up@@ -321,7 +321,7 @@ applications:
* The `Symfony CMF Standard Edition`_ is the best distribution to get started
with the `Symfony CMF`_ project, which is a project that makes it easier for
developers to add CMS functionality to applications built with the Symfony
framework.
Framework.
* The `Symfony REST Edition`_ shows how to build an application that provides a
RESTful API using the FOSRestBundle and several other related bundles.

Expand Down
26 changes: 14 additions & 12 deletionsbook/internals.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -55,7 +55,7 @@ On top of HttpFoundation is the :namespace:`Symfony\\Component\\HttpKernel`
component. HttpKernel handles the dynamic part of HTTP; it is a thin wrapper
on top of the Request and Response classes to standardize the way requests are
handled. It also provides extension points and tools that makes it the ideal
starting point to create aWeb framework without too much overhead.
starting point to create aweb framework without too much overhead.

It also optionally adds configurability and extensibility, thanks to the
DependencyInjection component and a powerful plugin system (bundles).
Expand DownExpand Up@@ -177,12 +177,12 @@ Event):
#. Listeners of the ``kernel.terminate`` event can perform tasks after the
Response has been served.

If anException is thrown during processing, the ``kernel.exception`` is
notified and listeners are given a chance to convert theException to a
If anexception is thrown during processing, the ``kernel.exception`` is
notified and listeners are given a chance to convert theexception into a
Response. If that works, the ``kernel.response`` event is notified; if not, the
Exception is re-thrown.

If you don't wantExceptions to be caught (for embedded requests for
If you don't wantexceptions to be caught (for embedded requests for
instance), disable the ``kernel.exception`` event by passing ``false`` as the
third argument to the ``handle()`` method.

Expand DownExpand Up@@ -238,8 +238,8 @@ add the following code at the beginning of your listener method::

.. tip::

If you are not yet familiar with the Symfony EventDispatcher, read the
:doc:`EventDispatcher component documentation </components/event_dispatcher/introduction>`
If you are not yet familiar with the Symfony EventDispatcher component,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

I would like "Event Dispatcher component".

Copy link
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Do you mean without the Symfony prefix?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

I mean with a space in the word.

Copy link
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Well, that's not really consistent with how we use component names otherwise (e.g. HttpFoundation, DependencyInjection, etc.).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

read:doc:`its documentation </components/event_dispatcher/introduction>`
section first.

.. index::
Expand DownExpand Up@@ -351,7 +351,7 @@ The FrameworkBundle registers several listeners:
Collects data for the current request.

:class:`Symfony\\Bundle\\WebProfilerBundle\\EventListener\\WebDebugToolbarListener`
Injects theWeb Debug Toolbar.
Injects theweb debug toolbar.

:class:`Symfony\\Component\\HttpKernel\\EventListener\\ResponseListener`
Fixes the Response ``Content-Type`` based on the request format.
Expand DownExpand Up@@ -396,7 +396,7 @@ forwards the ``Request`` to a given Controller (the value of the
``class::method`` notation).

A listener on this event can create and set a ``Response`` object, create
and set a new ``Exception`` object, or do nothing::
and set a new ``Exception`` object or do nothing::

use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
use Symfony\Component\HttpFoundation\Response;
Expand DownExpand Up@@ -433,8 +433,10 @@ and set a new ``Exception`` object, or do nothing::
.. index::
single: EventDispatcher

The EventDispatcher
-------------------
.. _the-eventdispatcher:

The EventDispatcher Component
-----------------------------

The EventDispatcher is a standalone component that is responsible for much
of the underlying logic and flow behind a Symfony request. For more information,
Expand All@@ -455,7 +457,7 @@ enhance performance; use it in the production environment to explore problems
after the fact.

You rarely have to deal with the profiler directly as Symfony provides
visualizer tools like theWeb Debug Toolbar and theWeb Profiler. If you use
visualizer tools like theweb debug toolbar and theweb profiler. If you use
the Symfony Standard Edition, the profiler, the web debug toolbar, and the
web profiler are all already configured with sensible settings.

Expand All@@ -481,7 +483,7 @@ bottom of all pages. It displays a good summary of the profiling data that
gives you instant access to a lot of useful information when something does
not work as expected.

If the summary provided by theWeb Debug Toolbar is not enough, click on the
If the summary provided by theweb debug toolbar is not enough, click on the
token link (a string made of 13 random characters) to access the Web Profiler.

.. note::
Expand Down
4 changes: 2 additions & 2 deletionsbook/page_creation.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -763,7 +763,7 @@ of the most common elements of a bundle:
Contains the controllers of the bundle (e.g. ``RandomController.php``).

``DependencyInjection/``
Holds certaindependency injection extension classes, which may import service
Holds certainDependency Injection Extension classes, which may import service
configuration, register compiler passes or more (this directory is not
necessary).

Expand DownExpand Up@@ -1082,7 +1082,7 @@ in mind:
and ``vendor/`` (third-party code) (there's also a ``bin/`` directory that's
used to help updated vendor libraries);

* Each feature in Symfony (including the Symfonyframework core) is organized
* Each feature in Symfony (including the SymfonyFramework core) is organized
into a *bundle*, which is a structured set of files for that feature;

* The **configuration** for each bundle lives in the ``Resources/config``
Expand Down
2 changes: 1 addition & 1 deletionbook/performance.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -46,7 +46,7 @@ your ``php.ini`` configuration.
Use Composer's Class Map Functionality
--------------------------------------

By default, the Symfonystandard edition uses Composer's autoloader
By default, the SymfonyStandard Edition uses Composer's autoloader
in the `autoload.php`_ file. This autoloader is easy to use, as it will
automatically find any new classes that you've placed in the registered
directories.
Expand Down
4 changes: 2 additions & 2 deletionsbook/propel.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -288,8 +288,8 @@ from cheapest to most expensive. From inside a controller, do the following::
->orderByPrice()
->find();

In one line, you get your products in a powerfulorientedobject way. No need
to waste your time with SQL or whatever, Symfony offers fully objectoriented
In one line, you get your products in a powerful object-oriented way. No need
to waste your time with SQL or whatever, Symfony offers fully object-oriented
programming and Propel respects the same philosophy by providing an awesome
abstraction layer.

Expand Down
2 changes: 1 addition & 1 deletionbook/routing.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -1419,7 +1419,7 @@ In an upcoming section, you'll learn how to generate URLs from inside templates.

.. tip::

If thefrontend of your application uses Ajax requests, you might want
If thefront-end of your application uses Ajax requests, you might want
to be able to generate URLs in JavaScript based on your routing configuration.
By using the `FOSJsRoutingBundle`_, you can do exactly that:

Expand Down
4 changes: 2 additions & 2 deletionsbook/service_container.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -461,7 +461,7 @@ In other words, a service container extension configures the services for
a bundle on your behalf. And as you'll see in a moment, the extension provides
a sensible, high-level interface for configuring the bundle.

Take the FrameworkBundle - the core Symfonyframework bundle - as an
Take the FrameworkBundle - the core SymfonyFramework bundle - as an
example. The presence of the following code in your application configuration
invokes the service container extension inside the FrameworkBundle:

Expand DownExpand Up@@ -516,7 +516,7 @@ can handle the ``framework`` configuration directive. The extension in question,
which lives in the FrameworkBundle, is invoked and the service configuration
for the FrameworkBundle is loaded. If you remove the ``framework`` key
from your application configuration file entirely, the core Symfony services
won't be loaded. The point is that you're in control: the Symfonyframework
won't be loaded. The point is that you're in control: the SymfonyFramework
doesn't contain any magic or perform any actions that you don't have control
over.

Expand Down
2 changes: 1 addition & 1 deletionbook/templating.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -1345,7 +1345,7 @@ subdirectory.
Overriding Core Templates
~~~~~~~~~~~~~~~~~~~~~~~~~

Since the Symfonyframework itself is just a bundle, core templates can be
Since the SymfonyFramework itself is just a bundle, core templates can be
overridden in the same way. For example, the core TwigBundle contains
a number of different "exception" and "error" templates that can be overridden
by copying each from the ``Resources/views/Exception`` directory of the
Expand Down
4 changes: 2 additions & 2 deletionsbook/testing.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -455,8 +455,8 @@ Accessing the Container

It's highly recommended that a functional test only tests the Response. But
under certain very rare circumstances, you might want to access some internal
objects to write assertions. In such cases, you can access thedependency
injection container::
objects to write assertions. In such cases, you can access theDependency
Injection Container::

$container = $client->getContainer();

Expand Down
4 changes: 2 additions & 2 deletionsbook/translation.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -27,7 +27,7 @@ into the language of the user::
*country* code (e.g. ``fr_FR`` for French/France) is recommended.

In this chapter, you'll learn how to use the Translation component in the
Symfonyframework. You can read the
SymfonyFramework. You can read the
:doc:`Translation component documentation </components/translation/usage>`
to learn even more. Overall, the process has several steps:

Expand DownExpand Up@@ -573,7 +573,7 @@ the framework:
Translating Constraint Messages
-------------------------------

If you're using validation constraints with theform framework, then translating
If you're using validation constraints with theForm component, then translating
the error messages is easy: simply create a translation resource for the
``validators`` :ref:`domain <using-message-domains>`.

Expand Down
2 changes: 2 additions & 0 deletionscomponents/config/definition.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -99,6 +99,8 @@ node definition. Node types are available for:

* scalar (generic type that includes booleans, strings, integers, floats and ``null``)
* boolean
* scalar
* boolean
* integer (new in 2.2)
* float (new in 2.2)
* enum (new in 2.1) (similar to scalar, but it only allows a finite set of values)
Expand Down
2 changes: 1 addition & 1 deletioncomponents/console/helpers/dialoghelper.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -95,7 +95,7 @@ convenient for passwords::
When you ask for a hidden response, Symfony will use either a binary, change
stty mode or use another trick to hide the response. If none is available,
it will fallback and allow the response to be visible unless you pass ``false``
as the third argument like in the example above. In this case, a RuntimeException
as the third argument like in the example above. In this case, a``RuntimeException``
would be thrown.

Validating the Answer
Expand Down
10 changes: 5 additions & 5 deletionscomponents/dependency_injection/compilation.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -207,7 +207,7 @@ The XML version of the config would then look like this:

.. note::

In the Symfony fullstackframework there is a base Extension class which
In the Symfony full-stackFramework there is a base Extension class which
implements these methods as well as a shortcut method for processing the
configuration. See :doc:`/cookbook/bundles/extension` for more details.

Expand DownExpand Up@@ -347,9 +347,9 @@ will then be called when the container is compiled::

.. note::

Compiler passes are registered differently if you are using the full
stackframework, see :doc:`/cookbook/service_container/compiler_passes`
formore details.
Compiler passes are registered differently if you are using the full-stack
framework, see :doc:`/cookbook/service_container/compiler_passes` for
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

uppercase the F?Framework

or should it be:
Symfony full-stack Framework and
full stack framework?

more details.

Controlling the Pass Ordering
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand DownExpand Up@@ -510,5 +510,5 @@ to see if the files have changed, if they have the cache will be considered stal

.. note::

In the fullstack framework the compilation and caching of the container
In the full-stack framework the compilation and caching of the container
is taken care of for you.
6 changes: 3 additions & 3 deletionscomponents/dependency_injection/tags.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -173,9 +173,9 @@ run when the container is compiled::

.. note::

Compiler passes are registered differently if you are using the full
stackframework. See :doc:`/cookbook/service_container/compiler_passes`
formore details.
Compiler passes are registered differently if you are using the full-stack
framework. See :doc:`/cookbook/service_container/compiler_passes` for
more details.

Adding additional Attributes on Tags
------------------------------------
Expand Down
6 changes: 3 additions & 3 deletionscomponents/dependency_injection/workflow.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -8,11 +8,11 @@ In the preceding pages of this section, there has been little to say about
where the various files and classes should be located. This is because this
depends on the application, library or framework in which you want to use
the container. Looking at how the container is configured and built in the
Symfony fullstackframework will help you see how this all fits together,
whether you are using the fullstack framework or looking to use the service
Symfony full-stackFramework will help you see how this all fits together,
whether you are using the full-stack framework or looking to use the service
container in another application.

The fullstack framework uses the HttpKernel component to manage the loading
The full-stack framework uses the HttpKernel component to manage the loading
of the service container configuration from the application and bundles and
also handles the compilation and caching. Even if you are not using HttpKernel,
it should give you an idea of one way of organizing configuration in a modular
Expand Down
Loading

[8]ページ先頭

©2009-2025 Movatter.jp