inc/inc-functions.php

   1 <?php
   2 /************************************************************************
   3  * MXChange v0.2.1                                    Start: 03/10/2009 *
   4  * ===============                              Last change: 03/10/2009 *
   5  *                                                                      *
   6  * -------------------------------------------------------------------- *
   7  * File              : inc-functions.php                                *
   8  * -------------------------------------------------------------------- *
   9  * Short description : Special functions for handling include files     *
  10  * -------------------------------------------------------------------- *
  11  * Kurzbeschreibung  : Spezielle Funktionen fuer Include-Dateien        *
  12  * -------------------------------------------------------------------- *
  13  * $Revision:: 905                                                    $ *
  14  * $Date:: 2009-03-10 17:24:54 +0100 (Tue, 10 Mar 2009)               $ *
  15  * $Tag:: 0.2.1-FINAL                                                 $ *
  16  * $Author:: quix0r                                                   $ *
  17  * Needs to be in all Files and every File needs "svn propset           *
  18  * svn:keywords Date Revision" (autoprobset!) at least!!!!!!            *
  19  * -------------------------------------------------------------------- *
  20  * Copyright (c) 2003 - 2008 by Roland Haeder                           *
  21  * For more information visit: http://www.mxchange.org                  *
  22  *                                                                      *
  23  * This program is free software; you can redistribute it and/or modify *
  24  * it under the terms of the GNU General Public License as published by *
  25  * the Free Software Foundation; either version 2 of the License, or    *
  26  * (at your option) any later version.                                  *
  27  *                                                                      *
  28  * This program is distributed in the hope that it will be useful,      *
  29  * but WITHOUT ANY WARRANTY; without even the implied warranty of       *
  30  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the        *
  31  * GNU General Public License for more details.                         *
  32  *                                                                      *
  33  * You should have received a copy of the GNU General Public License    *
  34  * along with this program; if not, write to the Free Software          *
  35  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,               *
  36  * MA  02110-1301  USA                                                  *
  37  ************************************************************************/
  38 // Some security stuff...
  39 if (!defined('__SECURITY')) {
  40         $INC = substr(dirname(__FILE__), 0, strpos(dirname(__FILE__), "/inc") + 4)."/security.php";
  41         require($INC);
  42 }
  43
  44 // Check if our config file is writeable or not
  45 function IS_INC_WRITEABLE ($inc) {
  46         // Generate FQFN
  47         $FQFN = sprintf("%sinc/%s.php", constant('PATH'), $inc);
  48
  49         // Abort by simple test
  50         if ((FILE_READABLE($FQFN)) && (!is_writeable($FQFN))) {
  51                 return false;
  52         } // END - if
  53
  54         // Test write-access on directory
  55         return is_writeable(dirname($FQFN));
  56 }
  57
  58 // Reads a directory with PHP files in and gets only files back
  59 function GET_DIR_AS_ARRAY ($baseDir, $prefix, $includeDirs = false, $addBaseDir = true) {
  60         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "baseDir={$baseDir},prefix={$prefix} - Entered!");
  61         // Init includes
  62         $INCs = array();
  63
  64         // Open directory
  65         $dirPointer = opendir(constant('PATH') . $baseDir) or mxchange_die("Cannot read ".basename($baseDir)." path!");
  66
  67         // Read all entries
  68         while ($baseFile = readdir($dirPointer)) {
  69                 // Construct include filename and FQFN
  70                 $INC = $baseDir . "/" . $baseFile;
  71                 $FQFN = constant('PATH') . $INC;
  72
  73                 // Is this a valid reset file?
  74                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, "baseDir={$baseDir},prefix={$prefix},baseFile={$baseFile}");
  75                 if (((FILE_READABLE($FQFN)) && (substr($baseFile, 0, strlen($prefix)) == $prefix) && (substr($baseFile, -4, 4) == ".php")) || (($includeDirs) && (isDirectory($FQFN)))) {
  76                         // Remove both for extension name
  77                         $extName = substr($baseFile, strlen($prefix), -4);
  78
  79                         // Try to find it
  80                         $extId = GET_EXT_ID($extName);
  81
  82                         // Is the extension valid and active?
  83                         if (($extId > 0) && (EXT_IS_ACTIVE($extName))) {
  84                                 // Then add this file
  85                                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, " Extension entry ".$baseFile." added.");
  86                                 $INCs[] = $INC;
  87                         } elseif ($extId == 0) {
  88                                 // Add non-extension files as well
  89                                 //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, " Regular entry ".$baseFile." added.");
  90                                 if ($addBaseDir) {
  91                                         $INCs[] = $INC;
  92                                 } else {
  93                                         $INCs[] = $baseFile;
  94                                 }
  95                         }
  96                 } // END - if
  97         } // END - while
  98
  99         // Close directory
 100         closedir($dirPointer);
 101
 102         // Sort array
 103         asort($INCs);
 104
 105         // Return array with include files
 106         //* DEBUG: */ DEBUG_LOG(__FUNCTION__, __LINE__, " - Left!");
 107         return $INCs;
 108 }
 109
 110 // Init INC_POOL
 111 function INIT_INC_POOL () {
 112         $GLOBALS['inc_pool'] = array();
 113 }
 114
 115 // Setter for INC_POOL
 116 function SET_INC_POOL ($includePool) {
 117         $GLOBALS['inc_pool'] = (array) $includePool;
 118 }
 119
 120 // Getter for INC_POOL
 121 function GET_INC_POOL () {
 122         return $GLOBALS['inc_pool'];
 123 }
 124
 125 // Count INC_POOL
 126 function COUNT_INC_POOL () {
 127         return count($GLOBALS['inc_pool']);
 128 }
 129
 130 // Merge INC_POOL into given
 131 function MERGE_INC_POOL ($includePool) {
 132         SET_INC_POOL(merge_array(GET_INC_POOL(), $includePool));
 133 }
 134
 135 // Add single include file to INC_POOL
 136 function ADD_INC_TO_POOL ($INC) {
 137         $GLOBALS['inc_pool'][] = (string) $INC;
 138 }
 139
 140 // Remove an include file from INC_POOL
 141 function REMOVE_INC_FROM_POOL ($INC) {
 142         // First look it up
 143         $key = array_search($INC, GET_INC_POOL());
 144
 145         // Is it valid?
 146         if ($key !== false) {
 147                 // Then remove it
 148                 unset($GLOBALS['inc_pool'][$key]);
 149
 150                 // And sort the list
 151                 asort($GLOBALS['inc_pool']);
 152         } // END - if
 153 }
 154
 155 // [EOF]
 156 ?>