如何在 PHP 中通过Composer安装 PHP-Json-Rpc 库实现轻量级的远程过程调用-composer-PHP中文网

直接安装 php-json-rpc 会失败，因其非 packagist 官方包且已弃用；正确方式是 composer require malkusch/php-json-rpc:dev-master 并手动配置 psr-4 自动加载，否则类无法找到。

如何在 php 中通过composer安装 php-json-rpc 库实现轻量级的远程过程调用

直接安装 php-json-rpc 库会失败，因为官方已弃用且无 Composer 包

php-json-rpc 并不是一个在 Packagist 上注册的合法 Composer 包，直接运行 composer require php-json-rpc/php-json-rpc 会报错：Package php-json-rpc/php-json-rpc not found。它最早是 GitHub 上一个名为 malkusch/php-json-rpc 的个人项目（2013 年起），但作者早已停止维护，也未提交到 Packagist。现在搜到的所谓“php-json-rpc”大多指向这个废弃仓库或 fork 分支，没有稳定版本号、无 PHP 8+ 兼容、无自动加载配置。

替代方案：用 composer require malkusch/php-json-rpc@dev-master（仅限测试）

如果你明确需要该库的原始行为（比如兼容旧服务端协议、调试遗留系统），可临时拉取源码，但必须手动指定分支并接受风险：

运行 composer require malkusch/php-json-rpc:dev-master —— 注意不是 php-json-rpc，作者用户名是 malkusch
该仓库无 composer.json 的 autoload 配置，需在项目根目录 composer.json 中手动添加 PSR-4 映射：
```
{"autoload": {"psr-4": {"malkusch\jsonrpc\": "vendor/malkusch/php-json-rpc/src/"}}
```
执行 composer dump-autoload 生效，否则 new malkuschjsonrpcClient() 会提示类找不到
PHP 8.0+ 下部分反射调用会报 Deprecated: Required parameter $context follows optional parameter，需自行 patch Client.php 第 172 行左右

真正推荐的做法：换用 actively-maintained 替代库

生产环境请放弃 malkusch/php-json-rpc，改用现代、有测试、支持 PSR-7 和 async 的库：

wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support

基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。

下载

json-rpc-protocol/json-rpc-protocol：纯协议层实现（无 HTTP 绑定），轻量、类型安全，适合自定义 transport（如 WebSocket、Swoole）
php-http/jsonrpc-client：基于 HTTPlug + PSR-7，可插拔 HTTP 客户端（Guzzle、Curl、Symfony HttpClient 均可），自动处理请求/响应序列化
若只需简单调用，直接用 curl_exec() + json_encode()/json_decode() 手写 RPC 调用更可控，5 行内搞定，避免依赖膨胀

例如最简 JSON-RPC 2.0 客户端：

$payload = json_encode(['jsonrpc' => '2.0', 'method' => 'add', 'params' => [1,2], 'id' => 1]);<br>$ch = curl_init('https://api.example.com/rpc');<br>curl_setopt_array($ch, [<code>CURLOPT_RETURNTRANSFER</code> => true, <code>CURLOPT_POST</code> => true, <code>CURLOPT_POSTFIELDS</code> => $payload, <code>CURLOPT_HTTPHEADER</code> => ['Content-Type: application/json']]);<br>echo curl_exec($ch);

注意 vendor/autoload.php 加载时机与命名空间冲突

即使成功安装废弃库，常见问题不是功能缺失，而是加载冲突：

多个 JSON-RPC 相关包（如 json-rpc-protocol 和 malkusch/php-json-rpc）都声明了 JsonRpc 类名或顶层命名空间，导致 Class 'JsonRpcClient' not found
composer install 后未确认 vendor/autoload.php 是否被入口文件正确引入（尤其在 CLI 脚本中容易漏掉）
某些框架（如 Laravel）会自动优化 autoloader，而 dev-master 分支无 composer.json autoload 定义，导致 classmap 不生成 —— 此时必须强制 composer dump-autoload -o

真正麻烦的从来不是“怎么装”，而是“装完之后为什么类找不到”——多数时候是 autoload 配置没对，而不是库本身有问题。