Merge 979553d into a43a7a0

.gitignore

@@ -7,3 +7,5 @@
 /vendor/
 /log/
 /cache
+!/cache/better-serializer/.gitkeep
+!/cache/jms-serializer/.gitkeep

README.md

@@ -112,10 +112,13 @@ The usage is described [here](doc/Usage.md).
 
 The de/serializaton annotations are described [here](doc/Annotations.md).
 
+If you'd like to write custom extensions for special de/serialising of selected data types, 
+check the [extensions section](doc/Extensions.md)
+
 ## Future Plans
 - ~~metadata caching~~
 - XML and YAML support
-- various collection classes support (Doctrine collections, internal PHP collections like SplStack)
+- various collection classes support (~~Doctrine collections~~, internal PHP collections like SplStack)
 - data injection using class constructors (~~internal~~ and static), which should improve performance even more
 - various features import from JmsSerializer and Jackson
 - framework integrations

composer.json

@@ -33,7 +33,8 @@
         "phpstan/phpstan": "^0.7",
         "satooshi/php-coveralls": "~1.0",
         "jms/serializer": "^1.8",
-        "phpro/grumphp": "^v0.12"
+        "phpro/grumphp": "^v0.12",
+        "doctrine/collections": "^1.5"
     },
 
     "autoload": {
@@ -47,5 +48,11 @@
             "BetterSerializer\\": "tests/BetterSerializer/",
             "Integration\\": "tests/Integration/"
         }
+    },
+
+    "config": {
+        "platform": {
+            "php": "7.1"
+        }
     }
 }

dev/phpstan.neon

@@ -3,6 +3,10 @@ parameters:
         - '#Method BetterSerializer\\DataBind\\MetaData\\Type\\Factory\\TypeFactory::getType\(\) should return BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface but returns BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface|null#'
         - '#Call to an undefined method BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface::getNestedType\(\)#'
         - '#Call to an undefined method BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface::getClassName\(\)#'
+        - '#Call to an undefined method BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface::getCustomType\(\)#'
+        - '#Call to an undefined method BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface::getParameters\(\)#'
+        - '#Call to an undefined method BetterSerializer\\DataBind\\MetaData\\Type\\StringFormType\\StringFormTypeInterface::getCollectionValueType\(\)#'
+        - '#Call to an undefined method BetterSerializer\\DataBind\\MetaData\\Type\\TypeInterface::getInterfaceName\(\)#'
 
     excludes_analyse:
         - %rootDir%/../../../tests/*

doc/Annotations.md

@@ -49,7 +49,11 @@ The following types are supported currently:
 | string                                                   | Primitive string                                 |
 | array<T>                                                 | An array of type T (T can be any available type).<br>Examples:<br>array<string>, array<MyNamespace\MyObject>, etc.|
 | T[]                                                      | An array of type T (T can be any available type).|
-| T                                                        | Where T is a class name. It either can be fully qualified, or relative to the current namespace of the parent class.| 
+| T                                                        | Where T is a class name. It either can be fully qualified, or relative to the current namespace of the parent class.|
+| Collection<T>                                            | A Doctrine collection of type T, where T is a class name. It either can be fully qualified, or relative to the current namespace of the parent class. This short notation expect a use clasue with FQDN Collection.| 
+| Doctrine\Common\Collections\Collection<T>                | A Doctrine collection of type T, without the FQDN Collection use clause. | 
+| DateTime(format='Y-m-d H:i:s')                           | DateTime object with custom format (default format is DateTime::ATOM)|
+| DateTimeImmutable(format='Y-m-d H:i:s')                  | DateTimeImmutable object with custom format (default format is DateTime::ATOM)|
 
 ### @BoundToProperty