開發(fā)者必讀

• GitHub 喜歡記得點個 star

社區(qū)答疑

• QQ 交流群

  • VIP群 579434607 （本群需要付費599元）
  • EasySwoole 官方一群 633921431(已滿)
  • EasySwoole 官方二群 709134628(已滿)
  • EasySwoole 官方三群 932625047(已滿)
  • EasySwoole 官方四群 779897753(已滿)
  • EasySwoole 官方五群 853946743(已滿)
  • EasySwoole 官方六群 524475224(已滿)
  • EasySwoole 官方七群 1016674948

• 商業(yè)支持：

  • QQ 291323003
  • EMAIL admin@fosuss.com

注意事項

• 不要在代碼中執(zhí)行 sleep 以及其他睡眠函數(shù)，這樣會導(dǎo)致整個進程阻塞；協(xié)程中可以使用 Co::sleep()；
• exit/die 是危險的，會導(dǎo)致 Worker 進程退出；
• 可通過 register_shutdown_function 來捕獲致命錯誤，在進程異常退出時做一些清理工作；
• PHP 代碼中如果有異常拋出，必須在回調(diào)函數(shù)中進行 try/catch 捕獲異常，否則會導(dǎo)致工作進程退出；
• EasySwoole 不支持 set_exception_handler，必須使用 try/catch 方式處理異常；
• 在控制器中不能寫共享 Redis 或 MySQL 等網(wǎng)絡(luò)服務(wù)客戶端連接的邏輯，每次訪問控制器都必須 new 一個連接

類/函數(shù)重復(fù)定義

• 新手非常容易犯這個錯誤，由于 EasySwoole 是常駐內(nèi)存的，所以加載類/函數(shù)定義的文件后不會釋放。因此引入類/函數(shù)的 php 文件時必須要使用 include_once 或 require_once，否則會發(fā)生 cannot redeclare function/class 的致命錯誤。

進程隔離與內(nèi)存管理

進程隔離也是很多新手經(jīng)常遇到的問題。修改了全局變量的值，為什么不生效？原因就是全局變量在不同的進程，內(nèi)存空間是隔離的，所以無效。

所以使用 EasySwoole 開發(fā) Server 程序需要了解 進程隔離 問題。

• 不同的進程中 PHP 變量不是共享，即使是全局變量，在 A 進程內(nèi)修改了它的值，在 B 進程內(nèi)是無效的，如果需要在不同的Worker 進程內(nèi)共享數(shù)據(jù)，可以用 Redis、MySQL、文件、Swoole\Table、APCu、shmget 等工具實現(xiàn) Worker 進程內(nèi)共享數(shù)據(jù)

• 不同進程的文件句柄是隔離的，所以在 A 進程創(chuàng)建的 Socket 連接或打開的文件，在 B 進程內(nèi)是無效，即使是將它的 fd 發(fā)送到 B 進程也是不可用的。(句柄不能進程共享)

• 進程克隆。在 Server 啟動時，主進程會克隆當(dāng)前進程狀態(tài)，此后開始進程內(nèi)數(shù)據(jù)相互獨立，互不影響。有疑問的新手可以先弄懂PHP 的 pcntl 擴展

EasySwoole 中對象的4層生命周期

開發(fā) Swoole 程序與普通 LAMP 下編程有本質(zhì)區(qū)別。在傳統(tǒng)的 Web 編程中，PHP 程序員只需要關(guān)注 request 到達，request 結(jié)束即可。而在 Swoole 程序中程序員可以操控更大范圍，變量/對象可以有四種生存周期。

程序全局期

在 EasySwoole 框架根目錄的 bootstrap.php 文件和 EasySwooleEvent.php 文件中的 initialize 事件函數(shù)中創(chuàng)建好的對象，我們稱之為程序全局生命周期對象。這些變量只要沒有被作用域銷毀，在程序啟動后就會一直存在，直到整個程序結(jié)束運行才會銷毀。

有一些服務(wù)器程序可能會連續(xù)運行數(shù)月甚至數(shù)年才會關(guān)閉/重啟，那么程序全局期的對象在這段時間內(nèi)會持續(xù)駐留在內(nèi)存中的。程序全局期對象所占用的內(nèi)存是 Worker 進程間共享的，不會額外占用內(nèi)存。

例如:

• 在 EasySwooleEvent.php 文件中的 initialize 事件函數(shù)中使用 Di 注入一個對象，那么在程序開始之后，在EasySwoole 的控制器中，或者其他地方都可以通過 Di 直接調(diào)用這個對象
• 在 bootstrap.php 中引入一個文件 test.php，該文件定義了一個靜態(tài)變量，那么在 EasySwoole 的控制器，或者其他地方都可以調(diào)用這個靜態(tài)變量

這部分內(nèi)存會在寫時分離（COW），在 Worker 進程內(nèi)對這些對象進行寫操作時，會自動從共享內(nèi)存中分離，變?yōu)檫M程全局對象。

例如:

• 在 EasySwooleEvent.php 文件中的 initialize 事件函數(shù)中使用 Di 注入一個對象，并在用戶 A 訪問控制器時修改了這個對象的屬性，那么其他用戶訪問控制器的時候，獲取這個對象屬性時，可能是未改變的狀態(tài)(因為不同用戶訪問的控制器所在的進程不同，其他進程不會修改到這個變量，所以需要注意這個問題)；
• 在 bootstrap.php 中引入一個文件 test.php，該文件定義了一個靜態(tài)變量 $a = 1，用戶 A 訪問控制器時修改了變量 $a = 2，可能在其他用戶訪問時，依然還是 $a = 1 的狀態(tài)。

進程全局期

Swoole 擁有進程生命周期控制的機制，Worker 進程啟動后創(chuàng)建的對象（onWorkerStart 中創(chuàng)建的對象或者在控制器中創(chuàng)建的對象），在這個子進程存活周期之內(nèi)，是常駐內(nèi)存的。

例如:

• 程序全局生命周期對象被控制器修改之后，該對象會復(fù)制一份出來到控制器所屬的進程，這個對象只能被這個進程訪問，其他進程訪問的依舊是全局對象。
• 給服務(wù)注冊 onWorkerStart 事件(在 EasySwooleEvent.php 中的 mainServerCreate 事件中進行注冊 onWorkerStart 事件)時創(chuàng)建的對象，只會在該 Worker 進程才能獲取到。

會話期

會話期是在 onConnect 后創(chuàng)建，或者在第一次 onReceive 時創(chuàng)建，onClose 時銷毀。一個客戶端連接進入后，創(chuàng)建的對象會常駐內(nèi)存，直到此客戶端斷開連接才會銷毀。

在 LAMP 中，一個客戶端瀏覽器訪問多次網(wǎng)站，就可以理解為會話期。但傳統(tǒng) PHP 程序，并不能感知到。只有單次訪問時使用 session_start，訪問 $_SESSION 全局變量才能得到會話期的一些信息。

Swoole 中會話期的對象直接是常駐內(nèi)存的，不需要 session_start 之類操作。可以直接訪問對象，并執(zhí)行對象的方法。

請求期

請求期是指一個完整的請求發(fā)來，也就是 onReceive 收到請求開始處理，直到返回結(jié)果發(fā)送 response。這個周期所創(chuàng)建的對象，會在請求完成后銷毀。

Swoole 中請求期對象與普通 PHP 程序中的對象就是一樣的。請求到來時創(chuàng)建，請求結(jié)束后銷毀。

swoole_server 中內(nèi)存管理機制

swoole_server 啟動后內(nèi)存管理的底層原理與普通 php-cli 程序一致。具體請參考 Zend VM 內(nèi)存管理方面的文章。

局部變量

在事件回調(diào)函數(shù)返回后，所有局部對象和變量會全部回收，不需要 unset 。如果變量是一個資源類型，那么對應(yīng)的資源也會被 PHP 底層釋放。

function test()
{
    $a = new Object;
    $b = fopen('/data/t.log', 'r+');
    $c = new swoole_client(SWOOLE_SYNC);
    $d = new swoole_client(SWOOLE_SYNC);
    global $e;
    $e['client'] = $d;
}

$a, $b, $c 都是局部變量，當(dāng)此函數(shù) return 時，這3個變量會立即釋放，對應(yīng)的內(nèi)存會立即釋放，打開的 IO 資源文件句柄會立即關(guān)閉。 $d 也是局部變量，但是 return 前將它保存到了全局變量 $e，所以不會釋放。當(dāng)執(zhí)行 unset($e['client']) 時，并且沒有任何其他 PHP 變量仍然在引用 $d 變量，那么 $d 就會被釋放。

全局變量

在 PHP 中，有3類全局變量。

• 使用 global 關(guān)鍵詞聲明的變量
• 使用 static 關(guān)鍵詞聲明的類靜態(tài)變量、函數(shù)靜態(tài)變量
• PHP 的超全局變量，包括 $_GET、$_POST、$GLOBALS 等

全局變量和對象，類靜態(tài)變量，保存在 swoole_server 對象上的變量不會被釋放。需要程序員自行處理這些變量和對象的銷毀工作。

class Test
{
    static $array = array();
    static $string = '';
}

function onReceive($serv, $fd, $reactorId, $data)
{
    Test::$array[] = $fd;
    Test::$string .= $data;
}

• 在事件回調(diào)函數(shù)中需要特別注意非局部變量的 array 類型值，某些操作如 TestClass::$array[] = "string" 可能會造成內(nèi)存泄漏，嚴(yán)重時可能發(fā)生爆內(nèi)存，必要時應(yīng)當(dāng)注意清理大數(shù)組。
• 在事件回調(diào)函數(shù)中，非局部變量的字符串進行拼接操作是必須小心內(nèi)存泄漏，如 TestClass::$string .= $data，可能會有內(nèi)存泄漏，嚴(yán)重時可能發(fā)生爆內(nèi)存。

解決方法

• 同步阻塞并且請求響應(yīng)式無狀態(tài)的 Server 程序可以設(shè)置 max_request，當(dāng) Worker進程/Task進程 結(jié)束運行時或達到任務(wù)上限后進程自動退出。該進程的所有變量/對象/資源均會被釋放回收。
• 程序內(nèi)在 onClose 或設(shè)置定時器及時使用 unset 清理變量，回收資源

約定規(guī)范

• 項目中類名稱與類文件(文件夾)命名，均為大駝峰，變量與類方法為小駝峰。
• 在 HTTP 服務(wù)響應(yīng)中，業(yè)務(wù)邏輯代碼中 echo $var 并不會將 $var 內(nèi)容輸出至瀏覽器頁面相應(yīng)內(nèi)容中，請調(diào)用 Response 實例中的 wirte() 方法實現(xiàn)。