Continued:
- added more debug lines
- used lesser deprecated debugOutput() and more propper logging level methods

Continued:
- zero can be an indexed array key, so it is valid, only below zero isn't

Continued:
- added more debug message
- FrameworkConfiguration cannot invoke methods from StringUtils while debug
  lines are active:
---------------
PHP Fatal error:  Uncaught Error: Class
'Org\Mxchange\CoreFramework\Middleware\Debug\DebugMiddleware' not found in
/home/.../core/framework/main/classes/class_BaseFrameworkSystem.php:623
---------------

Continued:
- rather check for extension being loaded than found functions
- checks on resource or object is no longer needed

Continued:
- added more debug lines
- commented some out again

Continued:
- FrameworkBootstrap::loadInclude() now checks if SplFileInfo is referencing
  to a PHP script
- added some more debug lines

Continued:
- commented out some debug lines
- added some more (also commented out)

Continued:
- introduced ConsoleTools::acquireHostname() which acquires own host's name
- some methods of ConsoleTools are now "caching" their being "expensively"
  determined and then returned values
- added more unit tests
- added more debug lines

Continued:
- more debug logging added
- rewrote old $this->outputLine() "logging" to logger middleware
- added more checks on parameter

Continued:
- updated composer dependency file

Continued:
- moved partialStub() method to DebugMiddleware

Continued:
- exit; means normal exit of program

Continued:
- no need for initializing the debug sub-system with an empty message string

Continued:
- rewrote logger system away from monolithic methods in BaseFrameworkSystem
  class which later allows more "backend" loggers being supported
- DebugMiddleware::output() is now private

Continued:
- checked more parameter
- added more debug messages (stub messages will come)

Continued:
- updated year to 2023

Continued:
- changed to generic exceptions
- introduced EXCEPTION_BAD_METHOD_CALL exception code

Continued:
- moved EXCEPTION_UNSPPORTED_OPERATION to FrameworkInterface

Continued:
- introduced new exception code EXCEPTION_LOGIC_EXCEPTION

Continued:
- also turned 'quiet_resolver' into a is_*_enabled entry

Continued:
- removed .htaccess files and added .gitkeep, you have to make this now sure by
  yourself
- developer_mode_enabled renamed to is_developer_mode_enabled and invoked method
  isEnabled() instead
- fixed writing class/list cache files
- more debug lines added

Continued:
- added more debug lines
- added checks on parameter

Continued:
- arrays can be serialized and stored in files (ops)
- added debug line

Continued:
- no attributes of an XML element is very common (ops)
- fixed variable in debug line
- added more debug lines

Continued:
- added more debug lines
- added more checks on parameters

Continued:
- renamed getPrimaryKeyValue() to generatePrimaryKey()
- added more debug lines
- added more checks for parameter

Continued:
- removed deprecated files

Continued:
- removed .htaccess file, please protect applications/, db/, framework/ by
  yourself
- this makes this script more independent from the used web server

Continued:
- also check if root_base_path + relative path from parameter is a
  readable directory
- applications/tests/tests/ is redudant here

Continued:
- HelperGroupAlreadyCreatedException is redundant to BadMethodCallException
- added a lot more debug lines

Continued:
- renamed method requestIsValid() to propper setter name
- also renamed class field to proper name

Continued:
- scrypt (PECL) has only documentation files here
- removed akismet (see "All Your Data Belongs To Akismet")

Continued:
- introduced exception code for InvalidArgumentException

Continued:
- deprecated no longer needed files (they are deprecated to use anyway)
- added unit tests for FrameworkConfiguration->isEnabled() method

Continued:
- added more type-hints
- added more checks on parameter
- changed old array() to "new" [] style
- added some debug lines

Continued:
- added more checks on parameter

Continued:
- added commented-out debug line

Continued:
- added method FrameworkConfiguration::isEnabled() which requires configuration
  keys like 'is_foo_enabled' while you can just invoke
  $configInstance->isEnabled('foo')
- Added some debug lines
- added missing configuration entries
- Configuration entries like is_<form-name>_captcha_secured_enabled are still missing

Continued:
- no more needed (until later maybe)

Continued:
- ops, $criteriaType wasn't here
- also $configEntry wasn't here
- debug line added

Continued:
- empty($element) is the culpit here, '0' will be FALSE, 0 will be false and
  all needs to be true, so let's check $element === '' and it is solved

Continued:
- let's try string for a moment, empty(0) gives FALSE back, but we need
  this for the first indexed array key

Continued:
- enabled debug lines
- added one more

Continued:
- thanks to type-hints, I was able to find out that
  appendStringToGenericArrayElement() was invoked wrong here, it must be
  setGenericArrayElement() instead which makes sense from addCriteria()
  method's scope

Continued:
- maybe wrong name?

Continued:
- BASE-CRITERIA is okay here

Continued:
- added more debug lines
- added more thrown exceptions
- rewrote assert() lines to thrown exceptions

Continued:
- added more checks on parameter and thrown proper exceptions

Continued:
- converted more old array() to "new" [] way
- also added more debug lines
- throw more exceptions on bad parameters

Fixed:
- wrong function used, must be strlen()

Continued:
- added more checks on parameters
- added mroe debug lines
- converted some old array() to new []

Continued:
- imported missing interface

Continued:
- removed deprecated files
- updated TODOs.txt

Continued:
- added some parameter checks

Continued:
- added missing type-hints

Continued:
- old-lost method BaseFrameworkSystem::replaceControlCharacters() removed

Continued:
- AlreadyInitializedStackerException was an already deprecated method, as
  BadMethodCallException can do perfectly the same job

Updated .gitattributes

Continued:
- better filter large files through LFS

Signed-off-by: Roland Häder <roland@mxchange.org>

Please cherry-pick:
- updated copyright year

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- updated framework's (and testing application's) copyright year
- also for tests copyright year has been updated

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- updated copyright year

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- updated composer dependencies

Signed-off-by: Roland Häder <roland@mxchange.org>

Please cherry-pick:
- described an if() block why and when that condition may happen (rarely seen)

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- ignored patch/diff files
- added type-hints

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- let's not mess up logfiles with \n characters

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- no, same result as fgets() is being invoked
- get_class() did the trick here

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- (maybe) fixed warning "bad file descriptor", it was flooding logfiles

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- caching config entry here saves a lot invocations

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- some exception messages changed (more generalized)

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- Better check against SplFileObject instead of is_object(). First one is a
  keyword (instanceof), later is a function call
- More debug logging
- Added missing "import" lines
- Replaced more array() with []

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- renamed methods to make their purpose more clear

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- "cached" more configuration entries to class fields to avoid "expensive"
  invocations on FrameworkConfiguration->getConfigEntries()
- rewrote some "soft" assertions to hard exceptions as this cannot be let through

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- "cached" configuration entry 'developer_mode_enabled' and
  'debug_*_output_timings' into class fields to avoid "expensive" calls all over
  again to FrameworkConfiguration->getConfigEntry()

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- commented out noisy debug lines

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- removed more // END - <something> occurances as I don't do them anymore

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- made ClassLoader final as no inheriting classes shall be made (it is generic
  enough)
- renamed ClassLoader->$foundClasses to $pendingFiles as this describes the
  content of the array more closely
- removed some old-lost "// END - if" (WAY more to follow!)

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- StringUtils::convertToClassName() is now "in-method cached". That means that
  the parameter $str is used as key and the value is being generated when the
  key does not exist in self::$cache array

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- moved getCacheKeyByCriteria() to BaseDatabaseFrontend class, maybe not the
  final resting place, but better than in the generic, bloated
  BaseFrameworkSystem class
- Introduced BaseXmlTemplateEngine->$initMethodName to avoid an additional
  invocation of StringUtils::convertToClassName() on each invocation of
  startElement()

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- invoking ksort() by every invocation of setConfigEntry() is very "expensive"
  as sorting arrays take time. Better is to load all configuration files and
  then sort it only once.

Signed-off-by: Roland Häder <roland@mxchange.org>

Improved some debug lines

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- skip empty lines

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- CsvInputFile->readCsvFileLine() now accepts optional 2nd parameter
  $expectedMatches
- it also may throw 2 different exceptions on you

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- only __CLASS__ is out-dated
- used "new" array style []

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- "externalized" hard-wired hash function name "sha256" to configuration key
  "crypto_hash_function_name", maybe others will follow?
- renamed $config array to $configData in FrameworkConfiguration class
- since PHP doesn't support static initializer, e.g. like Java does, added
  private, static method staticInitializer() which is (in Java) executed only
  once when the class file has been loaded

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- added hash-benchmark.php; previous in "hub" project aka. mhash-benchmark.php,
  but since ext-mash is replaced by Hash, this needs porting, too.
- "new" array style [] used in audio.php
- ported CryptoUtils::hash() to PHP's new Hash "extension"
- Minor improvements

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- better debug logging

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- added parameter-validation and thrown IAE when not valid
- added more noisy debug lines

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- moved self::$hashLength, getHashLength() and hash() methods to new
  CryptoUtils class for lesser monolithic code in BaseFrameworkSystem class

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- added missing interface constants
- also BaseFileIndex' header array has now associative array elements

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- moved utilities classes to plural path names and namespaces
- added ArrayUtils class for handling arrrays
- used that new class' method to map numeric array elements to associative

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- rewrote a bit class loader, it used both
  FrameworkBootstrap::getConfigurationInstance() and a copied instance to get
  configuration entries, now only the former one is used
- moved constants to interface BinaryFile

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- fixed bad calls on no-longer existing iterator

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- removed SeekableWritableFileIterator as this had no real function but only
  handled over the method calls to the inner class
- for now on let's get the $binaryFileInstance directly from it

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- fixed bug which occured because the last block was counted twice. This
  happened when read() returns an empty (zero length) string which was not
  properly handled (maybe EOF reached).

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- updated copyright year

Signed-off-by: Roland Häder <roland@mxchange.org>

WIP:
- thrown exceptions when parameter values/types are not valid
- added type-hints for primitive variables
- partially fixed writing index files for other non-humanreadable files (see
  BaseBinaryFile class)

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- fixed BaseFileIndex' constructor, thanks to the private access, I found my
  mistake here, needs to be protected access and with $className parameter
  (string, of course)
- also include list group only when valid

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- NULL is no longer allowed as "empty" strings for $groupName are not allowed
- this whole thing was a bit complicated core and now still is buth with no NULL

Signed-off-by: Roland Häder <roland@mxchange.org>

Rewrite:
- constructors of concrete (=implementing non-abstract) classes should be
  private to avoid somone making an inheriting class of a concrete class
- this is good practice: only make inheriting (concrete) classes of abstract
  classes, not another concrete class only because you want that functionality
  in your class, too
- the private constructor also stops you from doing such wrong things, no need
  to make all concrete classes final

Signed-off-by: Roland Häder <roland@mxchange.org>