phpMussel Files

MINOR RELEASE (CVDs: +55+21419+10).

• [2016.01.08; Sub-minor code change; Maikuolan]: Closing PHP tags removed and all tabs converted to spaces (PSR-2); Added some phpDoc comments to all script files, most of the functions now documented; No other changes. Refer github.com/Maikuolan/phpMussel/issues/80

• [2016.01.10; Sub-minor code change; Maikuolan]: Minor adjustments made to various functions, in order to better comply with the stipulations of their associated phpDoc comments.

• [2016.01.29; Bug-fixes; Maikuolan]: Found a very minor typo in the language string of one of the error codes (low priority); Fixed. Bug found by DanielRuf whereby an incorrect error ("Invalid file") was given when an UPLOAD_ERR_FORM_SIZE error should've been given instead; Fixed. Several error code if conditionals found to be incomplete; Fixed.

• [2016.02.04; Sub-minor code change; Mie Shinohara]: Completed translation of Japanese/日本語 language data [lang.ja.inc] / (this replaces the fuzzy/incomplete translations used previously by phpMussel).

• [2016.02.04; Sub-minor code change; Maikuolan]: Adjusted one of the language strings ("update_fetch") and adjusted its usage by the updater [update.inc], due to constraints previously imposed by its usage (some problems with correct word order for some languages could be caused by its previously imposed usage).

• [2016.02.04; Documentation; Maikuolan]: Added some more goals to the changelog goals list. Found a small error in the documentation ("require" and "include" are referred to as commands, and presented as functions, but they are statements; documentation updated to reflect this).

• [2016.02.07; Sub-minor code change; Maikuolan]: Completely rewrote the header included with all the PHP files of phpMussel, ditching the ASCII art, simplifying all the information contained within [the header] and restructuring it as a singular page-level phpDoc comment (as per discussed with the team, prior to implementation). Some more PSR work done. Marked all PHP <5.4.0 fallback functions as deprecated (these will be removed from phpMussel v1.0.0 and should no longer be used; the minimum required version of PHP for phpMussel should be regarded as PHP 5.4.0; additionally, more recent versions of PHP are strongly encouraged wherever possible). Refer github.com/Maikuolan/phpMussel/issues/82

• [2016.02.07; Documentation]: "/_docs/LICENSE" renamed to "/LICENSE.txt".

• [2016.02.08-2016.02.16; Minor code change; Maikuolan]: Completely reorganised the structure of the entirety of the phpMussel core code: The "core script" [phpmussel.inc] doesn't exist anymore, having now since been split apart into separate files to handle the separate various aspects and functions of the core code; Along with the other existing script files that constitute the core code of phpMussel (not inclusive of non-code files or the language data), they now number eight (8) separate script files; This improves PSR compliancy (PSR-1: "Files SHOULD either declare symbols {classes, functions, constants, etc.} or cause side-effects {e.g. generate output, change .ini settings, etc.} but SHOULD NOT do both.") and improves the overall logical flow of phpMussel, reducing potential cognitive dissonance between different developers and different users. These eight (8) separate script files consist of the "loader" [phpmussel.php], the "functions file" [functions.inc], the "CLI handler" [cli.inc], the "configuration handler" [config.inc], the "controls handler" [controls.inc], the "language handler" [lang.inc] and the "update handler" [update.inc]. Completely ceased using the $_GLOBALS superglobal of PHP in favour of simply declaring a global variable within the various functions of phpMussel wherever required; This should improve performance and memory usage. All variables defined by phpMussel within the global scope have been merged as elements into a single array variable, and this single array variable will be used for similar variables in the future, to make cleanup afterwards easier, simpler and more efficient; This should help to ensure that phpMussel can correctly unset itself from memory when it's no longer required by the request or the running PHP process. Signatures have been moved into their own subdirectory within the vault, "/signatures/"; This improves the logical flow of phpMussel and makes it easier for developers and users alike to find the files they're looking for when looking for files (because it means, for example, that when looking for a specific script file, they won't need to scan over 130+ different files with their eyes to find it); All code dealing with signatures has been updated accordingly, and so, moving the signatures shouldn't be considered a breaking change (the format of the signatures, for example, hasn't changed at all). Removed the fallback for "DIR" ("dirname(FILE)"), because "DIR" is already supported by PHP 5.4.0 (the currently listed minimum PHP version required by phpMussel), and so, the fallback shouldn't be necessary and shouldn't be used anymore. Refer github.com/Maikuolan/phpMussel/issues/80 Refer github.com/Maikuolan/phpMussel/issues/82

• [2016.02.08-2016.02.21; Minor code change; Maikuolan]: Significant code cleanups implemented throughout the core code and overall PSR compliance improved; More phpDoc comments added throughout the core code. Improved the way that many file format checks are performed. Created a new way of parsing existing signatures with the main data handler function, whereby the focus on the way in which signature files are processed is more oriented towards the formatting and type of the signature files in question rather than which actual signature files are in question; An array has been created that references each required signature file and parses them based upon various datapoints also included in this array, and all related signature files are parsed based upon those datapoints, allowing phpMussel to process all signature files in a more homogeneous manner, thus significantly reducing code redundancy and significantly reducing the overall footprint of the core code. Various superfluous parts of the core code have been removed, a number of conditionals with excessive depths have been merged and phpMussel has become more flexible in the way that signatures are handled; It's now much easier to include non-core thirdparty signatures into phpMussel via plugins and without the need to modify the core code. Refer github.com/Maikuolan/phpMussel/issues/80 Refer github.com/Maikuolan/phpMussel/issues/82

• [2016.02.22-2016.02.23; Sub-minor code change; Maikuolan]: Slightly improved the process for handling archives and rewrote some somewhat clunky-looking parts of it. Some more PSR work done (almost completely compliant with PSR-1 and PSR-2; the next commit to the core code should address any remaining issues and result in complete compliancy). Refer github.com/Maikuolan/phpMussel/issues/80

• [2016.02.24; Documentation; Maikuolan]: Updated the "FILES INCLUDED IN THIS PACKAGE" section of the documentation to reflect the various recent changes made to phpMussel and its package.

• [2016.02.25; Documentation; Maikuolan]: Deleted the plain-text READMEs in favour of maintaining only the markdown READMEs (the plain-text READMEs were superfluous, and maintaining two separate versions/formats of READMEs added to the time required to produce new releases whenever changes were made necessitating any change to the documentation; maintaining only one version/format should improve maintainability and increase the speed at which progress can be made). Deleted the signatures tally (this file wasn't used by anyone and was also superfluous to the package). Updated the anti-virus compatibility information in the READMEs. Added references to some of the ideas/suggestions made by Matthias Kaschubowski to the goals list. Refer github.com/Maikuolan/phpMussel/issues/84 Refer spambotsecurity.com/forum/viewtopic.php?f=57&t=3781

• [2016.02.26; Signatures update; Maikuolan]: Integrated the URLs and domains from Cybercrime Tracker to the URL scanner.

• [2016.02.26; Minor code change; Maikuolan]: Added the ability to prevent the API lookup of specific domains and/or URLs to the URL scanner by way of a new type of entry that can now be added to the URL scanner signatures that'll prevent the API lookup code from looking up specific domains and/or URLs; This will be useful to prevent unnecessary API lookups that would've previously been made to some particular commonly referenced and well known domains and URLs already known to be safe (such as w3.org and schema.org, for example, due to their being linked commonly across numerous websites and HTML files as part of their related specifications). Completed the final adjustments of the core code of phpMussel required in order to be fully compliant with PSR-1 and PSR-2; As such, phpMussel should now be fully compliant with PSR-1 and PSR-2 (the remaining PSRs aren't yet relevant to phpMussel, but will become relevant in the future, and so, will be addressed with later versions of phpMussel). Recompiled the executable testfiles of phpMussel to ensure that they match their associated sourcecode files, due to my having recently updated those sourcecode files; Signatures updated accordingly.

Caleb M / Maikuolan, 27th February 2016.