# GlobalData 組件客戶端
**`(要求Workerman版本>=3.3.0)`**
# \_\_construct
```php
void \GlobalData\Client::__construct(mixed $server_address)
```
實例化一個\\GlobalData\\Client客戶端對象。通過在客戶端對象上賦值屬性來進程間共享數據。
### 參數
GlobalData server 服務端地址,格式```<ip地址>:<端口>```,例如```127.0.0.1:2207```。
如果是GlobalData server集群,則傳入一個地址數組,例如```array('10.0.0.10:2207', '10.0.0.0.11:2207')```
## 說明
支持賦值、讀取、isset、unset操作。
同時支持cas原子操作。
## 例子
```php
<?php
use Workerman\Worker;
require_once __DIR__ . '/Workerman/Autoloader.php';
require_once __DIR__ . '/GlobalData/src/Client.php';
// GlobalData Server
$global_worker = new GlobalData\Server('0.0.0.0', 2207);
$worker = new Worker('tcp://0.0.0.0:6636');
// 進程啟動時
$worker->onWorkerStart = function()
{
// 初始化一個全局的global data client
global $global;
$global = new \GlobalData\Client('127.0.0.1:2207');
};
// 每次服務端收到消息時
$worker->onMessage = function($connection, $data)
{
// 更改$global->somedata的值,其它進程會共享這個$global->somedata變量
global $global;
echo "now global->somedata=".var_export($global->somedata, true)."\n";
echo "set \$global->somedata=$data";
$global->somedata = $data;
};
Worker::runAll();
```
### 全部用法(php-fpm環境也可以使用)
```php
require_once __DIR__ . '/GlobalData/src/Client.php';
$global = new Client('127.0.0.1:2207');
var_export(isset($global->abc));
$global->abc = array(1,2,3);
var_export($global->abc);
unset($global->abc);
var_export($global->add('abc', 10));
var_export($global->increment('abc', 2));
var_export($global->cas('abc', 12, 18));
```
## 注意:
GlobalData組件無法共享資源類型的數據,例如mysql連接、socket連接等無法共享。
如果在Workerman環境中使用GlobalData/Client,請在onXXX回調中實例化GlobalData/Client對象,例如在onWorkerStart中實例化。
不能這樣操作共享變量。
```php
$global->somekey = array();
$global->somekey[]='xxx';
$global->someObject = new someClass();
$global->someObject->someVar = 'xxx';
```
可以這樣
```php
$somekey = array();
$somekey[] = 'xxx';
$global->somekey = $somekey;
$someObject = new someClass();
$someObject->someVar = 'xxx';
$global->someObject = $someObject;
```
- 序言
- 原理
- 開發必讀
- 入門指引
- 特性
- 簡單的開發示例
- 安裝
- 環境要求
- 下載安裝
- 啟動停止
- 開發流程
- 開發前必讀
- 目錄結構
- 開發規范
- 基本流程
- 通訊協議
- 通訊協議作用
- 定制通訊協議
- 一些例子
- Worker類
- 構造函數
- 屬性
- id
- count
- name
- protocol
- transport
- reusePort
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回調屬性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- runAll
- stopAll
- listen
- TcpConnection類
- 屬性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- maxPackageSize
- 回調屬性
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- AsyncTcpConnection類
- 構造函數
- connect
- reconnect
- transport
- Timer定時器類
- add
- del
- 定時器注意事項
- WebServer
- 調試
- 基本調試
- 查看運行狀態
- 網絡抓包
- 跟蹤系統調用
- 常用組件
- GlobalData數據共享組件
- GlobalDataServer
- GlobalDataClient
- Channel分布式通訊組件
- ChannelServer
- channelClient
- 例子-集群推送
- 例子-分組發送
- FileMonitor文件監控組件
- MySQL組件
- workerman/mysql
- swoole/mysql(異步)
- redis組件
- swoole/redis
- 異步http組件
- swoole/http-client
- 異步消息隊列組件
- react/zmq
- react/stomp
- 異步dns組件
- swoole/dns
- 常見問題
- 心跳
- 客戶端鏈接失敗原因
- 是否支持多線程
- 與其它框架整合
- 運行多個workerman
- 支持哪些協議
- 如何設置進程數
- 查看客戶端連接數
- 對象和資源的持久化
- 例子無法工作
- 啟動失敗
- 停止失敗
- 支持多少并發
- 更改代碼不生效
- 向指定客戶端發送數據
- 如何主動推送消息
- 在其它項目中推送
- 如何實現異步任務
- status里send_fail的原因
- Windows下開發Linux下部署
- 是否支持socket.io
- 終端關閉導致workerman關閉
- 與nginx apache的關系
- 禁用函數檢查
- 平滑重啟原理
- 為Flash開843端口
- 如何廣播數據
- 如何建立udp服務
- 監聽ipv6
- 關閉未認證的鏈接
- 傳輸加密-ssl/tsl
- 創建wss服務
- 創建https服務
- workerman作為客戶端
- 作為ws/wss客戶端
- PHP的幾種回調寫法
- 附錄
- Linux內核調優
- 壓力測試
- 安裝擴展
- websocket協議
- ws協議
- text協議
- frame協議
- 不支持的函數/特性
- 版權信息