Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2025-05-25 12:37
📄 CREDITS CREDITS ======= eZ Components team ------------------ - Sergey Alexeev - Sebastian Bergmann - Jan Borsodi - Raymond Bosman - Frederik Holljen - Kore Nordmann - Derick Rethans - Vadym Savchuk - Tobias Schlitt - Alexandru Stanoi	229 B	2024-07-17 10:18
📄 LICENSE eZ Components Licence ===================== New BSD Licence --------------- Copyright (c) 2005-2008, eZ Systems A.S. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of eZ Systems A.S. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.	1.53 KB	2024-07-17 10:18
📁 repos	-	2025-05-25 12:37
📄 tutorial.txt eZ Components - Base ~~~~~~~~~~~~~~~~~~~~ .. contents:: Table of Contents Introduction ============ The Base component provides the basic functionality, such as autoloading, that all eZ Components need to function properly. The Base component needs to be loaded specifically. Base can also autoload external class repositories from outside the eZ Components. Aside from the autoload functionality, the Base component also contains a number of generic Exception classes that all inherit from the ezcBaseException class. Installation ============ The installation and configuration of the eZ Components environment is described in a separate article. Please refer to the `Components Introduction`_ for instructions on installation and configuration of the eZ Components library and the Base component. .. _Components Introduction: /docs/install Usage ===== Debugging --------- By default the ezcBase component's autoload mechanism will not throw an exception when an autoload class can not be found. In some cases (during development) it is useful to have an exception with detailed information about which autoload files were searched for, and in which directories. ezcBase supports an option that enables this behavior:: <?php $options = new ezcBaseAutoloadOptions; $options->debug = true; ezcBase::setOptions( $options ); ?> Warning: Exceptions are ignored when they are thrown from an autoload() handler in PHP. In order to see the exception message that is thrown when a class can not be found, you need to catch the exception in the autoload() handler. Your autoload() function could then look like:: function __autoload( $className ) { try { ezcBase::autoload( $className ); } catch ( Exception $e ) { echo $e->getMessage(); } } Preloading ---------- The default autoload policy of the eZ Components is to load every class file on demand only. It is also possible to load all classes of one component at the same time, when one of the component's classes is requested for the first time. You can change this behavior with the "preload" option that is available through the ezcBaseAutoloadOptions option class. You can turn preloading on with:: <?php $options = new ezcBaseAutoloadOptions; $options->preload = true; ezcBase::setOptions( $options ); ?> Please note that preloading will not be done for Exception classes. Adding class repositories located outside eZ Components to autoload system -------------------------------------------------------------------------- It can be useful to add repositories of user-defined classes to the eZ Components autoload system. The ezcBase::addClassRepository() method can be used to perform this task. You need to arrange the desired external classes in a class repository. That is, make sure that classes and corresponding \_autoload.php files are named and placed according to the explanations below. After they are in the proper structure, you can call addClassRepository() with the proper parameters before you use the external classes. External classes will then be loaded by autoload system. ezcBase::addClassRepository() takes two arguments: - $basePath is the base path for the whole class repository. - $autoloadDirPath is the path where autoload files for this repository are found. The paths in the autoload files are not* relative to the package directory as specified by the $basePath argument. In other words, class definition files will only be searched for in the location $autoloadDirPath. Consider the following example: - There is a class repository stored in the directory "./repos". - Autoload files for this repository are stored in "./repos/autoloads". - There are two components in this repository: "Me" and "You". - The "Me" component has the classes "erMyClass1" and "erMyClass2". - The "You" component has the classes "erYourClass1" and "erYourClass2". In this case, you need to create the following files in "./repos/autoloads". Note that the prefix to _autoload.php ("my" and "your") in the filename is the first part of the classname (excluding the lowercase classname prefix - "er"). Content of my_autoload.php: .. include:: repos/autoloads/my_autoload.php :literal: Content of your_autoload.php: .. include:: repos/autoloads/your_autoload.php :literal: The directory structure for the external repository is then: :: ./repos/autoloads/my_autoload.php ./repos/autoloads/your_autoload.php ./repos/Me/myclass1.php ./repos/Me/myclass2.php ./repos/You/yourclass1.php ./repos/You/yourclass2.php To use this repository with the autoload mechanism, use the following code: .. include:: tutorial_example_01.php :literal: The above code will output: :: Class 'erMyClass2' Class 'erYourClass1' Lazy initialization ------------------- Lazy initialization is a mechanism to load and configure a component, only when it is really used in your application. This mechanism saves time for parsing the classes and configuration, when the component is not used at all during one request. The implementation in ezcBaseInit may be reused by other applications and components, like the following example will show. .. include:: tutorial_lazy_initialization.php :literal: The example shows a random class implementing the singleton pattern, which may be some database connection handler, or anything similar in your case. The getInstance() method shows a typical PHP 5 implementation except the additional line 14, which checks, if a configuration callback was provided earlier and configures the newly created instance. If no configuration callback was provided, nothing will happen. The customKey is used to receive the right callback from ezcBaseInit and needs to be known by the user, who wants to define a configuration callback for your class. In line 32 the class used to configure your instance on creation is defined. The first parameter is the key used earlier in the getInstance method, to reference the right class, and the second parameter is the name of your configuration class. The configuration class beginning in line 22 just needs to implement the ezcBaseConfigurationInitializer interface, which defines one method: configureObject(). This method will be called with the object to configure as a single parameter. In the example, a new public property on the customSingleton instance is created, which will be echo'd later to show the success of the configuration. The configuration itself will not happen before the actual instance is created in line 35 performing the static call on customSingleton::getInstance(). The var_dump() in the following line shows, that the property value is set and contains the earlier set value (int) 42. File Operations --------------- Finding files recursively ````````````````````````` This example shows how to use the ezcBaseFile::findRecursive() method: .. include:: tutorial_example_02.php :literal: The code in this example searches for files in the ``/dat/dev/ezcomponents`` directory. It will only include files that match all patterns in the $includeFilters array (the second parameter). Files that match any of the patterns in the $excludeFilters array (the third parameter) will not be returned. In other words, the code above searches for files in the ``dat/dev/ezcomponents`` directory, which are in the ``src/`` directory and end with ``_autoload.php``, except for files that are in the ``/autoload/`` directory. Removing directories recursively ```````````````````````````````` This example shows how to use the ezcBaseFile::removeRecursive() method: .. include:: tutorial_example_03.php :literal: This code simply removes the directory ``/dat/dev/ezcomponents/trash`` and all of its files and sub-directories. Warning: Use this function with care, as it has the potential to erase everything that the current user has access to. Overloading the callback ```````````````````````` The ezcBaseFile::findRecursive() method internally uses the ezcBaseFile::walkRecursive() method to do the actual recursing. The callback method ezcBaseFile::findRecursiveCallback() is then responsible for collecting the data. In case you want to do additional things, such as printing progress, you can either call walkRecursive() yourself with a callback function of your choice, or overload the ezcBaseFile class and provide a new findRecursiveCallback() method. The code below uses ezcBaseFile::walkRecursive() directly in order to display dots for when ever it finds a new directory: .. include:: tutorial_example_04.php :literal: .. Local Variables: mode: rst fill-column: 79 End: vim: et syn=rst tw=79	8.59 KB	2024-07-17 10:18
📄 tutorial_autoload.php <?php $dir = dirname( __FILE__ ); $dirParts = explode( DIRECTORY_SEPARATOR, $dir ); switch ( $dirParts[count( $dirParts ) - 3] ) { case 'doc': require_once 'ezc/Base/base.php'; break; // pear case 'trunk': require_once "$dir/../../Base/src/base.php"; break; // svn default: require_once "$dir/../../Base/src/base.php"; break; // bundle } /** * Autoload ezc classes * * @param string $className */ function __autoload( $className ) { ezcBase::autoload( $className ); } ?>	495 B	2024-07-17 10:18
📄 tutorial_example_01.php <?php require_once 'tutorial_autoload.php'; ezcBase::addClassRepository( './repos', './repos/autoloads' ); $myVar1 = new erMyClass2(); $myVar1->toString(); $yourVar1 = new erYourClass1(); $yourVar1->toString(); ?>	215 B	2024-07-17 10:18
📄 tutorial_example_02.php <?php require 'tutorial_autoload.php'; $data = ezcBaseFile::findRecursive( "/dat/dev/ezcomponents", array( '@src/.*_autoload.php$@' ), array( '@/autoload/@' ) ); var_dump( $data ); ?>	189 B	2024-07-17 10:18
📄 tutorial_example_03.php <?php require 'tutorial_autoload.php'; ezcBaseFile::removeRecursive( '/dat/dev/ezcomponents/trash' ); ?>	107 B	2024-07-17 10:18
📄 tutorial_example_04.php <?php require 'tutorial_autoload.php'; class myProgressFinder { static public function findRecursiveCallback( ezcBaseFileFindContext $context, $sourceDir, $fileName, $fileInfo ) { // ignore if we have a directory, but do print a "." and sleep for // extra demo time if ( $fileInfo['mode'] & 0x4000 ) { echo "."; usleep( 100000 ); return; } // update the statistics $context->elements[] = $sourceDir . DIRECTORY_SEPARATOR . $fileName; $context->count++; $context->size += $fileInfo['size']; } static public function findRecursive( $sourceDir, array $includeFilters = array(), array $excludeFilters = array() ) { // create the context, and then start walking over the array $context = new ezcBaseFileFindContext; ezcBaseFile::walkRecursive( $sourceDir, $includeFilters, $excludeFilters, array( 'myProgressFinder', 'findRecursiveCallback' ), $context ); // collect the statistics (which we don't do anything with in this example) $statistics['size'] = $context->size; $statistics['count'] = $context->count; // return the found and pattern-matched files sort( $context->elements ); return $context->elements; } } $files = myProgressFinder::findRecursive( dirname( __FILE__ ) ); var_dump( $files ); ?>	1.39 KB	2024-07-17 10:18
📄 tutorial_lazy_initialization.php <?php require_once 'tutorial_autoload.php'; // Create a custom class implementing the singleton pattern class customSingleton { protected static $instance; public static function getInstance() { if ( self::$instance === null ) { self::$instance = new customSingleton(); ezcBaseInit::fetchConfig( 'customKey', self::$instance ); } return self::$instance; } } // Implement your configuration class class customSingletonConfiguration implements ezcBaseConfigurationInitializer { public static function configureObject( $object ) { echo "Configure customSingleton.\n"; $object->value = 42; } } // Register for lazy initilization ezcBaseInit::setCallback( 'customKey', 'customSingletonConfiguration' ); // Configure on first initilization $object = customSingleton::getInstance(); var_dump( $object->value ); ?>	914 B	2024-07-17 10:18

Terminal