php 提供了一個(gè)內(nèi)置的Web服務(wù)器。
在很多時(shí)候,當(dāng)我們要簡單的運(yùn)行一個(gè)小 demo 來驗(yàn)證一些代碼或者輪子是否可用,是否可以運(yùn)行起來時(shí),去配置 Nginx 或者 Apache 服務(wù)器都很麻煩。此時(shí),使用PHP的內(nèi)置服務(wù)器就可以將代碼運(yùn)行起來進(jìn)行簡單的一些測試工作。
這個(gè)內(nèi)置的Web服務(wù)器主要用于本地開發(fā)使用,不可用于線上生產(chǎn)環(huán)境。
用法
$ php -S localhost:2333 [-t html] [-c php.ini] [router.php]
參數(shù)說明:
-S 指定服務(wù)器的 Domain/IP 和端口
-t 指定根目錄,默認(rèn)為當(dāng)前目錄
-c 指定配置文件
router.php 自定義路由,即入口文件
啟動(dòng)Web服務(wù)器
$ cd ~/public_html
$ php -S localhost:8000
終端窗口會(huì)顯示:
PHP 5.4.0 Development Server started at Thu Jul 21 10:43:28 2011
Listening on localhost:8000
Document root is /home/me/public_html
Press Ctrl-C to quit
接著訪問http://localhost:8000/和http://localhost:8000/myscript.html,窗口會(huì)顯示:
PHP 5.4.0 Development Server started at Thu Jul 21 10:43:28 2011
Listening on localhost:8000
Document root is /home/me/public_html
Press Ctrl-C to quit.
[Thu Jul 21 10:48:48 2011] ::1:39144 GET /favicon.ico - Request read
[Thu Jul 21 10:48:50 2011] ::1:39146 GET / - Request read
[Thu Jul 21 10:48:50 2011] ::1:39147 GET /favicon.ico - Request read
[Thu Jul 21 10:48:52 2011] ::1:39148 GET /myscript.html - Request read
[Thu Jul 21 10:48:52 2011] ::1:39149 GET /favicon.ico - Request read
啟動(dòng)時(shí)指定運(yùn)行目錄(根目錄)
URI請(qǐng)求會(huì)被發(fā)送到PHP所在的的工作目錄進(jìn)行處理,除非你使用了-t參數(shù)來自定義不同的目錄。
$ cd ~/public_html
$ php -S localhost:8000 -t foo/
終端窗口顯示:
PHP 5.4.0 Development Server started at Thu Jul 21 10:50:26 2011
Listening on localhost:8000
Document root is /home/me/public_html/foo
Press Ctrl-C to quit
指定PHP配置
應(yīng)用常常需要使用專屬的PHP配置文件,尤其是對(duì)內(nèi)存使用、文件上傳、分析或?qū)ψ止?jié)碼緩存有特殊要求時(shí),一定要單獨(dú)配置,我們可以使用 -c 選項(xiàng),讓PHP內(nèi)置的服務(wù)器使用指定的配置文件:
php -S localhost:8000 -c App/config/php.ini
使用路由(Router)腳本
如果請(qǐng)求未指定執(zhí)行哪個(gè)PHP文件,則默認(rèn)執(zhí)行目錄內(nèi)的index.php 或者 index.html。如果這兩個(gè)文件都不存在,服務(wù)器會(huì)返回404錯(cuò)誤。
當(dāng)你在命令行啟動(dòng)這個(gè)Web Server時(shí),如果指定了一個(gè)PHP文件,則這個(gè)文件會(huì)作為一個(gè)“路由”腳本,意味著每次請(qǐng)求都會(huì)先執(zhí)行這個(gè)腳本。如果這個(gè)腳本返回 false ,那么直接返回請(qǐng)求的文件(例如請(qǐng)求靜態(tài)文件不作任何處理)。否則會(huì)把輸出返回到瀏覽器。
如下示例: 請(qǐng)求圖片直接顯示圖片,請(qǐng)求HTML則顯示“Welcome to PHP”
<?php
// router.php
if (preg_match('/\.(?:png|jpg|jpeg|gif)$/', $_SERVER["REQUEST_URI"]))
return false; // 直接返回請(qǐng)求的文件
else {
echo "<p>Welcome to PHP</p>";
}
?>
$ php -S localhost:8000 router.php
執(zhí)行之后終端顯示:
PHP 5.4.0 Development Server started at Thu Jul 21 10:53:19 2011
Listening on localhost:8000
Document root is /home/me/public_html
Press Ctrl-C to quit.
[Thu Jul 21 10:53:45 2011] ::1:55801 GET /mylogo.jpg - Request read
[Thu Jul 21 10:53:52 2011] ::1:55803 GET /abc.html - Request read
[Thu Jul 21 10:53:52 2011] ::1:55804 GET /favicon.ico - Request read
檢查當(dāng)前請(qǐng)求是否使用的PHP內(nèi)置服務(wù)器
如在PHP內(nèi)置服務(wù)器驅(qū)動(dòng)和生產(chǎn)環(huán)境服務(wù)器驅(qū)動(dòng)時(shí)共用一個(gè)路由腳本文件
<?php
// router.php
if (php_sapi_name() == 'cli-server') {
/* 路由靜態(tài)資源返回 false */
}
/* 繼續(xù)正常index.php操作 */
?>
$ php -S localhost:8000 router.php
允許從遠(yuǎn)程計(jì)算機(jī)訪問CLI Web服務(wù)器
您可以通過以下方式使任何IP都可以通過端口8000訪問該Web服務(wù)器:
$ php -S 0.0.0.0:8000
其實(shí)像Laravel框架的 php artisan serve 命令啟動(dòng)服務(wù)也是用的上述php內(nèi)置服務(wù)器。