This reverts commit cae3cb012812c2d7e1995301e85c8954567a499d.

Deprecates diverse_array(), generate_name(), refiles() and
upload_file(). These pollute the global namespace and do not follow the
PSR-2 naming convention.

The plan is to create a new file with a new class to share this common
code, leaving upload.php only with the last lines of code that it really
needs to do (calling other class functions).

Acked-by: Eliot Whalan <ewhal@pantsu.cat>

We don't need to care about garbage collection and explicitly unlinking
temporary files: PHP will handle that for us automatically. In other
words, this is "dead" code. Less code the better.

Updates the comment before it to reflect this.

Tested on PHP 5.6.22 and PHP 7.0.7 on Debian stretch/sid GNU/Linux.

Tested-by: Juuso Lapinlampi <wub@partyvan.eu>
See: https://secure.php.net/manual/en/function.tmpfile.php

None of us can find a reason why we would need to buffer our output in a
PHP application. My best guess is this may be a relic from Pomf 1.0.0 or
Moe panel.

Unless someone finds a better reason to keep this, this feature is
useless and has negligible benefit and will be removed.

In respect for SemVer, deprecating this feature happens first in a minor
version before removal in a next major version.

Acked-by: Eliot Whalan <ewhal@pantsu.cat>

Add comments explaining how the number 500 after Exception means HTTP
status code "500 Internal Server Error". This may not be so obvious to
the reader without consulting the PHP manual.

Compliments commit 4606553f38909b483bc06674f9558ede1a9ff1f6.

Reviewed-by: Eliot Whalan <ewhal@pantsu.cat>

Add file summaries, @copyright tags and other comments. Covers majority
of the PHP code base now. I have avoided being too verbose and omitted
some potential tags.

Most visibly to the user, this comments every user configurable setting
and clarifies what some of the options do.

POMF_DB_USER and POMF_DB_PASS are not rendered perfectly in
phpDocumentor version 2.8.5. This is a sacrifice I made in attempt for
not being too verbose and obvious.

Response class gets a @todo for being a god object.

Normally in include_once if a script does not load PHP will treat it as
such as an E_WARNING, while require_once fail the script with a
E_COMPILE_ERROR if the script does not load.

Since we require all of these scripts to properly function it
will be better to classify them as required in PHP.

Reported-by: Juuso Lapinlampi <wub@partyvan.eu>
Reviewed-by: Juuso Lapinlampi <wub@partyvan.eu>