diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc index 73587ee5d47..10f6d3e8b19 100644 --- a/cookbook/map.rst.inc +++ b/cookbook/map.rst.inc @@ -262,3 +262,4 @@ * :doc:`/cookbook/workflow/new_project_git` * :doc:`/cookbook/workflow/new_project_svn` + * :doc:`/cookbook/workflow/homestead` diff --git a/cookbook/workflow/homestead.rst b/cookbook/workflow/homestead.rst new file mode 100644 index 00000000000..2f50a3305ac --- /dev/null +++ b/cookbook/workflow/homestead.rst @@ -0,0 +1,76 @@ +.. 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. + +.. tip:: + + Due to the amount of filesystem operations in Symfony (e.g. updating cache + files and writing to log files), Symfony can slow down signifcantly. To + improve the speed, consider :ref:`overriding the cache and log directories ` + to a location outside the NFS share (for instance, by using + :phpfunction:`sys_get_temp_dir`). You can read `this blog post`_ for more + tips to speed up Symfony on Vagrant. + +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 on your PC 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 +.. _this blog post: http://www.whitewashing.de/2013/08/19/speedup_symfony2_on_vagrant_boxes.html diff --git a/cookbook/workflow/index.rst b/cookbook/workflow/index.rst index 6b2382ae235..7da4491bbc1 100644 --- a/cookbook/workflow/index.rst +++ b/cookbook/workflow/index.rst @@ -6,3 +6,4 @@ Workflow new_project_git new_project_svn + homestead pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy