Added changelog

Added docs to .sln so i don't have to scoure the repo via file explorer
Added Null context aware to library entry point

Author: sommmen

CHANGELOG.md

@@ -1,11 +1,13 @@
 # 1.0
 
 **Deserialization:**
+- Added `string Serialize(object? input, PhpSerializiationOptions? options = null)` to `PhpSerialization` so the target type can be specified at run time.
+- `PhpSerialization` (entry point of the library) is now null reference aware, aiding library consumers in caching `NullReferenceException`.
 - Bugfix: "INF" and "-INF" would not be handled correctly when using explicit typing (`Deserialize<T>`) for some target types.
 - Bugfix: Properly set classname when deserializing with explicit types that implement IPhpObject.
 - Performance tweaks:
 	- Minor improvements on memory use during deserialization.
-	- Improved performance for deserializing Double and Integer values with explicit types.
+	- Improved performance for deserializing Double and Integer values with explicit types.	
 
 **General:**
 * Bugfix: `PhpSerialization.ClearTypeCache()` was not exposed.

PhpSerializerNET.sln

@@ -7,6 +7,14 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PhpSerializerNET", "PhpSeri
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PhpSerializerNET.Test", "PhpSerializerNET.Test\PhpSerializerNET.Test.csproj", "{5C7EBE99-6F08-4721-B737-6D1FE03620E9}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{2A8B82C9-337E-4316-B5DA-0E6E4154B186}"
+	ProjectSection(SolutionItems) = preProject
+		CHANGELOG.md = CHANGELOG.md
+		Contributors.md = Contributors.md
+		LICENSE = LICENSE
+		README.md = README.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

PhpSerializerNET/PhpSerialization.cs

@@ -4,6 +4,9 @@ This Source Code Form is subject to the terms of the Mozilla Public
   file, You can obtain one at http://mozilla.org/MPL/2.0/.
 **/
 
+// Consumers of this library may use https://docs.microsoft.com/en-us/dotnet/csharp/nullable-references
+#nullable enable
+
 using System;
 using System.Collections.Generic;
 
@@ -29,7 +32,7 @@ public static class PhpSerialization {
 		/// <see cref="Dictionary{object,object}"/> for arrays with mixed keys or objects <br/>
 		/// <see cref="PhpDynamicObject"/> for objects (see options).
 		/// </returns>
-		public static object Deserialize(string input, PhpDeserializationOptions options = null) {
+		public static object? Deserialize(string input, PhpDeserializationOptions? options = null) {
 			if (string.IsNullOrEmpty(input)) {
 				throw new ArgumentException("PhpSerialization.Deserialize(): Parameter 'input' must not be null or empty.");
 			}
@@ -54,7 +57,7 @@ public static object Deserialize(string input, PhpDeserializationOptions options
 		/// </returns>
 		public static T Deserialize<T>(
 			string input,
-			PhpDeserializationOptions options = null
+			PhpDeserializationOptions? options = null
 		) {
 			if (string.IsNullOrEmpty(input)) {
 				throw new ArgumentException("PhpSerialization.Deserialize(): Parameter 'input' must not be null or empty.");
@@ -78,10 +81,10 @@ public static T Deserialize<T>(
 		/// <returns>
 		/// The deserialized object.
 		/// </returns>
-		public static object Deserialize(
+		public static object? Deserialize(
 			string input,
 			Type type,
-			PhpDeserializationOptions options = null
+			PhpDeserializationOptions? options = null
 		) {
 			if (string.IsNullOrEmpty(input)) {
 				throw new ArgumentException("PhpSerialization.Deserialize(): Parameter 'input' must not be null or empty.");
@@ -101,8 +104,9 @@ public static object Deserialize(
 		/// Arrays, lists and dictionaries are serialized into arrays.
 		/// Objects may also be serialized into arrays, if their respective struct or class does not have the <see cref="PhpClass"/> attribute.
 		/// </returns>
-		public static string Serialize(object input, PhpSerializiationOptions options = null) {
-			return new PhpSerializer(options).Serialize(input);
+		public static string Serialize(object? input, PhpSerializiationOptions? options = null) {
+			return new PhpSerializer(options)
+				.Serialize(input) ?? throw new NullReferenceException($"{nameof(PhpSerializer)}.{nameof(Serialize)} returned null");
 		}
 
 		/// <summary>