edmondscommerce/typesafe-functions

Type safe wrappers around internal functions that return mixed types

Typesafe Functions

To assist with boilerplate around working with internal functions but ensuing that your code keeps tools like phpstan and phpqa happy, _(*1)

See Alternative:

https://github.com/thecodingmachine/safe, _(*2)

This is a more comprehensive library of functions that is auto generated., _(*3)

I prefer to only include functions that I actually use in this library, the vast majority of functions above will never be used and so I'm reluctant to bring them all in., _(*4)

Functions Replaced:

File Functions

file_get_contents

returns false|string by default, _(*5)

replaced with \ts\file_get_contents, _(*6)

String Functions

strpos

returns false|int by default, _(*7)

multiple replacements depending on use case:, _(*8)

\ts\strpos to get the actual string position when it is known that the haystack contains the needle, _(*9)

\ts\stringContains to check if the haystack contains the needle, _(*10)

\ts\stringStartsWith to check if the haystack begins with the needle, _(*11)

stripos

//TODO - but will be as above, but case insensitive, _(*12)

Array Functions

in_array

By default this is not strict and requires a third parameter of true., _(*13)

Simply replace with \ts\arrayContains instead to have this handled automatically., _(*14)

This improves readability and also prevents various mutation testing escapees that would be otherwise hard to catch, _(*15)

Find: (|\\)in_array\((.+?),(.+?),.+?\), _(*16)

Replace: \\ts\\arrayContains($2, $3), _(*17)

Debug Functions

print_r

When passing true, this returns a string, for example, _(*18)

<?php
$string=\print_r(['a'=>1], true);

To make this type safe, we replace with, _(*19)

<?php
$string = \ts\varToString(['a'=>1]);

Reflection

ReflectionClass

Always returns a single type, _(*20)

Normalises the type, for example to empty strings or throws exceptions on failure, _(*21)

Find Replace