Add a tips about the Build-in web server included in PHP 5.4

[athieriot]

Hi,

When I start looking at the Symfony 2.0 quick tour, I find out that it was pretty difficult to bootstrap a simple project without having a whole http/php/fastcgi configuration.

It can be somehow reluctant to new users not used to this kind of system management and who just want to start coding as fast as possible.

So, as the new version of PHP provide a perfect way to avoid such boilerplate, I propose to add a small tip at the beginning of the quick tour to talk about this alternative.

I though that the quick tour is the place where I wanted to find this information at my first visit. But if you think that a Cook Book would be better, I can change my Pull Request to reflect the change.

Thank you for, at least, looking at it.

Aurélien

[stof]

``www` is not the web folder of the application. When using the built-in webserver, you could use directly the appropriate folder (and symfony 2.1 has a command launching it for you)

[athieriot]

I set 'www' to be consistent with the documentation which refer to localhost/Symfony.
But my question about the Cook Books was about this kind of delicacies (Write more details about the command options).

I didn't knew about that in version 2.1, did you think I should wait?

[weaverryan]

Hi Aurélien!

I think this is a really excellent thing to bring up, and the quick tour is the best place for it (we may also mention it in other places, but certainly it should be mentioned here).

Since there is a command for this in Symfony 2.1, we should use it, but I don't see any reason not to document this in 2.0. So, here's what I think we should do:

1. Change the "www" in the code example to "/path/to/www", just so it's absolute.

2. Add some note to clarify what "www" means. Something like this (added after the code block):

where "/path/to/www" is the path to some directory on your machine that you'll extract Symfony into so that the eventual URL to your application is "http://localhost/Symfony/app_dev.php". You can also extract Symfony first and then start the web server in the Symfony "web" directory. If you do this, the URL to your application will be "http://localhost/app_dev.php".

3. After this PR is merged, open a separate pull request against the "master" branch of the docs that replaces this with something that talks about the new command (details here: https://github.com/symfony/symfony/pull/3465/files).

Thanks!

[athieriot]

Hi Ryan,

Thank your for your review.
I update the message like you said and I'll be pleased to make a separate Pull Request for this awesome feature as soon as I can :)

Hope this one is ok for you.

Aurélien

[weaverryan]

Hey Aurélien!

Looks great - I made some tweaks at sha: 9ed2ebb - the biggest is shortening the lines so that each breaks after the first word that crosses the 72nd character (so that we have lines that are approximately 73-78 in length).

I've also merged 2.0 into master, so you should be good to make the next PR to master!

Thanks for your help!

[wouterj]

@athieriot ping, do you still want to document the new feature against the 2.1 branch? Otherwise, I'll plan it for the hack day.

[athieriot]

Hi,

I am pretty sure that the new feature is already documented.
So I don't know if it's still needed?

Aurelien

[wouterj]

Since Symfony 2.1, there is a server:run command which does exactly this (for PHP5.4). This message should get replaced with a short description of this command against the 2.1 branch.