v2.2 Troubleshooting

This is a list of common pitfalls on using API Platform, and how to avoid them.

# Using Docker

# With Docker Toolbox on Windows

Docker Toolbox is not supported anymore by API Platform. Please upgrade to Docker for Windows.

# Error starting userland proxy

If the app container cannot start and display this Error starting userland proxy: Bind for 0.0.0.0:80, it means that port 80 is already in use.

You can change the port to be used in the docker-compose.yml file (default is port 80).

# Using API Platform and JMS Serializer in the same project

By default, JMS Serializer Bundle replaces the serializer service by its own. However, API Platform requires the Symfony serializer (and not the JMS one) to work properly. Fortunately, this behavior can be deactivated using the following configuration:

# api/config/packages/api_platform.yaml

jms_serializer:    
    enable_short_alias: false

You can also help us improve the documentation of this page.

Made with love by

Les-Tilleuls.coop can help you design and develop your APIs and web projects, and train your teams in API Platform, Symfony, Next.js, Kubernetes and a wide range of other technologies.

Learn more

Copyright © 2023 Kévin Dunglas

Sponsored by Les-Tilleuls.coop