nebkam/symfony-traits

Helper trait to ease writing APIs in Symfony

4.0.2 2024-01-30 11:17 UTC

This package is auto-updated.

Last update: 2024-03-01 00:18:24 UTC


README

Latest Stable Version

Symfony Traits

Few helper traits for quicker API development in Symfony

FormTrait

handleJSONForm

  • controller helper method for JSON data sent in POST, PUT or PATCH request content
  • generally speaking, sending JSON content is more flexible than forms, for CRUD with JS frameworks.
public function create(Request $request)
	{
	$entity = new Entity();
	$this->handleJSONForm($request, $entity, EntityType::class, $options = [], $clearMissingFields = true);
	// persist and flush $entity
public function edit(Request $request,Entity $entity)
	{
	$this->handleJSONForm($request, $entity, EntityType::class, $options = [], $clearMissingFields = true);
	// flush entity

handleForm

  • controller helper method for traditional form data in GET or POST
  • I advice using traditional form data only when JSON is out of place (i.e. GET params)
public function example(Request $request)
	{
	$domain = new Domain();
	if ($request->query->count() > 0)
		{
		$this->handleForm($request, $params, DomainType::class, $options = [], $clearMissingFields = true);
		}
	
	// do something with $domain

handleUpload

  • controller helper method to validate a single file upload
  • a lightweight alternative to a File constraint, when you need just one file, not the whole form
public function uploadImage(Request $request)
	{
	$file = $this->handleUpload($request, 'image');
	
	// do something with $file
	}

ValidationExceptionListener

Since all handle* methods in this trait throw a Nebkam\SymfonyTraits\ValidationException, you have to catch it, either via try {..} catch in the controller or via global exception listener. To ease this, this package includes a sample exception listener, which returns validation errors in JSON. You just have to register it as a service:

Nebkam\SymfonyTraits\EventListener\ValidationExceptionListener:
    tags:
        - { name: kernel.event_listener, event: kernel.exception }