Add PHP File-Level DocBlocks Globally

[robfrawley]

Add the following doc-block to all PHP files in this project:

/*
 * This file is part of the `liip/LiipImagineBundle` project.
 *
 * (c) https://github.com/liip/LiipImagineBundle/graphs/contributors
 *
 * For the full copyright and license information, please view the LICENSE.md
 * file that was distributed with this source code.
 */

This has been my file-level doc-block style of choice for quite some time (some may notice it is directly modeled after Symfony's).

That being said, I am more than open to alterations if the consensus suggests one.

[alexwilson]

I wonder if it's worth tagging with phpdoc annotations (@license and co)?

[robfrawley]

Personally, I don't see too much value in adding more lines (and effective wasted horizontal space) to the header comment. I think we should keep it as simple as possible.

For example, one or the other, but not both, would be my preference:

/*
 * This file is part of the `liip/LiipImagineBundle` project.
 *
 * (c) https://github.com/liip/LiipImagineBundle/graphs/contributors
 *
 * For the full copyright and license information, please view the LICENSE.md
 * file that was distributed with this source code.
 */

or

/*
 * This file is part of the `liip/LiipImagineBundle` project.
 *
 * (c) https://github.com/liip/LiipImagineBundle/graphs/contributors
 *
 * @license MIT
 */

[alexwilson]

I see your point, maybe the former is the better option as I see it's a common standard elsewhere - in which case lgtm! 👍

[robfrawley]

@lsmith77 Do you have a format preference for the file-level doc-block? Or is the submitted doc-block okaty?

[lsmith77]

fine for me ..

[robfrawley]

@lsmith77 This is going to become quite a pain to merge as files are updated/removed/added, so I'm not going to constantly re-base it as other changes are merged. Instead, just give me a shout whenever you decide to merge this if it needs a re-base and I'll handle it once, right away.

[robfrawley]

Closing in favor of #800 now that #792 has been merged.