Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commite8ed49e

Browse files
committed
description for running PHP's built-in web server in the background
1 parent440e004 commite8ed49e

File tree

3 files changed

+76
-17
lines changed

3 files changed

+76
-17
lines changed

‎book/installation.rst‎

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -274,14 +274,24 @@ If there are any issues, correct them now before moving on.
274274
Note that using the ACL is recommended when you have access to them
275275
on your server because changing the umask is not thread-safe.
276276

277-
**4. Use the same user for the CLI and the web server**
278-
279-
In development environments, it is a common practice to use the same unix
280-
user for the CLI and the web server because it avoids any of these permissions
281-
issues when setting up new projects. This can be done by editing your web server
282-
configuration (e.g. commonly httpd.conf or apache2.conf for Apache) and setting
283-
its user to be the same as your CLI user (e.g. for Apache, update the User
284-
and Group values).
277+
**4. Use the built-in web server in development environments**
278+
279+
In development environments, the easiest way to test your application,
280+
is to use PHP's built-in web server:
281+
282+
..code-block::bash
283+
284+
$ php app/console server:start
285+
286+
When you are finished, stop it using the ``server:stop`` command:
287+
288+
..code-block::bash
289+
290+
$ php app/console server:stop
291+
292+
..seealso::
293+
294+
Read more about the internal server:doc:`in the cookbook</cookbook/web_server/built_in>`.
285295

286296
When everything is fine, click on "Go to the Welcome page" to request your
287297
first "real" Symfony webpage:

‎cookbook/web_server/built_in.rst‎

Lines changed: 51 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44
How to Use PHP's built-in Web Server
55
====================================
66

7+
..versionadded::2.6
8+
The ability to run the server as a background process was introduced
9+
in Symfony 2.6.
10+
711
Since PHP 5.4 the CLI SAPI comes with a `built-in web server`_. It can be used
812
to run your PHP applications locally during development, for testing or for
913
application demonstrations. This way, you don't have to bother configuring
@@ -19,15 +23,14 @@ Starting the Web Server
1923
-----------------------
2024

2125
Running a Symfony application using PHP's built-in web server is as easy as
22-
executing the ``server:run`` command:
26+
executing the ``server:start`` command:
2327

2428
..code-block::bash
2529
26-
$ php app/console server:run
30+
$ php app/console server:start
2731
28-
This starts a server at ``localhost:8000`` that executes your Symfony application.
29-
The command will wait and will respond to incoming HTTP requests until you
30-
terminate it (this is usually done by pressing Ctrl and C).
32+
This starts the web server at ``localhost:8000`` in the background that will
33+
serve your Symfony application.
3134

3235
By default, the web server listens on port 8000 on the loopback device. You
3336
can change the socket passing an ip address and a port as a command-line argument:
@@ -36,8 +39,30 @@ can change the socket passing an ip address and a port as a command-line argumen
3639
3740
$ php app/console server:run 192.168.0.1:8080
3841
42+
..note::
43+
44+
You can use the ``server:status`` command to check if a web server is
45+
listening on a certain socket:
46+
47+
..code-block::bash
48+
49+
$ php app/console server:status
50+
51+
$ php app/console server:status 192.168.0.1:8080
52+
53+
The first command shows if your Symfony application will be server through
54+
``localhost:8000``, the second one does the same for ``192.168.0.1:8080``.
55+
56+
..note::
57+
58+
Before Symfony 2.6, the ``server:run`` command was used to start the built-in
59+
web server. This command is still available and behaves slightly different.
60+
Instead of starting the server in the background, it will block the current
61+
terminal until you terminate it (this is usually done by pressing Ctrl
62+
and C).
63+
3964
Command Options
40-
---------------
65+
~~~~~~~~~~~~~~~
4166

4267
The built-in web server expects a "router" script (read about the "router"
4368
script on `php.net`_) as an argument. Symfony already passes such a router
@@ -47,14 +72,32 @@ script:
4772

4873
..code-block::bash
4974
50-
$ php app/console server:run --env=test --router=app/config/router_test.php
75+
$ php app/console server:start --env=test --router=app/config/router_test.php
5176
5277
If your application's document root differs from the standard directory layout,
5378
you have to pass the correct location using the ``--docroot`` option:
5479

5580
..code-block::bash
5681
57-
$ php app/console server:run --docroot=public_html
82+
$ php app/console server:start --docroot=public_html
83+
84+
Stopping the Server
85+
-------------------
86+
87+
When you are finished, you can simply stop the web server using the ``server:stop``
88+
command:
89+
90+
..code-block::bash
91+
92+
$ php app/console server:stop
93+
94+
Like with the start command, if you omit the socket information, Symfony will
95+
stop the web server bound to ``localhost:8000``. Just pass the socket information
96+
when the web server listens to another ip address or to another port:
97+
98+
..code-block::bash
99+
100+
$ php app/console server:stop 192.168.0.1:8080
58101
59102
.. _`built-in web server`:http://www.php.net/manual/en/features.commandline.webserver.php
60103
.. _`php.net`:http://php.net/manual/en/features.commandline.webserver.php#example-401

‎quick_tour/the_big_picture.rst‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,13 @@ to run Symfony:
7070

7171
..code-block::bash
7272
73-
$ php app/console server:run
73+
$ php app/console server:start
74+
75+
When you are finished, you can stop it with the ``server:stop`` command:
76+
77+
..code-block::bash
78+
79+
$ php app/console server:stop
7480
7581
..seealso::
7682

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp