I guess it might be best to do it two different ways.

Perhaps for variables like this, it might be good to explain it more and what should be in it (e.g. the elements from the schema structure listed a few lines up).

For variables like $db, $template, etc that are just other objects, a single line comment should be more than enough and not take up tons of extra space at the top.

Sound reasonable?