Symfony error: 500 Internal Server Error – SyntaxErrorException

This article is at first a reminder for me, and if it can helps someone it’s even better 😉

When you work with a ORM (Doctrine for me, with Symfony) you have to think data as entities, objects instead of  database tables.

You are moving away from database (mariaDB in my case) and his constraints, it is a good thing for severals points, but there is one you can forget about and time to time you fall into his trap, and you get a really pretty error message.

An exception occurred while executing ‘INSERT INTO my_table (createdAt, updatedAt, name, commercialName, VAT,  oneField, anotherField, foo, bar, again, andAgain, default) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)’ with params [« 2018-02-23 13:55:24 », « 2018-02-23 13:55:24 », « my company », « really nice company », « 20 », null, « 1 », « 0 », null, null, null, null, 0]:

SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ‘default) VALUES (‘2018-02-23′ at line 1’
500 Internal Server Error – SyntaxErrorException
2 linked Exceptions:

PDOException

No more suspense here, the trap is quite simple and very basic, it’s the reserved keywords.

Reserved Keywords needs to be managed correctly if you want to use them, below see a real life example:

I need to know if a company is the default one for my user, I add a property name « default » (I use annotations for the doctrine mapping) and bam, SQL is broken.

[pastacode lang= »php » manual= »%20%20%20%20%2F**%0A%20%20%20%20%20*%20%40ORM%5CColumn(type%3D%22boolean%22%2C%20nullable%3Dfalse)%0A%20%20%20%20%20*%2F%0A%20%20%20%20private%20%24default%20%3D%20false%3B » message= »doctrine field  » highlight= » » provider= »manual »/]

The above  error message is pretty clear when you think about the keywords, because Doctrine use the property name to create the database field, the new field is:

[pastacode lang= »sql » manual= »%60default%60%20tinyint(1)%20NOT%20NULL » message= » » highlight= » » provider= »manual »/]

And when you want to insert a company:

[pastacode lang= »sql » manual= »INSERT%20INTO%20my_table%20(createdAt%2C%20updatedAt%2C%20%5B…%5D%2C%20default%20)%20″ message= » » highlight= » » provider= »manual »/]

« default » is not quoted, and mariaDb rise an error.

Fortunately we have several solutions, and my personal (subjective) choice:

Rename your property to something not reserved like « defaultCompany »

[pastacode lang= »php » manual= »%24company-%3EisDefaultCompany()%3B » message= » » highlight= » » provider= »manual »/]

I don’t like that, because the entity is a Company, if you name your variable $company to store it, it is not nice to read.

Quote the field name (in the annotations – doc here)

[pastacode lang= »php » manual= »%20%20%20%20%2F**%0A%20%20%20%20%20*%20%40ORM%5CColumn(name%3D%22%60default%60%22%2C%20type%3D%22boolean%22%2C%20nullable%3Dfalse)%0A%20%20%20%20%20*%2F%0A%20%20%20%20private%20%24default%20%3D%20false%3B » message= » » highlight= » » provider= »manual »/]

I don’t like this one either, it is better than the first but it can lead to complications (see the linked documentation)

Force a field name with the annotations

[pastacode lang= »php » manual= »%20%20%20%20%2F**%0A%20%20%20%20%20*%20%40ORM%5CColumn(name%3D%22defaultCompany%22%2C%20type%3D%22boolean%22%2C%20nullable%3Dfalse)%0A%20%20%20%20%20*%2F%0A%20%20%20%20private%20%24default%20%3D%20false%3B » message= » » highlight= » » provider= »manual »/]

Since we need to add the name of the database field if we want to quote it, I prefer have a non reserved keyword, unquoted, and never be worried by some obscure bug or malfunction because I want so bad to use this field name.

With Doctrine you are almost never in the database, it is not a big deal to have a « defaultCompany » field in the « company » table.

It is bother me when I read my code, but I don’t spend time in the SQL, I prefer have this little ugliness in my DB than in my code.