PHP code example of topphp / topphp-client
1. Go to this page and download the library: Download topphp/topphp-client library . Choose the download type require .
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once ('vendor/autoload.php' );
topphp / topphp-client example snippets
全客户端命名空间引用:
use Topphp \TopphpClient \Client ;
Redis客户端助手类命名空间引用:
use Topphp \TopphpClient \redis \RedisHelper ;
Http客户端助手类命名空间引用:
use Topphp \TopphpClient \guzzle \HttpHelper ;
调用方式有两种:
1 、通过原始客户端单例调用指定的客户端
Client::getInstance()->cli("redis" )->set("arr" , ["这是一个数组" ], 90 );
2 、通过助手类直接调用【推荐】
RedisHelper::set("arr" , ["这是一个数组" ], 90 );
HttpHelper::get("https://www.baidu.com" );
$data = [
"field" =>"val"
];
HttpHelper::post(string $url, array $data, string $type = 'json' , array $headers = [])
注意事项:
1 、写好对应的配置后,在骨架即可直接调用,无需传入配置,需要动态切换配置时,只需要通过骨架的config()方法动态修改即可。
2 、还提供一种直接传入配置的方式
Client::getInstance($config)->cli("http" )->get("https://www.baidu.com" );
3 、组价同时也提供直接暴露客户端对象句柄的方式直接调用原生客户端对象,完成更多高级操作
Client::getInstance()->cli("redis" )->handler()->publish( $channel, $message );
RedisHelper::handler()->publish( $channel, $message );
4 、关于获取配置优先级顺序
A.Client::getInstance($config)
B.非手动传入配置的(配置不传,传空或者使用助手类),优先根据指定客户端获取独立配置文件topphpClientHttp、topphpClientRedis、topphpClientSocket中的配置
C.没有配置独立配置文件的Redis客户端会自动获取Cache配置中的redis配置
D.都没有的,会提示配置错误
5 、独立配置文件示例:
Http:暂无需配置,保持默认即可,swoole环境自动提供协程的http客户端
Socket:敬请期待...
Redis:swoole环境已内部集成协程化的Redis客户端
return [
'Redis' => [
'default_connect' => 'default' ,
'default' => [
'host' => '127.0.0.1' ,
'auth' => '' ,
'port' => 6379 ,
'db' => 0 ,
]
]
];
6 、默认的助手类已经提供了大部分常用场景所需的方法,更多用法可以参看单元测试文件和对应的官方文档
bash
./vendor/bin/phpunit tests/ClientTest.php