Skip to content
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

Updated the Quick Tour to the latest changes introduced by Symfony #5631

Closed
wants to merge 2 commits into from
Closed
Changes from all commits
Commits
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
32 changes: 16 additions & 16 deletions quick_tour/the_big_picture.rst
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ of database calls, HTML tags and other PHP code in the same script. To achieve
this goal with Symfony, you'll first need to learn a few fundamental concepts.

When developing a Symfony application, your responsibility as a developer
is to write the code that maps the user's *request* (e.g. ``http://localhost:8000/app/example``)
is to write the code that maps the user's *request* (e.g. ``http://localhost:8000/``)
to the *resource* associated with it (the ``Homepage`` HTML page).

The code to execute is defined in **actions** and **controllers**. The mapping
Expand Down Expand Up @@ -159,7 +159,7 @@ because that will be explained in the next section)::
class DefaultController extends Controller
{
/**
* @Route("/app/example", name="homepage")
* @Route("/", name="homepage")
*/
public function indexAction()
{
Expand Down Expand Up @@ -201,7 +201,7 @@ at the three lines of code above the ``indexAction`` method::
class DefaultController extends Controller
{
/**
* @Route("/app/example", name="homepage")
* @Route("/", name="homepage")
*/
public function indexAction()
{
Expand All @@ -217,15 +217,14 @@ start with ``/**``, whereas regular PHP comments start with ``/*``.
The first value of ``@Route()`` defines the URL that will trigger the execution
of the action. As you don't have to add the host of your application to
the URL (e.g. ```http://example.com``), these URLs are always relative and
they are usually called *paths*. In this case, the ``/app/example`` path
refers to the application homepage. The second value of ``@Route()`` (e.g.
``name="homepage"``) is optional and sets the name of this route. For now
this name is not needed, but later it'll be useful for linking pages.
they are usually called *paths*. In this case, the ``/`` path refers to the
application homepage. The second value of ``@Route()`` (e.g. ``name="homepage"``)
is optional and sets the name of this route. For now this name is not needed,
but later it'll be useful for linking pages.

Considering all this, the ``@Route("/app/example", name="homepage")`` annotation
creates a new route called ``homepage`` which makes Symfony execute the
``index`` action of the ``Default`` controller when the user browses the
``/app/example`` path of the application.
Considering all this, the ``@Route("/", name="homepage")`` annotation creates a
new route called ``homepage`` which makes Symfony execute the ``index`` action
of the ``Default`` controller when the user browses the ``/`` path of the application.

.. tip::

Expand Down Expand Up @@ -257,13 +256,14 @@ you'll see the following code:
{% extends 'base.html.twig' %}

{% block body %}
Homepage.
<h1>Welcome to Symfony</h1>

{# ... #}
{% endblock %}

This template is created with `Twig`_, a new template engine created for
modern PHP applications. The
:doc:`second part of this tutorial </quick_tour/the_view>` will introduce
how templates work in Symfony.
This template is created with `Twig`_, a template engine created for modern PHP
applications. The :doc:`second part of this tutorial </quick_tour/the_view>`
explains how templates work in Symfony.

.. _quick-tour-big-picture-environments:

Expand Down