PHP JSON-RPC 项目教程

PHP JSON-RPC 项目教程

php-json-rpcFully unit-tested JSON-RPC 2.0 for PHP项目地址:https://gitcode.com/gh_mirrors/ph/php-json-rpc

1. 项目的目录结构及介绍

php-json-rpc/
├── examples/
│   ├── client.php
│   ├── server.php
│   └── src/
├── src/
│   ├── Client.php
│   ├── Exception.php
│   ├── Server.php
│   └── Utils.php
├── tests/
│   ├── ClientTest.php
│   ├── ServerTest.php
│   └── UtilsTest.php
├── .gitignore
├── CHANGELOG.md
├── COPYING
├── README.md
├── composer.json
└── phpunit.xml.dist

• examples/: 包含客户端和服务器端的示例代码。
• src/: 包含项目的主要源代码文件，包括客户端、服务器和工具类。
• tests/: 包含项目的单元测试文件。
• .gitignore: Git 忽略文件配置。
• CHANGELOG.md: 项目更新日志。
• COPYING: 项目许可证文件。
• README.md: 项目说明文档。
• composer.json: Composer 依赖管理文件。
• phpunit.xml.dist: PHPUnit 测试配置文件。

2. 项目的启动文件介绍

客户端启动文件 (examples/client.php)

<?php
require_once __DIR__ . '/../vendor/autoload.php';

use Datto\JsonRpc\Client;
use Datto\JsonRpc\Transport\Http;

$client = new Client();
$http = new Http($client, 'http://localhost:8080/server.php');

$client->query(1, 'addition', array(2, 3));
$response = $http->send();

echo $response;

服务器端启动文件 (examples/server.php)

<?php
require_once __DIR__ . '/../vendor/autoload.php';

use Datto\JsonRpc\Server;

$server = new Server();

$server->register('addition', function ($a, $b) {
    return $a + $b;
});

$server->register('random', function ($start, $end) {
    return mt_rand($start, $end);
});

$message = file_get_contents('php://input');
$reply = $server->reply($message);

echo $reply;

3. 项目的配置文件介绍

composer.json

{
    "name": "datto/json-rpc",
    "description": "Fully unit-tested JSON-RPC 2.0 for PHP",
    "license": "LGPL-3.0",
    "require": {
        "php": ">=7.0"
    },
    "autoload": {
        "psr-4": {
            "Datto\\JsonRpc\\": "src/"
        }
    },
    "require-dev": {
        "phpunit/phpunit": "^6.0"
    }
}

• name: 项目名称。
• description: 项目描述。
• license: 项目许可证。
• require: 项目依赖的 PHP 版本。
• autoload: 自动加载配置。
• require-dev: 开发依赖。

phpunit.xml.dist

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="JsonRpc Test Suite">
            <directory>tests/</directory>
        </testsuite>
    </testsuites>
</phpunit>

• bootstrap: 指定自动加载文件。
• testsuites: 指定测试套件目录。

php-json-rpcFully unit-tested JSON-RPC 2.0 for PHP项目地址:https://gitcode.com/gh_mirrors/ph/php-json-rpc