8000 Update translation.rst by solazs · Pull Request #4989 · symfony/symfony-docs · GitHub
[go: up one dir, main page]

Skip to content

Update translation.rst #4989

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 our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 82 commits into from
Closed
Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
82 commits
Select commit Hold shift + click to select a range
265604b
[#4243] Tweaks to the new var-dumper component
weaverryan Nov 5, 2014
09a6fd7
[Form] Add entity manager instance support for em option
GeLoLabs Oct 18, 2014
1a29f24
typos in the var-dumper component
nicolas-grekas Nov 8, 2014
9caea6f
feature #4336 [Form] Add entity manager instance support for em optio…
weaverryan Nov 13, 2014
3329bd2
feature #4424 [#4243] Tweaks to the new var-dumper component (weaverr…
weaverryan Nov 13, 2014
0d5cb0d
Merge branch '2.7'
weaverryan Nov 13, 2014
0c92fab
Merge branch '2.7'
weaverryan Nov 13, 2014
51224e9
Merge branch '2.7'
wouterj Nov 19, 2014
d6ce29f
Merge branch '2.7'
weaverryan Nov 24, 2014
f24b645
Merge branch '2.7'
weaverryan Nov 24, 2014
d969e8b
Merge branch '2.7'
weaverryan Nov 25, 2014
0fb81cc
Merge branch '2.7'
weaverryan Nov 25, 2014
6b73990
Merge branch '2.7'
wouterj Dec 1, 2014
8099ac1
Merge branch '2.7'
weaverryan Dec 4, 2014
486baf8
Merge branch '2.7'
wouterj Dec 7, 2014
d921dcd
Merge branch '2.7'
wouterj Dec 7, 2014
f0ac8bb
Merge branch '2.7'
weaverryan Dec 7, 2014
3454883
Merge branch '2.7'
weaverryan Dec 7, 2014
d30dc9e
Merge remote-tracking branch 'origin/master'
weaverryan Dec 8, 2014
2d1c336
Merge branch '2.7'
weaverryan Dec 11, 2014
e539bd1
Merge branch '2.7'
weaverryan Dec 20, 2014
0906e0c
Merge branch '2.7'
weaverryan Dec 21, 2014
4056218
Merge branch '2.7'
weaverryan Dec 23, 2014
07aa543
Merge branch '2.7'
weaverryan Dec 26, 2014
2fcebc1
Merge branch '2.7'
wouterj Dec 28, 2014
8131844
Merge branch '2.7'
weaverryan Dec 29, 2014
cb6f846
Merge branch '2.7'
weaverryan Dec 31, 2014
9e5fc6c
Merge branch '2.7'
weaverryan Dec 31, 2014
56db7af
Merge branch '2.7'
weaverryan Dec 31, 2014
27296ad
Merge branch '2.7'
wouterj Dec 31, 2014
353995e
Merge branch '2.7'
weaverryan Jan 1, 2015
fcfea43
Merge branch '2.7'
wouterj Jan 2, 2015
6ef6a04
Merge branch '2.7'
weaverryan Jan 3, 2015
bcab77b
bump Symfony requirements to PHP 5.5
xabbuh Jan 4, 2015
d33b78b
don't describe removed usage of Yaml::parse()
xabbuh Jan 4, 2015
6f9832d
Merge branch '2.7'
wouterj Jan 4, 2015
42d2b15
Merge branch '2.7'
weaverryan Jan 4, 2015
7d2f0f3
Removed 2.5 versionadded as its deprecated
wouterj Jan 4, 2015
92b10b1
bug #4758 [Components][Yaml] don't describe removed usage of Yaml::pa…
wouterj Jan 8, 2015
032a6b4
Merge branch '2.7'
wouterj Jan 8, 2015
c859790
Fixed markup
wouterj Jan 9, 2015
9919bca
Revert "Fixed markup"
wouterj Jan 9, 2015
ca3b4c8
feature #4753 bump Symfony requirements to PHP 5.5 (xabbuh)
wouterj Jan 16, 2015
a17bdd7
Merge branch '2.7'
wouterj Jan 16, 2015
dc25c65
minor #4769 [2.7] Removed 2.5 versionadded as its deprecated (WouterJ)
weaverryan Jan 16, 2015
050f7ce
Documented true regex
wouterj Jan 18, 2015
7363c9b
Merge branch '2.6' into 2.7
weaverryan Jan 18, 2015
907ee0d
Merge branch '2.7'
weaverryan Jan 18, 2015
728205f
Replaced setDefaultOptions by the new configureOptions method
peterrehm Jan 6, 2015
74d2e30
feature #4786 Replaced setDefaultOptions by the new configureOptions …
weaverryan Jan 21, 2015
885c378
[#4786] Adding a few versionadded's for the changed method name
weaverryan Jan 21, 2015
e4d22f0
added documentation for the new absolute_url() and relative_path() Tw…
fabpot Jan 10, 2015
6e6bae8
Small grammar-ish fix
wouterj Jan 25, 2015
6c498d4
feature #4805 added documentation for the new absolute_url() and rela…
weaverryan Jan 25, 2015
8fe9069
added documentation for the new absolute_url() and relative_path() Tw…
fabpot Jan 10, 2015
a5addaa
[#4805] Adding versionadded
weaverryan Jan 25, 2015
61ea87b
Merge branch '2.6' into 2.7
weaverryan Jan 25, 2015
c33b371
Merge branch '2.7'
weaverryan Jan 25, 2015
7c07a44
Merge branch '2.6' into 2.7
weaverryan Jan 25, 2015
99e2996
Merge branch '2.7'
weaverryan Jan 25, 2015
a57db5b
feature #4879 Documented true regex (WouterJ)
weaverryan Jan 30, 2015
39f6876
Merge branch '2.6' into 2.7
weaverryan Jan 30, 2015
714f630
Merge branch '2.7'
weaverryan Jan 30, 2015
bc29584
Merge branch '2.6' into 2.7
wouterj Jan 30, 2015
87eb36c
Merge branch '2.7'
wouterj Jan 30, 2015
d71fe6d
Merge branch '2.6' into 2.7
wouterj Feb 1, 2015
c0f9f67
Merge branch '2.7'
wouterj Feb 1, 2015
78f4f69
Merge branch '2.6' into 2.7
wouterj Feb 1, 2015
ebe2706
Added January changelog
wouterj Feb 1, 2015
ad97700
Merge branch '2.7'
wouterj Feb 1, 2015
6fd286b
Added January changelog
wouterj Feb 1, 2015
7f8d6bd
Merge branch '2.6' into 2.7
wouterj Feb 1, 2015
8d56ad7
Merge branch '2.7'
wouterj Feb 1, 2015
ef39a01
Remove diff
wouterj Feb 1, 2015
70902f5
Merge branch '2.6' into 2.7
weaverryan Feb 1, 2015
81e8c13
Merge branch '2.7'
weaverryan Feb 1, 2015
b7f7421
Update translation.rst
solazs Feb 11, 2015
94914c5
Review note about setting the translator locale in a controller.
solazs Feb 15, 2015
d5566b1
Finaly touches on translation locale setting note
solazs Feb 20, 2015
fdae4bc
Merge branch 'master' of https://github.com/solazs/symfony-docs into …
solazs Mar 6, 2015
cbc91e3
Remove useless setLocale() call and add code block with locale setter
solazs Mar 6, 2015
30b4dfa
Revert "Merge branch 'master' of https://github.com/solazs/symfony-do…
solazs Mar 6, 2015
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
4 changes: 2 additions & 2 deletions book/controller.rst
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Controllers are also called *actions*.

This controller is pretty straightforward:

* *line 4*: Symfony takes advantage of PHP 5.3 namespace functionality to
* *line 4*: Symfony takes advantage of PHP's namespace functionality to
namespace the entire controller class. The ``use`` keyword imports the
``Response`` class, which the controller must return.

Expand Down Expand Up @@ -559,7 +559,7 @@ Symfony will automatically return a 500 HTTP response code.
throw new \Exception('Something went wrong!');

In every case, an error page is shown to the end user and a full debug
error page is shown to the developer (i.e. when you're using ``app_dev.php`` -
error page is shown to the developer (i.e. when you're using ``app_dev.php`` -
see :ref:`page-creation-environments`).

You'll want to customize the error page your user sees. To do that, see the
Expand Down
18 changes: 2 additions & 16 deletions book/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,6 @@ Using the Symfony Installer is the only recommended way to create new Symfony
applications. This installer is a PHP application that has to be installed
only once and then it can create any number of Symfony applications.

.. note::

The installer requires PHP 5.4 or higher. If you still use the legacy
PHP 5.3 version, you cannot use the Symfony Installer. Read the
:ref:`book-creating-applications-without-the-installer` section to learn how
to proceed.

Depending on your operating system, the installer must be installed in different
ways.

Expand Down Expand Up @@ -107,9 +100,8 @@ to use for your projects.
Creating Symfony Applications without the Installer
---------------------------------------------------

If you still use PHP 5.3, or if you can't execute the installer for any reason,
you can create Symfony applications using the alternative installation method
based on `Composer`_.
If you can't execute the installer for any reason, 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 Symfony framework. If you
Expand Down Expand Up @@ -168,12 +160,6 @@ possible solutions depending on your operating system. All of them are
explained in the :ref:`Setting up Permissions <book-installation-permissions>`
section.

.. note::

PHP's internal web server is available in PHP 5.4 or higher versions. If you
still use the legacy PHP 5.3 version, you'll have to configure a *virtual host*
in your web server.

The ``server:run`` command is only suitable while developing the application. In
order to run Symfony applications on production servers, you'll have to configure
your `Apache`_ or `Nginx`_ web server as explained in
Expand Down
2 changes: 0 additions & 2 deletions book/security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -487,8 +487,6 @@ else, you'll want to encode their passwords. The best algorithm to use is
// ...
));

.. include:: /cookbook/security/_ircmaxwell_password-compat.rst.inc

Of course, your user's passwords now need to be encoded with this exact algorithm.
For hardcoded users, you can use an `online tool`_, which will give you something
like this:
Expand Down
8 changes: 4 additions & 4 deletions book/translation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -405,8 +405,8 @@ checks translation resources for several locales:

.. note::

When Symfony doesn't find a translation in the given locale, it will
add the missing translation to the log file. For details,
When Symfony doesn't find a translation in the given locale, it will
add the missing translation to the log file. For details,
see :ref:`reference-framework-translator-logging`.

.. _book-translation-user-locale:
Expand Down Expand Up @@ -664,8 +664,8 @@ Translating Database Content
----------------------------

The translation of database content should be handled by Doctrine through
the `Translatable Extension`_ or the `Translatable Behavior`_ (PHP 5.4+).
For more information, see the documentation for these libraries.
the `Translatable Extension`_ or the `Translatable Behavior`_. For more information,
see the documentation for these libraries.

Debugging Translations
----------------------
Expand Down
17 changes: 0 additions & 17 deletions components/http_foundation/session_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -218,23 +218,6 @@ particular cookie by reading the ``getLifetime()`` method::
The expiry time of the cookie can be determined by adding the created
timestamp and the lifetime.

PHP 5.4 Compatibility
~~~~~~~~~~~~~~~~~~~~~

Since PHP 5.4.0, :phpclass:`SessionHandler` and :phpclass:`SessionHandlerInterface`
are available. Symfony provides forward compatibility for the :phpclass:`SessionHandlerInterface`
so it can be used under PHP 5.3. This greatly improves interoperability with other
libraries.

:phpclass:`SessionHandler` is a special PHP internal class which exposes native save
handlers to PHP user-space.

In order to provide a solution for those using PHP 5.4, Symfony has a special
class called :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeSessionHandler`
which under PHP 5.4, extends from ``\SessionHandler`` and under PHP 5.3 is just a
empty base class. This provides some interesting opportunities to leverage
PHP 5.4 functionality if it is available.

Save Handler Proxy
~~~~~~~~~~~~~~~~~~

Expand Down
2 changes: 1 addition & 1 deletion contributing/code/patches.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Before working on Symfony, setup a friendly environment with the following
software:

* Git;
* PHP version 5.3.3 or above;
* PHP version 5.5.9 or above;
* `PHPUnit`_ 4.2 or above.

Configure Git
Expand Down
9 changes: 4 additions & 5 deletions cookbook/bundles/best_practices.rst
10000
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,9 @@ Bundle Name
-----------

A bundle is also a PHP namespace. The namespace must follow the technical
interoperability `standards`_ for PHP 5.3 namespaces and class names: it
starts with a vendor segment, followed by zero or more category segments, and
it ends with the namespace short name, which must end with a ``Bundle``
suffix.
interoperability `standards`_ for PHP namespaces and class names: it starts
with a vendor segment, followed by zero or more category segments, and it
ends with the namespace short name, which must end with a ``Bundle`` suffix.

A namespace becomes a bundle as soon as you add a bundle class to it. The
bundle class name must follow these simple rules:
Expand Down Expand Up @@ -348,7 +347,7 @@ there are 3 modes, which the user can configure in their project:
* 2.4: the original 2.4 and earlier validation API;
* 2.5: the new 2.5 and later validation API;
* 2.5-BC: the new 2.5 API with a backwards-compatible layer so that the
2.4 API still works. This is only available in PHP 5.3.9+.
2.4 API still works.

As a bundle author, you'll want to support *both* API's, since some users
may still be using the 2.4 API. Specifically, if your bundle adds a violation
Expand Down
5 changes: 2 additions & 3 deletions cookbook/deployment/azure-website.rst
Original file line number Diff line number Diff line change
Expand Up @@ -96,9 +96,8 @@ and how to properly configure PHP for a production environment.
Configuring the latest PHP Runtime
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Even though Symfony only requires PHP 5.3.3 to run, it's always recommended
to use the most recent PHP version whenever possible. PHP 5.3 is no longer
supported by the PHP core team, but you can update it easily in Azure.
Even though Symfony only requires PHP 5.5.9 to run, it's always recommended
to use the most recent PHP version whenever possible.

To update your PHP version on Azure, go to the **Configure** tab of the control
panel and select the version you want.
Expand Down
4 changes: 2 additions & 2 deletions cookbook/logging/monolog.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
How to Use Monolog to Write Logs
================================

Monolog_ is a logging library for PHP 5.3 used by Symfony. It is
inspired by the Python LogBook library.
Monolog_ is a logging library for PHP used by Symfony. It is inspired by the
Python LogBook library.

Usage
-----
Expand Down
13 changes: 0 additions & 13 deletions cookbook/security/_ircmaxwell_password-compat.rst.inc

This file was deleted.

2 changes: 0 additions & 2 deletions cookbook/security/entity_provider.rst
Original file line number Diff line number Diff line change
Expand Up @@ -355,8 +355,6 @@ the database to be encoded using this encoder. For details on how to create
a new User object with a properly encoded password, see the
:ref:`book-security-encoding-user-password` section of the security chapter.

.. include:: /cookbook/security/_ircmaxwell_password-compat.rst.inc

The ``providers`` section defines an ``administrators`` user provider. A
user provider is a "source" of where users are loaded during authentication.
In this case, the ``entity`` keyword means that Symfony will use the Doctrine
Expand Down
9 changes: 4 additions & 5 deletions cookbook/web_server/built_in.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,10 @@ How to Use PHP's built-in Web Server
The ability to run the server as a background process was introduced
in Symfony 2.6.

Since PHP 5.4 the CLI SAPI comes with a `built-in web server`_. It can be used
to run your PHP applications locally during development, for testing or for
application demonstrations. This way, you don't have to bother configuring
a full-featured web server such as
:doc:`Apache or Nginx </cookbook/configuration/web_server_configuration>`.
The CLI SAPI comes with a `built-in web server`_. It can be used to run your
PHP applications locally during development, for testing or for application
demonstrations. This way, you don't have to bother configuring a full-featured
web server such as :doc:`Apache or Nginx </cookbook/configuration/web_server_configuration>`.

.. caution::

Expand Down
4 changes: 2 additions & 2 deletions quick_tour/the_big_picture.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ by showing you a simple project in action.
If you've used a web framework before, you should feel right at home with
Symfony. If not, welcome to a whole new way of developing web applications.

The only technical requisite to follow this tutorial is to have **PHP 5.4 or higher
The only technical requisite to follow this tutorial is to have **PHP 5.5.9 or higher
installed on your computer**. If you use a packaged PHP solution such as WAMP,
XAMP or MAMP, check out that they are using PHP 5.4 or a more recent version.
XAMP or MAMP, check out that they are using PHP 5.5.9 or a more recent version.
You can also execute the following command in your terminal or command console
to display the installed PHP version:

Expand Down
3 changes: 1 addition & 2 deletions reference/configuration/framework.rst
Original file line number Diff line number Diff line change
Expand Up @@ -641,8 +641,7 @@ API. The ``api`` option is used to switch between the different implementations:
``2.5-bc`` or ``auto``
If you omit a value or set the ``api`` option to ``2.5-bc`` or ``auto``,
Symfony will use an API implementation that is compatible with both the
legacy implementation and the ``2.5`` implementation. You have to use
PHP 5.3.9 or higher to be able to use this implementation.
legacy implementation and the ``2.5`` implementation.

Full default Configuration
--------------------------
Expand Down
10 changes: 1 addition & 9 deletions reference/requirements.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,17 +21,11 @@ Below is the list of required and optional requirements.
Required
--------

* PHP needs to be a minimum version of PHP 5.3.3
* PHP needs to be a minimum version of PHP 5.5.9
* JSON needs to be enabled
* ctype needs to be enabled
* Your ``php.ini`` needs to have the ``date.timezone`` setting

.. caution::

Be aware that Symfony has some known limitations when using a PHP version
less than 5.3.8 or equal to 5.3.16. For more information see the
`Requirements section of the README`_.

Optional
--------

Expand All @@ -56,5 +50,3 @@ Doctrine
If you want to use Doctrine, you will need to have PDO installed. Additionally,
you need to have the PDO driver installed for the database server you want
to use.

.. _`Requirements section of the README`: https://github.com/symfony/symfony#requirements
0