Added doc about Homestead's Symfony integration

Author: wouterj

cookbook/map.rst.inc

@@ -245,3 +245,4 @@
 
   * :doc:`/cookbook/workflow/new_project_git`
   * :doc:`/cookbook/workflow/new_project_svn`
+  * :doc:`/cookbook/workflow/homestead`

cookbook/workflow/homestead.rst

@@ -0,0 +1,66 @@
+.. index:: Vagrant, Homestead
+
+Using Symfony with Homestead/Vagrant
+====================================
+
+In order to develop a Symfony application, you might want to use a virtual
+development environment instead of the built-in server or WAMP/LAMP. Homestead_
+is an easy-to-use Vagrant_ box to get a virtual environment up and running
+quickly.
+
+Install Vagrant and Homestead
+-----------------------------
+
+Before you can use Homestead, you need to install and configure Vagrant and
+Homestead as explained in `the Homestead documentation`_.
+
+Setting Up a Symfony Application
+--------------------------------
+
+Imagine you've installed your Symfony application in
+``~/projects/symfony_demo`` on your local system. You first need Homestead to
+sync your files in this project. Execute ``homestead edit`` to edit the
+Homestead configuration and configure the ``~/projects`` directory:
+
+.. code-block:: yaml
+
+    # ...
+    folders:
+        - map: ~/projects
+          to: /home/vagrant/projects
+
+The projects directory is now accessible at ``/home/vagrant/projects`` in the
+Homestead environment.
+
+After you've done this, configure the Symfony application in the Homestead
+configuration:
+
+.. code-block:: yaml
+
+    # ...
+    sites:
+        - map: symfony-demo.dev
+          to: /home/vagrant/projects/symfony_demo/web
+          type: symfony
+
+The ``type`` option tells Homestead to use the Symfony nginx configuration.
+
+At last, edit the hosts file on your local machine to map ``symfony-demo.dev``
+to ``192.168.10.10`` (which is the IP used by Homestead)::
+
+    # /etc/hosts (unix) or C:\Windows\System32\drivers\etc\hosts (Windows)
+    192.168.10.10 symfony-demo.dev
+
+Now, navigate to ``http://symfony-demo.dev`` in your web browser and enjoy
+developing your Symfony application!
+
+.. seealso::
+
+    To learn more features of Homestead, including Blackfire Profiler
+    integration, automatic creation of MySQL databases and more, read the
+    `Daily Usage`_ section of the Homestead documentation.
+
+.. _Homestead: http://laravel.com/docs/homestead
+.. _Vagrant: https://www.vagrantup.com/
+.. _the Homestead documentation: http://laravel.com/docs/homestead#installation-and-setup
+.. _Daily Usage: http://laravel.com/docs/5.1/homestead#daily-usage

cookbook/workflow/index.rst

@@ -6,3 +6,4 @@ Workflow
 
     new_project_git
     new_project_svn
+    homestead