Todos cometemos errores, pero si alguien nos lo chiva antes de ponerlos en funcionamiento, mejor.
De eso se encarga el plugin Check Syntax. Con él, al escribir un fichero PHP a disco, nos informará de los errores sintácticos (si los hay).
Para instalarlo, lo de siempre. Descomprimimos el archivo en nuestro directorio ~/.vim/plugin.