Skip to content

Commit dd8be70

Browse files
committed
Merge branch '5.0'
* 5.0: Improve the docs about the Symfony server proxy
2 parents a4a9b3f + 8617d68 commit dd8be70

File tree

1 file changed

+19
-10
lines changed

1 file changed

+19
-10
lines changed

setup/symfony_server.rst

+19-10
Original file line numberDiff line numberDiff line change
@@ -181,19 +181,28 @@ local IP. However, sometimes it is preferable to associate a domain name to them
181181
Setting up the Local Proxy
182182
~~~~~~~~~~~~~~~~~~~~~~~~~~
183183

184-
Local domains are possible thanks to a local proxy provided by the Symfony
185-
server. First, start the proxy:
184+
Local domains are possible thanks to a local proxy provided by the Symfony server.
185+
If this is the first time you run the proxy, you must configure it as follows:
186+
187+
#. Open the **proxy settings** of your operating system:
188+
189+
* `Proxy settings in Windows`_;
190+
* `Proxy settings in macOS`_;
191+
* `Proxy settings in Ubuntu`_.
192+
193+
#. Set the following URL as the value of the **Automatic Proxy Configuration**:
194+
``http://127.0.0.1:7080/proxy.pac``
195+
196+
Now run this command to start the proxy:
186197

187198
.. code-block:: terminal
188199
189200
$ symfony proxy:start
190201
191-
If this is the first time you run the proxy, you must configure it as follows:
202+
.. note::
192203

193-
* Open the **proxy settings** of your operating system (`proxy settings in Windows`_,
194-
`proxy settings in macOS`_, `proxy settings in Ubuntu`_);
195-
* Set the following URL as the value of the **Automatic Proxy Configuration**:
196-
``http://127.0.0.1:7080/proxy.pac``
204+
Some browsers (e.g. Chrome) require a full restart after starting the proxy.
205+
Otherwise, you'll see a *"This webpage is not available"* error (``ERR_NAME_NOT_RESOLVED``).
197206

198207
Defining the Local Domain
199208
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -362,7 +371,7 @@ debug any issues.
362371
.. _`Docker`: https://en.wikipedia.org/wiki/Docker_(software)
363372
.. _`SymfonyCloud`: https://symfony.com/cloud/
364373
.. _`Read SymfonyCloud technical docs`: https://symfony.com/doc/master/cloud/intro.html
365-
.. _`proxy settings in Windows`: https://www.dummies.com/computers/operating-systems/windows-10/how-to-set-up-a-proxy-in-windows-10/
366-
.. _`proxy settings in macOS`: https://support.apple.com/guide/mac-help/enter-proxy-server-settings-on-mac-mchlp2591/mac
367-
.. _`proxy settings in Ubuntu`: https://help.ubuntu.com/stable/ubuntu-help/net-proxy.html.en
374+
.. _`Proxy settings in Windows`: https://www.dummies.com/computers/operating-systems/windows-10/how-to-set-up-a-proxy-in-windows-10/
375+
.. _`Proxy settings in macOS`: https://support.apple.com/guide/mac-help/enter-proxy-server-settings-on-mac-mchlp2591/mac
376+
.. _`Proxy settings in Ubuntu`: https://help.ubuntu.com/stable/ubuntu-help/net-proxy.html.en
368377
.. _`is treated differently`: https://ec.haxx.se/usingcurl/usingcurl-proxies#http_proxy-in-lower-case-only

0 commit comments

Comments
 (0)