Phpwriter: PHPDoc & optional MacroTokens argument for formatArray method

Fixing several errors in PHPDoc blocks of PhpWriter and adding optional argument for formatArray method (let's make it consistent with other formatting methods).