v2.0

Author: Sören

.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+composer.lock
+composer.phar
+vendor/

Makefile

@@ -0,0 +1,32 @@
+# Default
+all: deps-install
+
+
+# DEPENDENCY MANAGEMENT
+
+# Updates dependencies according to lock file
+deps-install: composer.phar
+	./composer.phar --no-interaction install
+
+# Updates dependencies according to json file
+deps-update: composer.phar
+	./composer.phar self-update
+	./composer.phar --no-interaction update
+
+
+# TESTS AND REPORTS
+
+# Code standard check
+cs-check: composer.lock
+	./vendor/bin/phpcs --standard=PSR1,PSR12 --encoding=UTF-8 --report=full --colors src
+
+
+# INITIAL INSTALL
+
+# Ensures composer is installed
+composer.phar:
+	curl -sS https://getcomposer.org/installer | php
+
+# Ensures composer is installed and dependencies loaded
+composer.lock: composer.phar
+	./composer.phar --no-interaction install

README.md

@@ -0,0 +1,50 @@
+# Textalk JSON-RPC 2.0
+
+xJsonRPC-PHP is a JSON-RPC library for PHP featuring a client (TODO) and a server. Currently it follows the 2.0 spec of JSON-RPC, including batch calls
+
+## Server
+
+### Usage
+
+There's currently 3 server implementations: Server, WebServer and StdInServer
+
+#### Server
+
+Base class, accepts a JSON string as argument to handle() that is processed as a JSON-RPC request
+
+#### WebServer
+
+Will attempt to read out php://input to get the JSON-RPC request, handle() should be called (without arguments) to make it start processing
+
+#### StdInServer
+
+Does the same as WebServer except it uses php://stdin (command line, etc.) instead of php://input
+
+
+### Implementing methods
+
+
+To implement methods you subclass one of the above servers and add methods.
+These methods must be public in order to be allowed for server use.
+
+Example
+```php
+    use \Textalk\JsonRpc\Server;
+
+    class ExampleServer extends Server
+    {
+        public function echo($echo)
+        {
+            return $echo;
+        }
+    }
+
+    $server = ExampleServer();
+    $response = $server->handle();
+```
+
+And then you can call the echo method with your preferred JSON-RPC client library by connecting to whatever url you have set-up that calls ``$server->handle()``
+
+## Client
+
+TODO

composer.json

@@ -0,0 +1,18 @@
+{
+  "name": "textalk/jsonrpc",
+  "type": "library",
+  "description": " JSON-RPC 2.0 client/server library for PHP",
+  "keywords": ["jsonrpc"],
+  "license": "ISC",
+  "autoload": {
+    "psr-4": {
+      "": "src/"
+    }
+  },
+  "require": {
+    "php": "^7.1|^8.0"
+  },
+  "require-dev": {
+    "squizlabs/php_codesniffer": "^3.5"
+  }
+}

src/Textalk/JsonRpc/ApplicationError.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace Textalk\JsonRpc;
+
+class ApplicationError extends Exception
+{
+}

src/Textalk/JsonRpc/BatchRequest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Textalk\JsonRpc;
+
+class BatchRequest
+{
+    protected $client;
+    protected $calls;
+    protected $result;
+
+    public function __construct(WebClient $client)
+    {
+        $this->client = $client;
+        $this->calls = [];
+    }
+
+    public function __call($method, $args)
+    {
+        $reqid = count($this->calls);
+        $this->calls[] = $this->client->assembleRequest($method, $args, $reqid);
+
+        return $reqid;
+    }
+
+    public function __invoke()
+    {
+        $this->result = $this->client->sendRequest($this->calls);
+        return $this->result;
+    }
+}

src/Textalk/JsonRpc/Exception.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Textalk\JsonRpc;
+
+class Exception extends \Exception
+{
+    public const
+        PARSE_ERROR = -32700,
+        INVALID_REQUEST = -32600,
+        METHOD_NOT_FOUND = -32601,
+        INVALID_PARAMS = -32602,
+        INTERNAL_ERROR = -32603;
+
+    protected $data;
+
+    public function __construct($code, $message, $data = null)
+    {
+        $this->data = $data;
+        parent::__construct($message, $code);
+    }
+
+    public function getDict()
+    {
+        $data = [
+            'code' => $this->getCode(),
+            'message' => $this->getMessage()
+        ];
+        if ($this->data) {
+            $data['data'] = $this->data;
+        }
+        return $data;
+    }
+
+    public function getData()
+    {
+        return $this->data;
+    }
+}

src/Textalk/JsonRpc/Helper.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Textalk\JsonRpc;
+
+class Helper
+{
+    public static function isAssoc(array $array)
+    {
+        foreach (array_keys($array) as $key) {
+            if (!is_int($key)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}

src/Textalk/JsonRpc/InternalError.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Textalk\JsonRpc;
+
+/**
+ * Internal JSON-RPC error.
+ */
+class InternalError extends Exception
+{
+    public function __construct()
+    {
+        parent::__construct(self::INTERNAL_ERROR, 'Internal error');
+    }
+}

src/Textalk/JsonRpc/InvalidParamsError.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Textalk\JsonRpc;
+
+/**
+ * Invalid method parameter(s).
+ */
+class InvalidParamsError extends Exception
+{
+    public function __construct($data = null)
+    {
+        parent::__construct(self::INVALID_PARAMS, 'Invalid params', $data);
+    }
+}