Permalink
Browse files

Updating from symfony-docs

  • Loading branch information...
1 parent 37558e6 commit 7484cba50b90ac1a7ce457ce0424ead9a4a0d728 @gregquat gregquat committed May 27, 2012
Showing with 1,392 additions and 858 deletions.
  1. +6 −1 book/doctrine.rst
  2. +7 −2 book/installation.rst
  3. +11 −11 book/propel.rst
  4. +1 −1 book/routing.rst
  5. +4 −4 book/service_container.rst
  6. +5 −15 book/templating.rst
  7. +5 −5 book/testing.rst
  8. +1 −1 book/translation.rst
  9. +9 −9 components/console.rst
  10. +191 −0 components/dependency_injection/compilation.rst
  11. +1 −1 {cookbook/service_container → components/dependency_injection}/factories.rst
  12. +5 −0 components/dependency_injection/index.rst
  13. +2 −8 components/dependency_injection/introduction.rst
  14. +1 −1 {cookbook/service_container → components/dependency_injection}/parentservices.rst
  15. +159 −0 components/dependency_injection/tags.rst
  16. +3 −3 components/event_dispatcher/introduction.rst
  17. +2 −0 components/http_foundation/index.rst
  18. +266 −0 components/http_foundation/session_configuration.rst
  19. +59 −0 components/http_foundation/session_testing.rst
  20. +29 −306 components/http_foundation/sessions.rst
  21. +6 −0 components/map.rst.inc
  22. +1 −1 components/routing.rst
  23. +5 −5 components/templating.rst
  24. +37 −12 contributing/code/patches.rst
  25. +2 −29 contributing/code/standards.rst
  26. +2 −2 contributing/documentation/format.rst
  27. +13 −3 contributing/documentation/overview.rst
  28. +2 −0 cookbook/assetic/apply_to_option.rst
  29. +10 −0 cookbook/assetic/yuicompressor.rst
  30. +107 −0 cookbook/configuration/apache_router.rst
  31. +1 −0 cookbook/configuration/index.rst
  32. +2 −2 cookbook/configuration/pdo_session_storage.rst
  33. +1 −1 cookbook/form/dynamic_form_generation.rst
  34. +19 −3 cookbook/form/form_collections.rst
  35. +2 −2 cookbook/form/index.rst
  36. +32 −36 cookbook/form/use_virtuals_forms.rst
  37. +2 −3 cookbook/map.rst.inc
  38. +8 −0 cookbook/security/custom_authentication_provider.rst
  39. +1 −1 cookbook/security/entity_provider.rst
  40. +33 −0 cookbook/service_container/compiler_passes.rst
  41. +35 −0 cookbook/service_container/event_listener.rst
  42. +1 −3 cookbook/service_container/index.rst
  43. +0 −207 cookbook/service_container/tags.rst
  44. +5 −4 cookbook/testing/profiling.rst
  45. +20 −14 cookbook/validation/custom_constraint.rst
  46. +6 −3 cookbook/workflow/_vendor_deps.rst.inc
  47. +9 −2 cookbook/workflow/new_project_git.rst
  48. +6 −6 cookbook/workflow/new_project_svn.rst
  49. +1 −1 quick_tour/the_big_picture.rst
  50. +3 −0 redirection_map
  51. +5 −3 reference/configuration/doctrine.rst
  52. +2 −2 reference/constraints.rst
  53. +102 −0 reference/constraints/Range.rst
  54. +95 −28 reference/constraints/Size.rst
  55. +0 −115 reference/constraints/SizeLength.rst
  56. +48 −1 reference/forms/types/options/by_reference.rst.inc
  57. +1 −1 reference/requirements.rst
View
@@ -260,7 +260,10 @@ disponibles, reportez vous à la section :ref:`book-doctrine-field-types`.
le nom de la classe de votre entité est ``Group``, alors, par défaut, le nom
de la table correspondante sera ``group``, ce qui causera des problèmes SQL
avec certains moteurs. Lisez la documentation sur les `Mots-clé SQL réservés`_ de
- Doctrine pour savoir comment échapper ces noms.
+ Doctrine pour savoir comment échapper ces noms. Alternativement, si vous êtes libre
+ de choisir votre schéma de base de données, vous pouvez simplement utiliser un autre
+ nom de table ou de colonne. Lisez les documentations de Doctrine `Classes persistantes`_
+ et `Mapping de propriétés`_.
.. note::
@@ -1466,4 +1469,6 @@ suivant :
.. _`Property Mapping documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping
.. _`Lifecycle Events documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events
.. _`Mots-clé SQL réservés`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
+.. _`Classes persistantes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/2.1/reference/basic-mapping.html#persistent-classes
+.. _`Mapping de propriétés`: http://docs.doctrine-project.org/projects/doctrine-orm/en/2.1/reference/basic-mapping.html#property-mapping
@@ -18,7 +18,7 @@ Télécharger une Distribution Symfony2
.. tip::
Premièrement, vérifiez que vous avez installé et configuré un serveur web
- (comme Apache) avec PHP 5.3.2 ou supérieur. Pour plus d'informations sur les
+ (comme Apache) avec PHP 5.3.3 ou supérieur. Pour plus d'informations sur les
prérequis Symfony2, lisez le chapitre :doc:`pré-requis</reference/requirements>`.
Pour plus d'informations sur la manière de configurer la racine web de votre serveur,
lisez les documentations suivantes : `Apache`_ | `Nginx`_ .
@@ -175,6 +175,11 @@ S'il y a des problèmes, corrigez les maintenant avant de poursuivre.
sudo setfacl -R -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs
sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs
+ Notez que tout les serveurs web n'utilisent pas l'utilisateur ``www-data``. Vous devez
+ vérifier quel utilisateur votre serveur web utilise et le remplacer dans la commande
+ ci-dessus si besoin. Cela peut être fait en vérifiant la liste des processus pour voir
+ quel utilisateur éxécute votre serveur web.
+
**3. Sans utiliser l'ACL**
Si vous n'avez pas les droits de changer les accès aux répertoires, vous aurez
@@ -252,4 +257,4 @@ pour récupérer toutes les librairies nécessaires.
.. _`GitHub`: http://help.github.com/set-up-git-redirect
.. _`Composer`: http://getcomposer.org/
.. _`Apache`: http://httpd.apache.org/docs/current/mod/core.html#documentroot
-.. _`Nginx`: http://wiki.nginx.org/HttpCoreModule#root
+.. _`Nginx`: http://wiki.nginx.org/Symfony
View
@@ -26,22 +26,22 @@ Configuring the Database
Before you can start, you'll need to configure your database connection
information. By convention, this information is usually configured in an
-``app/config/parameters.ini`` file:
+``app/config/parameters.yml`` file:
-.. code-block:: ini
+.. code-block:: yml
- ;app/config/parameters.ini
- [parameters]
- database_driver = mysql
- database_host = localhost
- database_name = test_project
- database_user = root
- database_password = password
- database_charset = UTF8
+ # app/config/parameters.yml
+ parameters:
+ database_driver: mysql
+ database_host: localhost
+ database_name: test_project
+ database_user: root
+ database_password: password
+ database_charset: UTF8
.. note::
- Defining the configuration via ``parameters.ini`` is just a convention. The
+ Defining the configuration via ``parameters.yml`` is just a convention. The
parameters defined in that file are referenced by the main configuration
file when setting up Propel:
View
@@ -1145,7 +1145,7 @@ depuis les templates.
.. code-block:: javascript
- var url = Routing.generate('blog_show', { "slug": 'my-blog-post});
+ var url = Routing.generate('blog_show', { "slug": 'my-blog-post'});
Pour plus d'informations, lisez la documentation du bundle.
@@ -1086,11 +1086,11 @@ des paramètres supplémentaires (au-delà du paramètre ``name``).
* translation.loader
* validator.constraint_validator
-Apprenez en plus en lisant le Cookbook
---------------------------------------
+Apprenez en plus
+----------------
-* :doc:`/cookbook/service_container/factories`
-* :doc:`/cookbook/service_container/parentservices`
+* :doc:`/components/dependency_injection/factories`
+* :doc:`/components/dependency_injection/parentservices`
* :doc:`/cookbook/controller/service`
.. _`service-oriented architecture`: http://wikipedia.org/wiki/Service-oriented_architecture
View
@@ -582,9 +582,7 @@ un template.
La solution consiste simplement à imbriquer les résultats d'un contrôleur dans un
template. Dans un premier temps, créez un contrôleur qui retourne un certain
-nombre d'articles récents :
-
-.. code-block:: php
+nombre d'articles récents::
// src/Acme/ArticleBundle/Controller/ArticleController.php
@@ -966,15 +964,11 @@ Le coeur du système de template dans Symfony2 est le ``moteur`` de template (``
objet spécial est responsable de rendre des templates et de retourner leur
contenu. Quand vous effectuez le rendu d'un template à travers un contrôleur
par exemple, vous utilisez en effet le service de moteur de template. Par
-exemple :
-
-.. code-block:: php
+exemple::
return $this->render('AcmeArticleBundle:Article:index.html.twig');
-est équivalent à
-
-.. code-block:: php
+est équivalent à::
$engine = $this->container->get('templating');
$content = $engine->render('AcmeArticleBundle:Article:index.html.twig');
@@ -1276,9 +1270,7 @@ n'est pas rendu différemment en se basant sur ce format.
Dans beaucoup de cas, vous pourriez vouloir autoriser un simple contrôleur à
rendre plusieurs formats en se basant sur le « request format ». Pour cette
-raison, un pattern commun est de procéder comme cela :
-
-.. code-block:: php
+raison, un pattern commun est de procéder comme cela::
public function indexAction()
{
@@ -1320,9 +1312,7 @@ chaque fois que vous avez besoin de générer du contenu de répresentation en
HTML, XML ou tout autre format. Et bien que les templates soient un moyen commun
de générer du contenu dans un contrôleur, leur utilisation n'est pas
systèmatique. L'objet ``Response`` retourné par un contrôleur peut être créé
-avec ou sans utilisation de template :
-
-.. code-block:: php
+avec ou sans utilisation de template::
// création d'un objet Response qui contient le rendu d'un template
$response = $this->render('AcmeArticleBundle:Article:index.html.twig');
View
@@ -154,7 +154,7 @@ son ``DemoController`` (`DemoControllerTest`_) :
$crawler = $client->request('GET', '/demo/hello/Fabien');
- $this->assertTrue($crawler->filter('html:contains("Hello Fabien")')->count() > 0);
+ $this->assertGreaterThan(0, $crawler->filter('html:contains("Hello Fabien")')->count());
}
}
@@ -232,7 +232,7 @@ qu'elle fasse. Utilisez le Crawler pour faire des assertions sur le DOM :
.. code-block:: php
// affirme que la réponse correspond au sélecteur CSS donné
- $this->assertTrue($crawler->filter('h1')->count() > 0);
+ $this->assertGreaterThan(0, $crawler->filter('h1')->count());
Ou alors, testez directement le contenu de la Réponse si vous voulez
juste vérifier qu'il contient un certain texte, ou si la Réponse n'est pas un
@@ -278,18 +278,18 @@ document XML/HTML :
.. index::
single: Tests; Assertions
-.. sidebar: Assertions Utiles
+.. sidebar:: Assertions Utiles
Afin que vous démarriez plus rapidement, voici une liste des
assertions les plus communes et utiles :
.. code-block:: php
// Vérifie qu'il y a au moins une balise h2 dans la classe "subtitle"
- $this->assertTrue($crawler->filter('h2.subtitle')->count() > 0);
+ $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count());
// Vérifie qu'il y a exactement 4 balises h2 sur la page
- $this->assertEquals(4, $crawler->filter('h2')->count());
+ $this->assertCount(4, $crawler->filter('h2')->count());
// Vérifie que l'entête "Content-Type" vaut "application/json"
$this->assertTrue($client->getResponse()->headers->contains('Content-Type', 'application/json'));
@@ -859,7 +859,7 @@ manuellement la locale à utiliser pour la traduction :
'fr_FR',
);
- $this->get('translator')->trans(
+ $this->get('translator')->transChoice(
'{0} There is no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
10,
array('%count%' => 10),
@@ -211,14 +211,14 @@ will work:
There are 4 option variants you can use:
-=========================== =====================================================
+=========================== =====================================================================================
Option Value
-=========================== =====================================================
-InputOption::VALUE_IS_ARRAY This option accepts multiple values
+=========================== =====================================================================================
+InputOption::VALUE_IS_ARRAY This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``)
InputOption::VALUE_NONE Do not accept input for this option (e.g. ``--yell``)
-InputOption::VALUE_REQUIRED This value is required (e.g. ``iterations=5``)
-InputOption::VALUE_OPTIONAL This value is optional
-=========================== =====================================================
+InputOption::VALUE_REQUIRED This value is required (e.g. ``--iterations=5``), the option itself is still optional
+InputOption::VALUE_OPTIONAL This option may or may not have a value (e.g. ``yell`` or ``yell=loud``)
+=========================== =====================================================================================
You can combine VALUE_IS_ARRAY with VALUE_REQUIRED or VALUE_OPTIONAL like this:
@@ -345,16 +345,16 @@ Calling a command from another one is straightforward::
// ...
}
-First, you :method:`Symfony\\Component\\Console\\Command\\Command::find` the
+First, you :method:`Symfony\\Component\\Console\\Application::find` the
command you want to execute by passing the command name.
Then, you need to create a new
:class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the arguments and
options you want to pass to the command.
Eventually, calling the ``run()`` method actually executes the command and
-returns the returned code from the command (``0`` if everything went fine, any
-other integer otherwise).
+returns the returned code from the command (return value from command's
+``execute()`` method).
.. note::
Oops, something went wrong. Retry.

0 comments on commit 7484cba

Please sign in to comment.