Added BencodeSerializable interface

README.md

@@ -23,8 +23,12 @@ print_r(Bencode::decode('d3:bar4:spam3:fooi42ee'));
 ```
 ArrayObject Object
 (
-    [bar] => spam
-    [foo] => 42
+    [storage:ArrayObject:private] => Array
+        (
+            [bar] => spam
+            [foo] => 42
+        )
+
 )
 ```
 
@@ -38,6 +42,33 @@ print_r(Bencode::encode(['foo' => 42, 'bar' => 'spam']));
 d3:bar4:spam3:fooi42ee
 ```
 
+Supported types are as follow:
+
+ - `array`, `int`, and `string` values are encoded natively.
+ - `float` values that can be losslessly converted to integers are coerced to `int`.
+ - `bool` values are coerced to `int`.
+ - An object that implements `s9e\Bencode\BencodeSerializable` is encoded as the value returned by its `bencodeSerialize()` method.
+ - The properties of an `stdClass` object are encoded in a dictionary.
+ - An instance of `ArrayObject` is treated as an array.
+
+```php
+use s9e\Bencode\Bencode;
+use s9e\Bencode\BencodeSerializable;
+
+$bencodable = new class implements BencodeSerializable
+{
+	public function bencodeSerialize(): array|int|string
+	{
+		return 42;
+	}
+};
+
+print_r(Bencode::encode($bencodable));
+```
+```
+i42e
+```
+
 #### Handle exceptions
 
 ```php

composer.json

@@ -10,7 +10,8 @@
 	},
 	"require-dev": {
 		"phpunit/phpunit": ">=10.0",
-		"nikic/php-fuzzer": "*"
+		"nikic/php-fuzzer": "*",
+		"s9e/repdoc": "dev-wip"
 	},
 	"autoload": {
 		"psr-4": {

src/BencodeSerializable.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+/**
+* @package   s9e\Bencode
+* @copyright Copyright (c) The s9e authors
+* @license   http://www.opensource.org/licenses/mit-license.php The MIT License
+*/
+namespace s9e\Bencode;
+
+interface BencodeSerializable
+{
+	/**
+	* Serialize this object that can be encoded with Bencode::encode()
+	*
+	* @return array|int|string
+	*/
+	public function bencodeSerialize(): array|int|string;
+}

src/Encoder.php

@@ -91,6 +91,10 @@ protected static function encodeIndexedArray(array $array): string
 
 	protected static function encodeObject(object $value): string
 	{
+		if ($value instanceof BencodeSerializable)
+		{
+			return static::encode($value->bencodeSerialize());
+		}
 		if ($value instanceof ArrayObject)
 		{
 			return static::encodeAssociativeArray($value->getArrayCopy());

tests/EncoderTest.php

@@ -6,6 +6,7 @@
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;
 use TypeError;
+use s9e\Bencode\BencodeSerializable;
 use s9e\Bencode\Encoder;
 use s9e\Bencode\Exceptions\EncodingException;
 use stdClass;
@@ -60,6 +61,16 @@ public static function getEncodeTests()
 				'de',
 				new class extends stdClass {}
 			],
+			[
+				'i42e',
+				new class implements BencodeSerializable
+				{
+					public function bencodeSerialize(): array|int|string
+					{
+						return 42;
+					}
+				}
+			],
 			[
 				'd3:fooi1ee',
 				['foo' => 1]