Add a section on front controllers and the AppKernel

[mpdude]

Q	A
Doc fix?	no
New docs?	yes
Applies to	all
Fixed tickets	n/a

Here are some additions on how front controllers and custom AppKernels can be used to further tweak the runtime environment.

This is my first piece of .rst, so probably a lot of things and markup needs to be fixed. Additionally, we should discuss which is the best place for this document.

[wouterj]

Could you please add the pull request format to your PR message?

And I think this issue is related: #997

[wouterj]

you are missing an .. index:: block at the first line of your page

[mpdude]

@wouterj Is that correct with a triple ` plus the underscore?

[wouterj]

@mpdude no, you can't mix inline formats in Sphinx. So you just need to use 1 backtick to create a link.

[mpdude]

@wouterj Thanks for the quick feedback and sorry for getting so many basics wrong.

I hope I did not forget one of your comments.

[mpdude]

@lsmith77 as you opened #997 it would be nice to get your feedback as well

[lsmith77]

typo reques missing a t

[lsmith77]

there are several places that talk about Apache rewrite rules, i think it should be stated somewhere that equivalent behavior can be achieved with pretty much every other web server.

[mpdude]

All feedback picked up - thanks!

[stof]

The way it is wrapped is weird here

[stof]

Does this method refer to getEnvironment or registerbundles here ?

[mpdude]

@wouterj thanks for keeping an eye on it. I removed the reference to the Debug Component.

[mpdude]

symfony/symfony#7441 has been merged.

[wouterj]

@mpdude yes, I saw it. You can add that component in the list now. When #2479 is merged into the docs, you can add a link to that documentation as well.

[mpdude]

@wouterj I think I am done with it for the moment, feel free to merge it at any time.

If you do so before #2479, I'll ask over there to update the link to it on this page.

[weaverryan]

Hi Matthias!

Very nice work! I've patched this into the 2.0 branch so that all branches can enjoy it, and removed the Debug reference (but re-added it to the master branch only).

Thanks!

[mpdude]

@weaverryan just saw that the 'decorate' link in the Front Controller paragraph is broken. Could you please fix that?

Thanks!

[mpdude]

The link to the RewriteRule is broken as well :-(