Skip to content

Latest commit

 

History

History
38 lines (24 loc) · 1.42 KB

troubleshooting.md

File metadata and controls

38 lines (24 loc) · 1.42 KB
Raw

Troubleshooting

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

Using Docker

With Docker Toolbox on Windows

If you get errors like the following when running docker-compose up on Windows:

ERROR: for web  Cannot create container for service web: Invalid bind mount spec "C:\\Users\\Kevin\\api-platform:/app:rw": Invalid volume specification: 'C:\Users\Kevin\api-platform:/app:rw'
←[31mERROR←[0m: Encountered errors while bringing up the project.

Be sure to set the COMPOSE_CONVERT_WINDOWS_PATHS environment variable to 1. It can be done by creating a file called .env in the root of the project containing this line:

COMPOSE_CONVERT_WINDOWS_PATHS=1

Error starting userland proxy

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

The configuration docker is planned to be launch on the port 80 in the docker-compose.yml file.

Using API Platform and JMS Serializer in the same project

By default, JMS Serializer 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:

# app/config/config.yml

jms_serializer:    
    enable_short_alias: false