# WebServer
WorkerMan自帶了一個簡單的Web服務器,同樣也是基于Worker實現的。文件位置在Workerman/WebServer.php。這個WebServer開發的目的主要是為了方便運行一些簡單的Web程序,例如workerman-todpole等web界面程序。
## 使用方法
在Applications/YourApp/start.php中添加
```php
use \Workerman\Worker;
use \Workerman\WebServer;
require_once __DIR__ . '/Workerman/Autoloader.php';
// 這里監聽8080端口,如果要監聽80端口,需要root權限,并且端口沒有被其它程序占用
$webserver = new WebServer('http://0.0.0.0:8080');
// 類似nginx配置中的root選項,添加域名與網站根目錄的關聯,可設置多個域名多個目錄
$webserver->addRoot('www.example.com', '/your/path/of/web/');
$webserver->addRoot('blog.example.com', '/your/path/of/blog/');
// 設置開啟多少進程
$webserver->count = 4;
Worker::runAll();
```
# WorkerMan的Webserver與普通Web開發異同
### 1、普通Web程序架構運行機制
一般的Web程序一般都是基于nginx+php-fpm或者apache+php的架構開發的,這些架構的運行機制一般是是每個請求都會經過請求初始化、創建執行環境、詞法解析、語法解析、編譯生成opcode以及請求關閉釋放各種資源(如果有opcode緩存會跳過詞法解析、語法解析、編譯生成opcode步驟)
### 2、WorkerMan架構Web程序運行機制
WorkerMan是常駐內存的運行機制,只要PHP文件被載入編譯過一次,便會常駐內存,不會再去從磁盤讀取或者再去編譯,并省去了重復的請求初始化、創建執行環境、詞法解析、語法解析、編譯生成opcode以及請求關閉釋放各種資源等諸多耗時的步驟。剩下的只是簡單的計算過程,所以性能很高。正因為常駐內存,所以類、函數、常量等定義代碼只要運行一次,便可以永久使用,不會被銷毀,所以要避免反復加載類、函數、常量等定義文件。比較簡單的辦法是使用require\_once加載文件,避免重復加載重復定義。
### 3、避免使用exit、die語句
同樣的,在程序中避免使用exit、die語句,使用exit、die會導致進程退出。可以使用```\\Workerman\\Protocols\\Http::end($msg)```函數替代exit、die函數。
### 4、HTTP相關函數的使用
WorkerMan運行在PHP CLI模式下,PHP CLI模式下無法使用HTTP相關的函數,例如```header、setcookie、session\_start```等函數,請使用```/Workerman/Protocols/Http.php```文件中的```header、setcookie、sessionStart```等方法替換。
### 5、Web入口文件
WorkerMan的WebServer默認使用index.php作為Web入口文件,例如配置```$webserver->setRoot('www.example.com', '/home/www/');```,則www.example.com
的入口文件為```/home/www/index.php```。當url訪問的文件(包括靜態文件和PHP文件)不存在時,會自動調用入口文件index.php
### 6、可用的超全局變量
可用的超全局變量有```$\_SERVER、$\_GET、$\_POST、$\_FILES、$\_COOKIE、$\_SESSION、$\_REQUEST```。
無法使用```php://input```,請用```$GLOBALS\['HTTP\_RAW\_POST\_DATA'\] ```代替。
注意HTTP文件上傳中,WorkerMan的```$\_FILES```結構與傳統PHP中的```$\_FILES```結構不同,WorkerMan中```$\_FILES```結構類似
```php
var_export($_FILES);
array(
0 => array(
'file_name' => 'logo.png', // 文件名稱
'file_size' => 23654, // 文件大小
'file_data' => '*****', // 文件的二進制數據
),
1 => array(
'file_name' => 'file.tar.gz', // 文件名稱
'file_size' => 128966, // 文件大小
'file_data' => '*****', // 文件的二進制數據
),
...
);
```
保存文件代碼類似
```php
// 例如保存到/tmp目錄下
foreach($_FILES as $file_info)
{
file_put_contents('/tmp/'.$file_info['file_name'], $file_info['file_data']);
}
```
WorkerMan中無法使用```move\_uploaded\_file() is\_uploaded\_file()```這些函數。
### 7、可以設置onWorkerStart、onWorkerStop回調
可以設置onWorkerStart、onWorkerStop回調,做進程啟動時全局初始化及進程退出(stop等命令)數據保存清理工作
- 序言
- 原理
- 開發必讀
- 入門指引
- 特性
- 簡單的開發示例
- 安裝
- 環境要求
- 下載安裝
- 啟動停止
- 開發流程
- 開發前必讀
- 目錄結構
- 開發規范
- 基本流程
- 通訊協議
- 通訊協議作用
- 定制通訊協議
- 一些例子
- Worker類
- 構造函數
- 屬性
- id
- count
- name
- protocol
- transport
- reusePort
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回調屬性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- runAll
- stopAll
- listen
- TcpConnection類
- 屬性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- maxPackageSize
- 回調屬性
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- AsyncTcpConnection類
- 構造函數
- connect
- reconnect
- transport
- Timer定時器類
- add
- del
- 定時器注意事項
- WebServer
- 調試
- 基本調試
- 查看運行狀態
- 網絡抓包
- 跟蹤系統調用
- 常用組件
- GlobalData數據共享組件
- GlobalDataServer
- GlobalDataClient
- Channel分布式通訊組件
- ChannelServer
- channelClient
- 例子-集群推送
- 例子-分組發送
- FileMonitor文件監控組件
- MySQL組件
- workerman/mysql
- swoole/mysql(異步)
- redis組件
- swoole/redis
- 異步http組件
- swoole/http-client
- 異步消息隊列組件
- react/zmq
- react/stomp
- 異步dns組件
- swoole/dns
- 常見問題
- 心跳
- 客戶端鏈接失敗原因
- 是否支持多線程
- 與其它框架整合
- 運行多個workerman
- 支持哪些協議
- 如何設置進程數
- 查看客戶端連接數
- 對象和資源的持久化
- 例子無法工作
- 啟動失敗
- 停止失敗
- 支持多少并發
- 更改代碼不生效
- 向指定客戶端發送數據
- 如何主動推送消息
- 在其它項目中推送
- 如何實現異步任務
- status里send_fail的原因
- Windows下開發Linux下部署
- 是否支持socket.io
- 終端關閉導致workerman關閉
- 與nginx apache的關系
- 禁用函數檢查
- 平滑重啟原理
- 為Flash開843端口
- 如何廣播數據
- 如何建立udp服務
- 監聽ipv6
- 關閉未認證的鏈接
- 傳輸加密-ssl/tsl
- 創建wss服務
- 創建https服務
- workerman作為客戶端
- 作為ws/wss客戶端
- PHP的幾種回調寫法
- 附錄
- Linux內核調優
- 壓力測試
- 安裝擴展
- websocket協議
- ws協議
- text協議
- frame協議
- 不支持的函數/特性
- 版權信息