| 依賴 | 說明 |
|---|---|
| PHP | >= 5.5.9 |
| Swoole | >= 1.7.19 推薦最新的穩(wěn)定版 從2.0.12開始不再支持PHP5 |
| Laravel / Lumen | >= 5.1 |
| Gzip[可選的] | zlib , 檢查本機libz是否可用 ldconfig -p|grep libz |
安裝
1.通過 Composer 安裝( packagist )
# 在你的Laravel/Lumen項目的根目錄下執(zhí)行 composer require "hhxsv5/laravel-s:~1.0" -vvv # 確保你的composer.lock文件是在版本控制中
2.添加service provider
Laravel : 修改文件 config/app.php
'providers' => [ //... Hhxsv5\LaravelS\Illuminate\LaravelSServiceProvider::class, ],
Lumen : 修改文件 bootstrap/app.php
$app->register(Hhxsv5\LaravelS\Illuminate\LaravelSServiceProvider::class);
3.發(fā)布配置文件
php artisan laravels publish
特別情況 : 你不需要手動加載配置 laravels.php ，LaravelS底層已自動加載。
// 不必手動加載，但加載了也不會有問題
$app->configure('laravels');
4.修改配置 config/laravels.php ：監(jiān)聽的IP、端口等，請參考 配置項 。
運行
php artisan laravels {start|stop|restart|reload|publish}
| 命令 | 說明 |
|---|---|
| start | 啟動LaravelS，展示已啟動的進程列表 ps -ef|grep laravels |
| stop | 停止LaravelS |
| restart | 重啟LaravelS |
| reload | 平滑重啟所有worker進程，這些worker進程內包含你的業(yè)務代碼和框架(Laravel/Lumen)代碼，不會重啟master/manger進程 |
| publish | 發(fā)布配置文件到你的項目中 config/laravels.php |
與Nginx配合使用
upstream laravels {
server 192.168.0.1:5200 weight=5 max_fails=3 fail_timeout=30s;
#server 192.168.0.2:5200 weight=3 max_fails=3 fail_timeout=30s;
#server 192.168.0.3:5200 backup;
}
server {
listen 80;
server_name laravels.com;
root /xxxpath/laravel-s-test/public;
access_log /yyypath/log/nginx/$server_name.access.log main;
autoindex off;
index index.html index.htm;
# Nginx處理靜態(tài)資源，LaravelS處理動態(tài)資源。
location / {
try_files $uri @laravels;
}
location @laravels {
proxy_http_version 1.1;
# proxy_connect_timeout 60s;
# proxy_send_timeout 60s;
# proxy_read_timeout 120s;
proxy_set_header Connection "keep-alive";
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $host;
proxy_pass http://laravels;
}
}
監(jiān)聽事件
通常，你可以在這些事件中重置或銷毀一些全局或靜態(tài)的變量，也可以修改當前的請求和響應。
laravels.received_request 將 swoole_http_request 轉成 Illuminate\Http\Request 后，在Laravel內核處理請求前。
// 修改`app/Providers/EventServiceProvider.php`, 添加下面監(jiān)聽代碼到boot方法中
// 如果變量$exents不存在，你也可以調用\Event::listen()。
$events->listen('laravels.received_request', function (\Illuminate\Http\Request $req) {
$req->query->set('get_key', 'hhxsv5');// 修改querystring
$req->request->set('post_key', 'hhxsv5'); // 修改post body
});
laravels.generated_response 在Laravel內核處理完請求后，將 Illuminate\Http\Response 轉成 swoole_http_response 之前(下一步將響應給客戶端)。
$events->listen('laravels.generated_response', function (\Illuminate\Http\Request $req, \Symfony\Component\HttpFoundation\Response $rsp) {
$rsp->headers->set('header-key', 'hhxsv5');// 修改header
});
在你的項目中使用 swoole_http_server 實例
/**
* @var \swoole_http_server
*/
$swoole = app('swoole');// Singleton
var_dump($swoole->stats());
注意事項
推薦通過 Illuminate\Http\Request 對象來獲取請求信息，兼容$_SERVER、$_GET、$_POST、$_FILES、$_COOKIE、$_REQUEST， 不能使用 $_SESSION、$_ENV。
public function form(\Illuminate\Http\Request $request)
{
$name = $request->input('name');
$all = $request->all();
$sessionId = $request->cookie('sessionId');
$photo = $request->file('photo');
$rawContent = $request->getContent();
//...
}
推薦通過返回 Illuminate\Http\Response 對象來響應請求，兼容echo、vardump()、print_r()， 不能使用 函數(shù)像exit()、
die()、header()、setcookie()、http_response_code()。
public function json()
{
return response()->json(['time' => time()])->header('header1', 'value1')->withCookie('c1', 'v1');
}
你聲明的全局、靜態(tài)變量必須手動清理或重置。
無限追加元素到靜態(tài)或全局變量中，將導致內存爆滿。
// 某類
class Test
{
public static $array = [];
public static $string = '';
}
// 某控制器
public function test(Request $req)
{
// 內存爆滿
Test::$array[] = $req->input('param1');
Test::$string .= $req->input('param2');
}
待辦事項
總結
以上就是這篇文章的全部內容了，希望本文的內容對大家的學習或者工作具有一定的參考學習價值，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。
