phpgt/typesafegetter

An interface for objects that expose type-safe getter methods.

Maintainers

Details

github.com/PhpGt/TypeSafeGetter

Source

Issues

Fund package maintenance!
PhpGt

Installs: 7 961

Dependents: 6

Suggesters: 0

Security: 0

Stars: 0

Watchers: 3

Forks: 1

Open Issues: 2

v1.3.2 2023-04-28 14:42 UTC

Requires

  • php: >=8.0

Requires (Dev)

MIT f760c05a37b1cc188dcbf800c5fdfab8a926b4b0

  • Greg Bowler <greg.bowler.woop@g105b.com>

This package is auto-updated.

Last update: 2024-10-28 19:39:06 UTC

README

Throughout PHP.Gt repositories, wherever an object represents enclosed data, a consistent interface is used to expose the data in a type-safe manner.

Build status Code quality Code coverage Current version PHP.Gt/TypeSafeGetter documentation

The following methods are defined by this interface:

  • get(string $name):mixed - A non-type-safe getter, used for getting keys that are not of an inbuilt type
  • getString(string $name):?string
  • getInt(string $name):?int
  • getFloat(string $name):?float
  • getBool(string $name):?bool
  • getDateTime(string $name):?DateTimeInterface
  • getInstance(string $name, class-string<T> $className):?T

Common areas you will see this interface used:

  • Database rows
  • User input (from the query string or posted form data)
  • Session and cookie storage
  • PHP.Gt's DataObject repository.

NullableTypeSafeGetter trait

A lot of repositories within PHP.Gt that utilise this class were repeating the same getter code, so this trait was introduced to remove the repetition. All getter functions of the interface are implemented, introducing a protected helper function getNullableType which removes the repetition of checking null values before casting them. The getNullableType function also allows a callback to be passed as the type parameter, allowing more complex nullable types to be constructed.