sumfen/jsonrpc

JSON-RPC 2.0 客户端/服务器实现

2.0.0 2023-09-22 07:57 UTC

This package is auto-updated.

Last update: 2024-09-22 10:19:03 UTC


README

Build Status

JSON-RPC (v2) 的 PHP 实现。包含客户端和服务器库,用于处理包括 通知批量 的请求。

内容

关于

JSON-RPC 是一种协议,允许服务器通过 json 编码的结构进行通信。在其规范中描述为

一种轻量级的远程过程调用协议。它设计得非常简单!

详细信息请见 jsonrpc.org。您可能需要阅读此文档以了解所使用的 json 结构的概述,尽管此实现已经将重负载抽象化。例如,调用远程服务器上的方法就像这样

<?php
$client = new JsonRpc\Client($url);
$client->call('method', array($param1, $param2));

// now do something with $client->result

在服务器端

<?php
// MethodsClass contains the exposed methods
$methods = new MethodsClass();

$server = new JsonRpc\Server($methods);
$server->receive();

安装

最简单的方式是通过 composer。只需创建一个 composer.json 文件并运行 php composer.phar install 来安装它

{
    "minimum-stability": "dev",
    "require": {
        "jsonrpc/jsonrpc": "1.0.*"
    }
}

或者,您可以 下载 并解压缩它,或者克隆此仓库。如果您只是想尝试它,请参阅 示例

使用

如果您通过 composer 下载了库,那么您必须在您的引导代码中添加以下内容

<?php
 require 'vendor/autoload.php';

否则,您必须将 PSR-0 自动加载器指向 src 目录。完整的 使用文档 可以在 Wiki 中找到

示例

最快的方式是将您的浏览器指向 example/client.php,然后所有内容将自动加载。您可以在阅读文档的同时实验代码。

许可协议

Json-Rpc 在 MIT 许可证下授权 - 有关详细信息,请参阅 LICENSE 文件