開發必讀 · swoole手冊

# 開發者必須知道的幾個問題 **1、swoole不依賴apache或者nginx** swoole本身已經是一個類似apache/nginx的容器，只要PHP環境OK swoole就可以運行。 **2、是命令行啟動的** 啟動方式類似apache使用命令啟動。 **3、長鏈接必須加心跳** 長鏈接必須加心跳，長鏈接必須加心跳，長鏈接必須加心跳，重要的話說三遍。長鏈接長時間不通訊肯定會被防火墻干掉而斷開。不加心跳的長鏈接應用就等著老板KO你吧。[心跳說明](heart_beat.md) **4、客戶端和服務端協議一定要對應才能通訊** 這個是開發者非常常見的問題。例如客戶端是用websocket協議，服務端必須也是websocket協議(服務端```new swoole_websocket_server("0.0.0.0", 9501)```)才能連得上，才能通訊。不要嘗試在瀏覽器地址欄訪問websocket協議端口，不要嘗試用webscoket協議訪問裸tcp協議端口，協議一定要對應。這里的原理類似如果你要和英國人交流，那么要使用英語。如果要和日本人交流，那么要使用日語。這里的語言就類似與通許協議，雙方(客戶端和服務端)必須使用相同的語言才能交流，否則無法通訊。 **5、鏈接失敗可能的原因** 剛開始使用swoole時很常見的一個問題是客戶端鏈接服務端失敗。原因一般如下： 1、服務器防火墻(包括云服務器安全組)阻止了鏈接（50%幾率是這個） 2、客戶端和服務端使用的協議不一致（30%幾率） 3、ip或者端口寫錯了 (15%的幾率) 4、服務端沒啟動 **6、編碼注意事項** * 不要在代碼中執行sleep以及其他睡眠函數，這樣會導致整個進程阻塞 * exit/die是危險的，會導致worker進程退出，如果需要返回，可以調用return。 * 可通過register_shutdown_function來捕獲致命錯誤，在進程異常退出時做一些請求工作 * PHP代碼中如果有異常拋出，必須在回調函數中進行try/catch捕獲異常，否則會導致工作進程退出 * swoole不支持set_exception_handler，必須使用try/catch方式處理異常 * Worker進程不得共用同一個Redis或MySQL等網絡服務客戶端，Redis/MySQL創建連接的相關代碼可以放到onWorkerStart回調函數中 **7、改代碼要重啟** swoole是常駐內存的擴展，加載類/函數定義的文件后不會釋放，改代碼要重啟swoole server才能看到新代碼的效果。 **8、支持更高并發** 如果業務并發連接數超過1000同時在線，請務必[優化linux內核](內核參數調優.md). **9、注意避免類和常量的重復定義** 由于swoole是常駐內存的，加載類/函數定義的文件后不會釋放，所以要避免多次require/include相同的類或者常量的定義文件。建議使用require_once/include_once加載文件，否則會發生```cannot redeclare function/class``` 的致命錯誤。 **10、進程隔離** 進程隔離也是很多新手經常遇到的問題。修改了全局變量的值，為什么不生效，原因就是全局變量在不同的進程，內存空間是隔離的，所以無效。所以使用swoole開發Server程序需要了解進程隔離問題。 * 不同的進程中PHP變量不是共享，即使是全局變量，在A進程內修改了它的值，在B進程內是無效的 * 如果需要在不同的Worker進程內共享數據，可以用Redis、MySQL、文件、Swoole\Table、APCu、shmget等工具實現 * 不同進程的文件句柄是隔離的，所以在A進程創建的Socket連接或打開的文件，在B進程內是無效，即使是將它的fd發送到B進程也是不可用的 **11、不支持的函數** swoole運行在PHP CLI模式下，PHP CLI模式下無法使用HTTP相關的函數。 * header、setcookie、session_start等函數,可以使用swoole_http_response->header()，swoole_http_response->cookie()，也無法使用move_uploaded_file()，is_uploaded_file()這些函數。 * 無法使用php://input，請用swoole_http_request->rawContent()代替。 * 無法使用$_SERVER、$_GET、$_POST、$_FILES、$_COOKIE、$_SESSION、$_REQUEST，請使用swoole_http_request->$server、swoole_http_request->$get，swoole_http_request->$post，swoole_http_request->$files，swoole_http_request->$cookie分別替代