core.php

Go to the documentation of this file.

<?php

      /*
      *     This source code is a part of the Ultimix Project. 
      *     It is distributed under BSD license. All other third side source code (like tinyMCE) is distributed under 
      *     it's own license wich could be found from the corresponding files or sources. 
      *     This source code is provided "as is" without any warranties or garanties.
      *
      *     Have a nice day!
      *
      *     @url http://ultimix.sorceforge.net
      *
      *     @author Alexey "gdever" Dodonov
      */

      require_once( dirname( __FILE__ ).'/include/php/settings.php' );
      
      require_once( dirname( __FILE__ ).'/include/php/core_utilities.php' );
      
      require_once( dirname( __FILE__ ).'/include/php/package_manipulation.php' );
      
      $PackageCache = array();
      
      $RequestedClassName = '';
      
      require_once( dirname( __FILE__ ).'/include/php/package_paths.php' );
      
      require_once( dirname( __FILE__ ).'/include/php/package_version.php' );
      
      function                _get_full_class_name( $Name , $Version , $ROOT_DIR )
      {
            try
            {     
                  global      $FullClassNameCache;
                  if( isset( $FullClassNameCache[ "$Name.$Version.$ROOT_DIR" ] ) )
                  {
                        return( $FullClassNameCache[ "$Name.$Version.$ROOT_DIR" ] );
                  }

                  $TopVersion = explode( '::' , $Version );
                  $TopVersion = array_pop( $TopVersion );

                  $RealPackageVersion = _get_package_real_version( $Name , $TopVersion , $ROOT_DIR );

                  $PackageClassName = str_replace( '.' , '_' , $Name.'_'.$RealPackageVersion );

                  global      $FullClassNameCacheChanged;
                  $FullClassNameCacheChanged = true;

                  return( $FullClassNameCache[ "$Name.$Version.$ROOT_DIR" ] = $PackageClassName );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      $TopPackageNameCacheChanged = false;
      $TopPackageNameCache = array();

      function                _get_top_package_name( $PackageName )
      {
            try
            {
                  global      $TopPackageNameCache;
                  if( isset( $TopPackageNameCache[ $PackageName ] ) )
                  {
                        return( $TopPackageNameCache[ $PackageName ] );
                  }

                  $TopPackageName = explode( '::' , $PackageName );

                  global      $TopPackageNameCacheChanged;
                  $TopPackageNameCacheChanged = true;

                  return( $TopPackageNameCache[ $PackageName ] = array_pop( $TopPackageName ) );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _get_requested_class_name()
      {
            global      $RequestedClassName;

            return( $RequestedClassName );
      }

      $ObjectLabel = 'default';
      
      function                _set_object_label( $theObjectLabel )
      {
            try
            {
                  global            $ObjectLabel;
                  $ObjectLabel = $theObjectLabel;
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      require_once( dirname( __FILE__ ).'/include/php/rewrites.php' );

      function                _get_package_path_ex( $PackageName , $PackageRealVersion )
      {
            try
            {
                  list( $PackageName , $PackageRealVersion ) = _get_package_info_after_rewrites( 
                        $PackageName , $PackageRealVersion , __FILE__
                  );

                  $ROOT_DIR = _get_root_dir( $PackageName , $PackageRealVersion , INSTALL_DIR );

                  return( _get_package_path( $PackageName , $PackageRealVersion , $ROOT_DIR ) );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      $PackagePathsCacheChanged = false;
      $PackagePathsCache = array();

      function                _get_load_script_data( $PackageName , $PackageVersion , $PackageScriptPath )
      {
            try
            {
                  $RootDirectory = _get_root_dir( $PackageName , $PackageVersion , INSTALL_DIR );
                  $PackageDirectory = _get_package_path( $PackageName , $PackageVersion , $RootDirectory );
                  $TopPackageName = _get_top_package_name( $PackageName );
                  
                  $PackageClassName = 'unexisting_class';
                  $Exists = false;
                  
                  if( file_exists( $PackageDirectory.'/'.$TopPackageName.'.php' ) )
                  {
                        $PackageClassName = _get_full_class_name( $TopPackageName , $PackageVersion , $RootDirectory );
                        $Exists = true;
                  }
                  
                  return( 
                        array( $PackageDirectory.'/'.$TopPackageName.'.php' , $Exists , $PackageClassName , $TopPackageName )
                  );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _fill_package_paths_data( $PackageName , $PackageVersion , $PackageScriptPath )
      {
            try
            {
                  global            $ObjectLabel;
                  $Key = "$PackageName $PackageVersion $ObjectLabel";

                  global            $PackagePathsCache;

                  list( $RPackageName , $RPackageVersion ) = _get_package_info_after_rewrites( 
                        $PackageName , $PackageVersion , $PackageScriptPath
                  );

                  list( $ScriptPath , $Exists , $PackageClassName , $TopPackageName ) = _get_load_script_data( 
                        $RPackageName , $RPackageVersion , $PackageScriptPath 
                  );

                  $PackagePathsCache[ $Key ] = array( 
                        'path' => $ScriptPath , 'exists' => $Exists , 
                        'class_name' => $PackageClassName , 'top_package_name' => $TopPackageName
                  );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _fill_package_paths_cache( $PackageName , $PackageVersion , $PackageScriptPath )
      {
            try
            {
                  global            $ObjectLabel;
                  $Key = "$PackageName $PackageVersion $ObjectLabel";

                  global            $PackagePathsCache;
                  if( isset( $PackagePathsCache[ $Key ] ) )return;

                  _fill_package_paths_data( $PackageName , $PackageVersion , $PackageScriptPath );

                  global            $PackagePathsCacheChanged;
                  $PackagePathsCacheChanged = true;
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _try_fetch_from_cache( $PackageName , $PackageVersion )
      {
            try
            {
                  global            $ObjectLabel;
                  $Key = "$PackageName $PackageVersion $ObjectLabel";
                  
                  global            $PackagePathsCache;
                  if( isset( $PackagePathsCache[ $Key ] ) )
                  {
                        global            $PackageCache;
                        if( isset( $PackageCache[ $PackagePathsCache[ $Key ][ 'path' ] ] ) )
                        {
                              global            $RequestedClassName;
                              $RequestedClassName = $PackagePathsCache[ $Key ][ 'class_name' ];
                              
                              return( array( true , $PackageCache[ $PackagePathsCache[ $Key ][ 'path' ] ] ) );
                        }
                  }
                  
                  return( array( false , false ) );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _package_script_fast_load( $PackageName , $PackageVersion )
      {
            try
            {
                  /* на этом этапе мы уже знаем где лежит пакет $PackageName.$PackageVersion */
                  global            $ObjectLabel;
                  $Key = "$PackageName $PackageVersion $ObjectLabel";
            
                  global            $PackagePathsCache;
                  $PackageInfo = $PackagePathsCache[ $Key ];
                  
                  if( $PackageInfo[ 'exists' ] )
                  {
                        require_once( $PackageInfo[ 'path' ] );

                        $RootDirectory = _get_root_dir( $PackageName , $PackageVersion , INSTALL_DIR );
                        
                        return( _get_full_class_name( $PackageInfo[ 'top_package_name' ] , $PackageVersion , $RootDirectory ) );
                  }
                  else
                  {
                        return( 'unexisting_class' );
                  }
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _get_package_directory( $PackageName , $PackageVersion )
      {
            try
            {
                  $RootDirectory = _get_root_dir( $PackageName , $PackageVersion , INSTALL_DIR );
                  $PackageDirectory = _get_package_path( $PackageName , $PackageVersion , $RootDirectory );
                  $TopPackageName = _get_top_package_name( $PackageName );

                  return( $PackageDirectory );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _fill_package_cache( $PackageClassName , $Key )
      {
            try
            {
                  global            $PackageCache;
                  if( isset( $PackageCache[ $Key ] ) === false )
                  {
                        global            $RequestedClassName;
                        $RequestedClassName = false;
                        $PackageCache[ $Key ] = false;
                        if( class_exists( $PackageClassName ) )
                        {
                              $PackageCache[ $Key ] = new $PackageClassName();
                              $RequestedClassName = $PackageClassName;
                        }
                  }
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _store_package_object( $PackageClassName , $Key )
      {
            try
            {
                  _fill_package_cache( $PackageClassName , $Key );

                  global            $PackageCache;
                  global            $PackagePathsCache;
                  if( isset( $PackagePathsCache[ $Key ] ) )
                  {
                        $PackageInfo = $PackagePathsCache[ $Key ];
                        if( isset( $PackageCache[ $PackageInfo[ 'path' ] ] ) === false )
                        {
                              $PackageCache[ $PackageInfo[ 'path' ] ] = $PackageCache[ $Key ];
                        }
                  }
                  else
                  {
                        throw( new Exception( "The path for key $Key does not exist" ) );
                  }
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _store_package_path( $PackageName , $PackageVersion )
      {
            try
            {
                  $PackageDirectory = _get_package_directory( $PackageName , $PackageVersion );
                  
                  global            $LoadedPackagesPaths;
                  $LoadedPackagesPaths [ "$PackageName.$PackageVersion" ] = array( 
                        'directory' => $PackageDirectory , 'package_name' => $PackageName , 'package_version' => $PackageVersion
                  );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();throw( _get_exception_object( __FUNCTION__ , $Args , $e ) );
            }
      }

      function                _get_package_relative_path_ex( $PackageName , $PackageVersion )
      {
            try
            {
                  return( 
                        _get_package_relative_path( _get_package_path_ex( $PackageName , $PackageVersion ).'/unexisting_file' )
                  );
            }
            catch( Exception $e )
            {
                  $Args = func_get_args();
                  _throw_exception_object( __FUNCTION__ , $Args , $e );
            }
      }

      require_once( dirname( __FILE__ ).'/include/php/core_cache.php' );      
      require_once( dirname( __FILE__ ).'/include/php/functional_programming.php' );
      require_once( dirname( __FILE__ ).'/include/php/array_functions.php' );
      require_once( dirname( __FILE__ ).'/include/php/core_public_api.php' );

?>