\LazyJsonMapperUtilities

createStrictClassPath()

createStrictClassPath(string  $className = '') : string|null

Create a strict, global class path.

This helper ensures that the input is a non-empty string, and then automatically prepends a leading \ if missing, so that PHP understands that the class search MUST happen only in the global namespace.

Parameters

Returns

String if non-empty string input, otherwise NULL.

splitStrictClassPath()

splitStrictClassPath(string  $strictClassPath = '') : array

Splits a strict class-path into its namespace and class name components.

To rejoin them later, just use: 'namespace' + '\\' + 'class'.

The class path should be in get_class() aka TheClass::class format.

Parameters

Returns

Associative array with keys for namespace and class.

createRelativeClassPath()

createRelativeClassPath(array  $sourceComponents, array  $targetComponents) : string

Compare two class paths and generate the shortest path between them.

Parameters

Returns

The final path to reach from the source to the target.

atomicWrite()

atomicWrite(string  $filename, string  $data, string  $atomicSuffix = 'atomictmp') : integer|boolean

Atomic filewriter.

Safely writes new contents to a file using an atomic two-step process. If the script is killed before the write is complete, only the temporary trash file will be corrupted.

The algorithm also ensures that 100% of the bytes were written to disk.

Parameters

Returns

Number of bytes written on success, otherwise FALSE.