# 導言
[TOC]
* [用戶案例](用戶案例.md)
* [基于Swoole擴展分布式全棧開發框架](ji-yu-swoole-kuo-zhan-gao-xing-neng-gao-bing-fa-de-php-tong-xun-kuang-jia.md)
PHP是一種被廣泛應用的開源腳本語言,絕大多數開發者使用PHP做基于Web的應用程序,并且有了很多非常知名的Web框架。
傳統的PHP應用程序基本上是在Apache等Web容器中運行的,瀏覽器與Web容器采用HTTP協議通信,然而在很多實際項目中HTTP協議無法滿足我們的需求,尤其是在服務端和客戶端要保持長連接,做實時雙向通訊時,HTTP協議顯得力不從心。例如即時IM通訊,游戲服務器通訊,與硬件傳感器通訊等等,開發這些應用程序我們無法直接使用nginx/apache + PHP來實現。
Swoole擴展的出現使我們重新定義的PHP,我們通過Swoole擴展可以幾乎做我們想做的任何事情,如基于Websocket的服務器、游戲服務器、移動通訊服務器、智能家居服務端、物聯網服務、web服務器、RPC服務器等等。幾乎任何基于TCP/UDP通訊的服務端都可以用PHP來開發。Swoole擴展使得開發者擺脫PHP只能用于Web開發的束縛,向更廣闊的前景發展。
但是強大的Swoole并不那么容易使用,他作為一個擴展來說無一例外是強大的,優異的性能,豐富的Api,如何更容易的使用Swoole帶來的性能和新特性,框架就要出來解決這一矛盾。
SwooleDistributed框架采用了MVC結構,他的一些靈感來自于CI框架,你們在使用的過程中會發現不少CI的影子,這使得我們使用過CI的開發者更容易上手。并且框架針對swoole的api進行了再次封裝,在保證高性能的同時提供了高效率開發。
## 支持投遞任務
針對swoole提供的Task進行了再次封裝,Controller,Model中調用Task只需要一句話。
Task是swoole擴展中task的封裝,在SwooleDistributed可以非常方便的進行異步(同步)任務投遞。
## 定時器
定時器更容易使用,只需要更改配置隨心所遇的調用Model或者Task的Api。
## 協程
不再需要復雜難看的回調,通過yield簡化客戶端代碼。
PS:swoole2.0開始提供了協程,但是支持的并不完整比如task就沒有實現協程模式,穩定性也沒有1.9.x的穩定,框架目前使用的還是1.9.x版本。
##托管同步異步
框架統一了同步與異步Redis/Mysql調用的API和返回格式,也就是說開發者不用自己選擇使用同步還是異步,一切交給框架就行。
PS:這里帶來的好處就是Task和Model的代碼可以互相調用了。
## 單元測試
框架提供了一個類似PHPUNIT的單元測試模塊。
## 連接池
異步Redis和異步Mysql的連接池不需要開發者維護,你們只需要使用就行。
SwooleDistributed借助Miner實現了Mysql的語法構建器。
Miner的用法:[Miner](https://github.com/jstayton/Miner)
另外SwooleDistributed率先支持異步Mysql事務。
## 支持分布式系統
SwooleDistributed搭載dispatch組件實現分布式部署,倆者均是可以集群部署無單點故障。
## 單服務多協議
SwooleDistributed服務器通過配置不同的端口,可以同時處理tcp和http請求,比如開放http api實現給所有tcp的客戶端廣播消息這種需求在SwooleDistributed中實現起來非常簡單。tcp和http請求通過自定義路由器可以指向同一個controller,再通過設置tcp,http方法的前綴可以分離tcp和http的處理方法。
## 支持全局廣播或者向任意客戶端推送數據
SwooleDistributed提供非常方便的API,可以全局廣播數據、可以向某個群體廣播數據、也可以向某個特定客戶端推送數據。配合定時任務,也可以定時推送數據。
## 支持模板引擎
SwooleDistributed的模板引擎采用了plates。
plates的文檔:[plates](http://platesphp.com/)
## 高并發,高性能,低配置
SwooleDistributed使用了swoole的擴展,內部的controller和model采用了對象池的模式,對象重用性能強悍。
SwooleDistributed和dispatch實現了內網自動發現,集群部署零配置。
## 支持服務平滑重啟
當需要重啟服務時(例如發布版本),我們不希望正在處理用戶請求的進程被立刻終止,更不希望重啟的那一刻導致客戶端通訊失敗。框架提供了平滑重啟功能,能夠保障服務平滑升級,不影響客戶端的使用。
## 支持文件更新檢測及自動加載
在開發過程中,我們希望在我們改動代碼后能夠立刻生效,以便查看結果。框架提供了文件檢測及自動加載組件,只要文件有更新,框架會自動運行reload,以便加載新的文件,使之生效。
# SD2概述
保留1.x版本所有功能的支持,2.x版本主要增加了對微服務化的支持,和協程性能的改善。
使用SD框架,無論是1.x用戶還是2.x用戶都可以輕松的將代碼進行微服務化,需要改動的代碼相當少,拆分Controller,理清服務間的依賴關系,就可以實現微服務化。
協程的性能在新版本上也有所提高,首先是qps直接提升了30%,其次是框架內部完全使用了對象池技術,減少了GC的次數內存占用率極小,除了壓測暴漲的連接導致內存峰值外基本無明顯波動。
SD間專用的RPC方案,tcpClient,HttpClient連接池技術等等嶄新的模塊超高的性能,讓你的開發更加簡單。
SD2將內部使用的連接池,協程,對象池等技術全部重新構建,分包更加清晰,模塊間解耦使得可以獨立使用,如果你想單獨開發自己的框架又不想踩坑,那么可以使用這些模塊包。
還有很多細小的功能,如支持Redis lua,框架會自動上傳lua腳本,graylog的支持將日志數據發往graylog服務器,釘釘機器人的支持,用于告警系統的搭建,支持docker,mqtt異步客戶端等等
總之,SD2是一個新的開始,它將探索微服務的美妙世界。
- Introduction
- SD 3.X文檔連接
- 導言
- 用戶案例
- 基于Swoole擴展分布式全棧開發框架
- 選擇SD框架助力企業開發
- 捐贈SwooleDistributed項目
- 框架性能報告
- 更新日志
- VIP服務福利
- 安裝與配置
- 【推薦】全自動安裝部署
- 環境要求
- 使用Composer安裝/更新SD框架
- 通過Docker安裝
- 代碼結構
- 啟動命令
- 服務器配置
- 服務器基礎配置server.php
- 客戶端協議配置client.php
- business.php
- log.php
- 微服務及集群配置consul.php
- fileHeader.php
- mysql.php
- redis.php
- 定時任務配置timerTask.php
- 服務器端口配置ports.php
- catCache.php
- 驗證服務啟動成功
- 微服務-Consul
- 日志工具-GrayLog
- 集群-Cluster
- 內核優化
- 入門教學
- 開發流程
- 開發前必讀
- 開發規范
- 基本流程
- 框架入口
- Model數據模型
- Controller控制器
- 協程
- 協程基礎
- 迭代器
- 調度器
- 使用協程的優勢
- 通過協程的方法屏蔽異步同步的區別
- Select多路選擇器
- 協程Sleep
- 通用協程方法
- 設置超時
- 設置無異常
- 設置降級函數
- initAsynPools
- dump
- 封裝器與路由器
- 封裝器
- sendToUid
- 路由器
- sendToUids
- 對象池
- 擴展組件
- 中間件
- Redis使用介紹
- RedisAsynPool
- Redis具體使用
- sendToAll
- RedisRoute
- Redis+Lua
- Mysql使用介紹
- MysqlAsynPool
- Mysql返回值
- 如何獲取構建的mysql語句
- 如何執行一個SQL
- 如何執行事務
- stopTask
- Mysql具體使用
- 異步客戶端
- Loader
- MqttClient
- model
- SdTcpRpcPool
- task
- HttpClientPool
- view
- TcpClientPool
- AMQP
- initialization
- Memory
- destory
- Cache
- Lock
- Pool
- EventDispatcher
- Process
- Cluster
- TimerTask
- Reload
- Consul
- Context
- 自定義進程
- 進程間RPC
- $http_input
- CatCache
- $http_output
- TimerCallBack
- 專題
- HTTP專欄
- TCP專欄
- 基礎知識
- WebSocket專欄
- 微服務
- Consul配置
- RPC
- REST
- AMQP異步任務系統
- MQTT簡易服務器
- Docker化以及資源編排
- 快速搭建公司內部統一的開發環境
- 使用HTTPS/WSS
- 訂閱/發布
- 游戲專題
- 類介紹
- AppServer
- clearState
- onOpenServiceInitialization
- SwooleDistributedServer
- get_instance
- kickUid
- bindUid
- unBindUid
- coroutineUidIsOnline
- coroutineCountOnline
- setTemplateEngine
- isWebSocket
- isTaskWorker
- getSocketName
- initAsynPools
- addAsynPool
- getAsynPool
- getServerAllTaskMessage
- Controller
- onExceptionHandle
- send
- sendToUid
- sendToUids
- sendToAll
- sendToGroup
- close
- getContext
- defaultMethod
- $redis_pool
- $mysql_pool
- $request_type
- $fd
- $uid
- $client_data
- $request
- $response
- $loader
- $logger
- $server
- $config
- Model
- initialization
- destory
- View
- Task
- stopTask
- HttpInput
- postGet
- post
- get
- getPost
- getAllPostGet
- getAllHeader
- getRawContent
- cookie
- getRequestHeader
- server信息
- getRequestMethod
- getRequestUri
- getPathInfo
- HttpOutput
- setStatusHeader
- setContentType
- setHeader
- end
- setCookie
- endFile
- 單元測試