開發(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ù)，這樣會導致整個進程阻塞；協(xié)程中可以使用Co::sleep()； -
exit/die是危險的，會導致Worker進程退出； - 可通過
register_shutdown_function來捕獲致命錯誤，在進程異常退出時做一些清理工作； -
PHP代碼中如果有異常拋出，必須在回調(diào)函數(shù)中進行try/catch捕獲異常，否則會導致工作進程退出； -
EasySwoole不支持set_exception_handler，必須使用try/catch方式處理異常； - 在控制器中不能寫共享
Redis或MySQL等網(wǎng)絡服務客戶端連接的邏輯，每次訪問控制器都必須new一個連接
類/函數(shù)重復定義
- 新手非常容易犯這個錯誤，由于
EasySwoole是常駐內(nèi)存的，所以加載類/函數(shù)定義的文件后不會釋放。因此引入類/函數(shù)的 php 文件時必須要使用include_once或require_once，否則會發(fā)生cannot redeclare function/class的致命錯誤。
建議使用 composer 做自動加載
進程隔離與內(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啟動時，主進程會克隆當前進程狀態(tài)，此后開始進程內(nèi)數(shù)據(jù)相互獨立，互不影響。有疑問的新手可以先弄懂PHP的pcntl擴展
EasySwoole 中對象的4層生命周期
開發(fā) Swoole 程序與普通 LAMP 下編程有本質(zhì)區(qū)別。在傳統(tǒng)的 Web 編程中，PHP 程序員只需要關注 request 到達，request 結束即可。而在 Swoole 程序中程序員可以操控更大范圍，變量/對象可以有四種生存周期。
變量、對象、資源、require/include 的文件等下面統(tǒng)稱為對象
程序全局期
在 EasySwoole 框架根目錄的 bootstrap.php 文件和 EasySwooleEvent.php 文件中的 initialize 事件函數(shù)中創(chuàng)建好的對象，我們稱之為程序全局生命周期對象。這些變量只要沒有被作用域銷毀，在程序啟動后就會一直存在，直到整個程序結束運行才會銷毀。
有一些服務器程序可能會連續(xù)運行數(shù)月甚至數(shù)年才會關閉/重啟，那么程序全局期的對象在這段時間內(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)。
程序全局期 include/require 的代碼，必須在整個程序 shutdown 時才會釋放，reload 無效
進程全局期
Swoole 擁有進程生命周期控制的機制，Worker 進程啟動后創(chuàng)建的對象（onWorkerStart 中創(chuàng)建的對象或者在控制器中創(chuàng)建的對象），在這個子進程存活周期之內(nèi)，是常駐內(nèi)存的。
例如:
- 程序全局生命周期對象被控制器修改之后，該對象會復制一份出來到控制器所屬的進程，這個對象只能被這個進程訪問，其他進程訪問的依舊是全局對象。
- 給服務注冊
onWorkerStart事件(在EasySwooleEvent.php中的mainServerCreate事件中進行注冊onWorkerStart事件)時創(chuàng)建的對象，只會在該Worker進程才能獲取到。
進程全局對象所占用的內(nèi)存是在當前子進程內(nèi)存堆的，并非共享內(nèi)存。對此對象的修改僅在當前 Worker 進程中有效，進程全局期 include/require 的文件，在 reload 后就會重新加載
會話期
會話期是在 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 收到請求開始處理，直到返回結果發(fā)送 response。這個周期所創(chuàng)建的對象，會在請求完成后銷毀。
Swoole 中請求期對象與普通 PHP 程序中的對象就是一樣的。請求到來時創(chuàng)建，請求結束后銷毀。
swoole_server 中內(nèi)存管理機制
swoole_server 啟動后內(nèi)存管理的底層原理與普通 php-cli 程序一致。具體請參考 Zend VM 內(nèi)存管理方面的文章。
局部變量
在事件回調(diào)函數(shù)返回后，所有局部對象和變量會全部回收，不需要 unset 。如果變量是一個資源類型，那么對應的資源也會被 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 都是局部變量，當此函數(shù) return 時，這3個變量會立即釋放，對應的內(nèi)存會立即釋放，打開的 IO 資源文件句柄會立即關閉。
$d 也是局部變量，但是 return 前將它保存到了全局變量 $e，所以不會釋放。當執(zhí)行 unset($e['client']) 時，并且沒有任何其他 PHP 變量仍然在引用 $d 變量，那么 $d 就會被釋放。
全局變量
在 PHP 中，有3類全局變量。
- 使用
global關鍵詞聲明的變量 - 使用
static關鍵詞聲明的類靜態(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)存泄漏，嚴重時可能發(fā)生爆內(nèi)存，必要時應當注意清理大數(shù)組。 - 在事件回調(diào)函數(shù)中，非局部變量的字符串進行拼接操作是必須小心內(nèi)存泄漏，如
TestClass::$string .= $data，可能會有內(nèi)存泄漏，嚴重時可能發(fā)生爆內(nèi)存。
解決方法
- 同步阻塞并且請求響應式無狀態(tài)的
Server程序可以設置max_request，當Worker進程/Task進程結束運行時或達到任務上限后進程自動退出。該進程的所有變量/對象/資源均會被釋放回收。 - 程序內(nèi)在
onClose或設置定時器及時使用unset清理變量，回收資源
內(nèi)存管理部分參照了 Swoole 官方文檔。
約定規(guī)范
- 項目中類名稱與類文件(文件夾)命名，均為大駝峰，變量與類方法為小駝峰。
- 在
HTTP服務響應中，業(yè)務邏輯代碼中echo $var并不會將$var內(nèi)容輸出至瀏覽器頁面相應內(nèi)容中，請調(diào)用Response實例中的wirte()方法實現(xiàn)。