Download the PHP package mediagone/symfony-powerpack without Composer

Symfony Powerpack

⚠️ This project is in experimental phase, it might be subject to changes.

This package provides efficiency and code-quality helpers for Symfony:

1. Generic param converters
2. Primitive types parameters

Installation

This package requires PHP 7.4+

Add it as Composer dependency:

In order to use primitive type parameters in your controllers, you must register the converters in your services.yaml by adding the following service declaration:

1) Generic param converter

Param Converters are the best way to convert URL or route parameters into entity or Value Object instances. They allow to extract retrieval or conversion logic, preventing code duplication and keeping your controllers clean.

For more details, see Symfony's documentation.

Custom converters are very powerful, but doing Clean Code implies writing a lot of these converters. This package provides a base class that handles boilerplate code for you: you only have to define resolvers that will convert the request's parameter into the desired value.

Value Object converter

Let's take this very basic ValueObject:

You can use it in your controller by typehinting an argument:

The associated param converter only needs a single resolver to transform the value:

The array key acts as suffix for controller's argument name, thus an empty string means that the converter will look for a request parameter with the exact same name than the controller's argument ("searched").

Note: the converters is using $request->get() internally, so it will look successively in all request data available (Route attributes, GET and POST parameters).

Entity converter

Entity converters work the exact same way, but generally imply more complexity in data retrieval. For example, you can define multiple way of getting back an User, by registering multiple resolvers in the converter:

This way, the converter will be able to fetch the user by Id if an userId parameter is supplied to the controller, or by its Name if the given parameter is userName. In other words, the request parameter name is the concatenation of the controller's argument name and the resolver's array key.

Again, it works the same for GET, POST or route's attributes.

Optional parameters

If you need to allow a nullable argument, just make the argument nullable and handle it in your code (eg. to return a custom response):

Exception handling

Exceptions can be thrown in your resolvers, for example if the supplied value is not valid. In some cases, you don't need to handle those errors and you can just consider them as missing values.

You can either:

• Enable the convertResolverExceptionsToNull option on your controller's action, to automatically handle errors and convert the parameter value to null.
• Catch exceptions directly in the resolver, and customize the return value by yourself.

Example of @ParamConverter usage:

Note: don't forget to make your method's argument nullable!

2) Primitive types parameters

The only drawback of ParamConverters is they only work with classes but not with primitive PHP types (int, string, float...) so this package also provides a set of classes that can be used to enforce type-safety for primitive types.

It also provides parameters to extract serialized arrays from the query, built from comma-separated values string :

Again, you only have to typehint arguments in your controller to get the request's values:

License

Symfony Powerpack is licensed under MIT license. See LICENSE file.