1.4升級(jí)指南

升級(jí)前請(qǐng)做好備份，執(zhí)行以下命令升級(jí)
composer require workerman/webman-framework ^1.4.3 && composer require webman/console ^1.0.27 && php webman install

注意
如果無(wú)法升級(jí)，很可能是因?yàn)槭褂昧薱omposer代理，請(qǐng)使用以下命令 composer config -g --unset repos.packagist 恢復(fù)使用composer官方數(shù)據(jù)源

功能特性及變更

應(yīng)用插件

1.4版本支持應(yīng)用插件，更多請(qǐng)參考應(yīng)用插件

自動(dòng)路由

1.4版本支持各種復(fù)雜的控制器目錄規(guī)則，例如

app
app
├── admin
│?? └── v1
│??     └── v2
│??         └── v3
│??             └── controller
│??                 └── Index.php
└── controller
    ├── v1
    │?? └── Index.php
    └── v2
        └── v3
            └── Index.php

也就是說(shuō) webman/auto-route 插件不再需要了

控制器復(fù)用開(kāi)關(guān)

1.4版本允許關(guān)閉控制器復(fù)用，在config/app.php中設(shè)置'controller_reuse' => false,，這樣每個(gè)請(qǐng)求都會(huì)重新初始化一個(gè)新的控制器，也就是說(shuō)每個(gè)請(qǐng)求都會(huì)觸發(fā)對(duì)應(yīng)控制器的__construct()構(gòu)造函數(shù)，開(kāi)發(fā)者可以在構(gòu)造函數(shù)中為每個(gè)請(qǐng)求執(zhí)行一些請(qǐng)求處理前的初始化工作。

因?yàn)榭梢躁P(guān)閉控制器復(fù)用，所以webman/action-hook 插件的不再需要了。

開(kāi)啟http服務(wù)

1.4 版本支持開(kāi)啟多個(gè)端口提供http服務(wù)。
因?yàn)閣ebman請(qǐng)求是排隊(duì)處理的，如果某個(gè)請(qǐng)求處理速度慢，會(huì)影響排隊(duì)中的其它請(qǐng)求。
這時(shí)候我們可以再開(kāi)一些進(jìn)程，把速度慢的接口放在這些進(jìn)程去處理。

例如新開(kāi)一組8686端口的http進(jìn)程只需要在 config/process.php 里增加如下配置。

return [
    // ... 這里省略了其它配置 ...

    'task' => [
        'handler' => \Webman\App::class,
        'listen' => 'http://0.0.0.0:8686',
        'count' => 8, // 進(jìn)程數(shù)
        'constructor' => [
            'request_class' => \support\Request::class, // request類設(shè)置
            'logger' => \support\Log::channel('default'), // 日志實(shí)例
            'app_path' => app_path(), // app目錄位置
            'public_path' => public_path() // public目錄位置
        ]
    ]
];

這樣慢接口可以走 http://127.0.0.1:8686/ 這組進(jìn)程，不影響其它進(jìn)程的業(yè)務(wù)處理。

為了讓前端無(wú)感知端口的區(qū)別，可以在nginx加一個(gè)到8686端口的代理。假設(shè)慢接口請(qǐng)求路徑都是以/pay開(kāi)頭，整個(gè)nginx配置類似如下：

upstream webman {
    server 127.0.0.1:8787;
    keepalive 10240;
}

# 新增一個(gè)8686 upstream
upstream slow {
   server 127.0.0.1:8686;
    keepalive 10240;
}

server {
  server_name webman.com;
  listen 80;
  access_log off;
  root /path/webman/public;

  # 以/pay開(kāi)頭的請(qǐng)求走8686端口
  location /pay {
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $host;
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      proxy_pass http://slow;
  }

  # 其它請(qǐng)求走原8787端口
  location / {
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header Host $host;
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      if (!-f $request_filename){
          proxy_pass http://webman;
      }
  }
}

這樣客戶端訪問(wèn)域名.com/pay/xxx時(shí)將會(huì)走單獨(dú)的8686端口處理，不影響8787端口的請(qǐng)求處理。

視圖文件配置

后綴只能在view.php 的 options選項(xiàng)中配置。
不再支持的用法

use support\view\Raw;
return [
    'handler' => Raw::class,
    'view_suffix' => 'php'
];

正確的用法

use support\view\Raw;
return [
    'handler' => Raw::class,
    'options' => [
        'view_suffix' => '.php'
    ]
];

session驅(qū)動(dòng)命名空間變動(dòng)

webman從1.4.0起更改了SessionHandler類的命名空間，由原來(lái)的

use Webman\FileSessionHandler;  
use Webman\RedisSessionHandler;  
use Webman\RedisClusterSessionHandler;  

改為

use Webman\Session\FileSessionHandler;  
use Webman\Session\RedisSessionHandler;  
use Webman\Session\RedisClusterSessionHandler;

為了避免升級(jí)后程序直接報(bào)錯(cuò)，Webman\FileSessionHandler類仍然被保留一段時(shí)間，在未來(lái)版本中會(huì)被徹底移除。

此變更影響config/session.php的'handler'配置。

文檔連接 http://wtbis.cn/doc/webman/upgrade/1-4.html