3 namespace CoreFramework\Channel\Compressor;
5 // Import framework stuff
6 use CoreFramework\Factory\ObjectFactory;
9 * Middleware class for selecting the right compressor channel
11 * @author Roland Haeder <webmaster@shipsimu.org>
13 * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2017 Core Developer Team
14 * @license GNU GPL 3.0 or any newer version
15 * @link http://www.shipsimu.org
17 * This program is free software: you can redistribute it and/or modify
18 * it under the terms of the GNU General Public License as published by
19 * the Free Software Foundation, either version 3 of the License, or
20 * (at your option) any later version.
22 * This program is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU General Public License for more details.
27 * You should have received a copy of the GNU General Public License
28 * along with this program. If not, see <http://www.gnu.org/licenses/>.
30 class CompressorChannel extends BaseMiddleware implements Registerable {
32 * Real compressor instance
34 private $compressor = NULL;
37 * Protected constructor
41 protected function __construct () {
42 // Call parent constructor!
43 parent::__construct(__CLASS__);
47 * Create a new compressor channel.
49 * @return $compressorInstance A prepared instance of this class
51 public static final function createCompressorChannel () {
53 $compressorInstance = new CompressorChannel();
55 // Is the compressor handler set?
57 (is_null($compressorInstance->getCompressor()))
58 || (!$compressorInstance->getCompressor() instanceof Compressor)
60 // Init base directory
62 $compressorInstance->getConfigInstance()->getConfigEntry('base_path') .
63 $compressorInstance->getConfigInstance()->getConfigEntry('compressor_base_path');
65 // Get a directory pointer
66 $directoryInstance = ObjectFactory::createObjectByConfiguredName('directory_class', array($baseDir));
68 // Read all directories but no sub directories, .htaccess files and NullCompressor class
69 while ($directoryEntry = $directoryInstance->readDirectoryExcept(array('.htaccess', 'class_NullCompressor.php'))) {
71 //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('COMPRESSOR[' . __METHOD__ . ':' . __LINE__ . ']: directoryEntry=' . $directoryEntry);
73 // Is this a class file?
74 if ((substr($directoryEntry, 0, 6) == 'class_') && (substr($directoryEntry, -4, 4) == '.php')) {
75 /* Get the compressor's name. That's why you must name
76 * your files like your classes and also that's why you
77 * must keep on class in one file.
79 $className = substr($directoryEntry, 6, -4);
81 // Get an instance from our object factory
82 $tempInstance = ObjectFactory::createObjectByName($className);
85 if (is_null($tempInstance)) {
86 // Then skip to the next one
91 $compressorInstance->setCompressor($tempInstance);
93 // No more searches required because we have found a valid compressor stream
98 // Close the directory
99 $directoryInstance->closeDirectory();
102 // Check again if there is a compressor
104 (is_null($compressorInstance->getCompressor()))
105 || (!is_object($compressorInstance->getCompressor()))
106 || (!$compressorInstance instanceof Compressor)
108 // Set the null compressor handler. This should not be configureable!
109 // @TODO Is there a configurable fall-back compressor needed, or is NullCompressor okay?
110 $compressorInstance->setCompressor(ObjectFactory::createObjectByName('NullCompressor'));
113 // Return the compressor instance
114 return $compressorInstance;
118 * Getter for compressor instance
120 * @return $compressor The compressor instance
122 public final function getCompressor () {
123 return $this->compressor;
127 * Setter for compressor
129 * @param $compressorInstance The compressor instance we shall use
132 public final function setCompressor (Compressor $compressorInstance = NULL) {
133 $this->compressor = $compressorInstance;
137 * Getter for the file extension of the current compressor
139 public final function getCompressorExtension () {
140 // Get compressor extension from current compressor
141 return $this->getCompressor()->getCompressorExtension();