Skip to content

Commit 4f17fcb

Browse files
jmschejaviereguiluz
authored andcommitted
Symfony CLI: document the .symfony.local.yaml config file
1 parent c4de976 commit 4f17fcb

File tree

1 file changed

+33
-3
lines changed

1 file changed

+33
-3
lines changed

setup/symfony_server.rst

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -284,16 +284,46 @@ server provides a ``run`` command to wrap them as follows:
284284
# stop the web server (and all the associated commands) when you are finished
285285
$ symfony server:stop
286286
287-
Configuring Workers
288-
-------------------
287+
Configuration file
288+
------------------
289289

290290
.. caution::
291291

292292
This feature is experimental and could change or be removed at any time
293293
without prior notice.
294294

295+
There are several options that you can set using a ``.symfony.local.yaml`` config file:
296+
297+
.. code-block:: yaml
298+
299+
# Sets domain1.wip and domain2.wip for the current project
300+
proxy:
301+
domains:
302+
- domain1
303+
- domain2
304+
305+
http:
306+
document_root: public/ # Path to the project document root
307+
passthru: index.php # Project passthru index
308+
port: 8000 # Force the port that will be used to run the server
309+
preferred_port: 8001 # Preferred HTTP port [default: 8000]
310+
p12: path/to/p12_cert # Name of the file containing the TLS certificate to use in p12 format
311+
allow_http: true # Prevent auto-redirection from HTTP to HTTPS
312+
no_tls: true # Use HTTP instead of HTTPS
313+
daemon: true # Run the server in the background
314+
use_gzip: true # Toggle GZIP compression
315+
316+
.. caution::
317+
318+
Setting domains in this configuration file will override any domains you set
319+
using the ``proxy:domain:attach`` command for the current project when you start
320+
the server.
321+
322+
Configuring Workers
323+
~~~~~~~~~~~~~~~~~~~
324+
295325
If you like some processes to start automatically, along with the webserver
296-
(``symfony server:start``), add a configuration file to your project:
326+
(``symfony server:start``), you can set them in the YAML configuration file:
297327

298328
.. code-block:: yaml
299329

0 commit comments

Comments
 (0)