From 9a078001cad3e21c4299be91f9b1b3c4966b1d24 Mon Sep 17 00:00:00 2001 From: Fabien Potencier Date: Tue, 9 Apr 2019 07:46:49 +0200 Subject: [PATCH] switched the prefered local web server to the Symfony one --- frontend/encore/dev-server.rst | 6 ------ setup.rst | 12 +++++++----- setup/built_in_web_server.rst | 14 +++++++++----- setup/web_server_configuration.rst | 9 +++++---- 4 files changed, 21 insertions(+), 20 deletions(-) diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst index 6fce0012d8f..60284383256 100644 --- a/frontend/encore/dev-server.rst +++ b/frontend/encore/dev-server.rst @@ -26,12 +26,6 @@ by the normal `webpack-dev-server`_. For example: This will start a server at ``https://localhost:9000``. -.. note:: - - This Webpack server is independent from - :doc:`Symfony's development web server ` and - you need to run both separately. - Using dev-server inside a VM ---------------------------- diff --git a/setup.rst b/setup.rst index ef27d707b0b..7dadf91d950 100644 --- a/setup.rst +++ b/setup.rst @@ -12,7 +12,7 @@ Installing & Setting up the Symfony Framework To create your new Symfony application, first make sure you're using PHP 7.1 or higher and have `Composer`_ installed. If you don't, start by :doc:`installing Composer globally ` -on your system. If you want to use a virtual machine (VM), check out :doc:`Homestead `. +on your system. Create your new project by running: @@ -33,17 +33,19 @@ In other words, your new app is ready! .. code-block:: terminal $ composer create-project symfony/skeleton my-project - - # optional: install the web server bundle (explained next) $ cd my-project - $ composer require --dev symfony/web-server-bundle Running your Symfony Application -------------------------------- On production, you should use a web server like Nginx or Apache (see :doc:`configuring a web server to run Symfony `). -But for development, it's convenient to use the :doc:`Symfony PHP web server `. +But for development, it's convenient to use the :doc:`Symfony Local Web Server `. + +.. note:: + + If you want to use a virtual machine (VM) with Vagrant, check out + :doc:`Homestead `. Move into your new project and start the server: diff --git a/setup/built_in_web_server.rst b/setup/built_in_web_server.rst index ba340fcac0b..2837c004bd0 100644 --- a/setup/built_in_web_server.rst +++ b/setup/built_in_web_server.rst @@ -4,11 +4,15 @@ How to Use PHP's built-in Web Server ==================================== -Since PHP 5.4 the CLI SAPI comes with a `built-in web server`_. It can be used -to run your PHP applications locally during development, for testing or for -application demonstrations. This way, you don't have to bother configuring -a full-featured web server such as -:doc:`Apache or Nginx `. +The PHP CLI SAPI comes with a `built-in web server`_. It can be used to run your +PHP applications locally during development, for testing or for application +demonstrations. This way, you don't have to bother configuring a full-featured +web server such as :doc:`Apache or Nginx `. + +.. tip:: + + The preferred way to develop your Symfony application is to use + :doc:`Symfony Local Web Server `. .. caution:: diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst index 83a95dc0e72..0c0c3af6c0e 100644 --- a/setup/web_server_configuration.rst +++ b/setup/web_server_configuration.rst @@ -5,10 +5,11 @@ Configuring a Web Server ======================== The preferred way to develop your Symfony application is to use -:doc:`PHP's internal web server `. However, -when using an older PHP version or when running the application in the production -environment, you'll need to use a fully-featured web server. This article -describes several ways to use Symfony with Apache or Nginx. +:doc:`Symfony Local Web Server `. + +However, when running the application in the production environment, you'll need +to use a fully-featured web server. This article describes several ways to use +Symfony with Apache or Nginx. When using Apache, you can configure PHP as an :ref:`Apache module ` or with FastCGI using