Adventure,PHP,framework,page controller,front controller,pattern,object orientated design,software,development,reusability,uml,tutorial,benchmark,brilliant performance,
Search:    
Downloads  |  Documentation  |  Tutorials  |  Literature  |  Forum!  |  Sitemap  |  SVN!  |  Roadmap  
 
Deutsch | English Adventure PHP Framework  Bookmark @ Technorati Bookmark @ del.icio.us Bookmark @ Mr. Wong Bookmark @ Simpy Bookmark @ Google Bookmark @ Digg.com Adventure PHP Framework Print page Downloads

Downloads

On this site the source codes and documentations of the frameworks can be downloaded. The libraries are released for applications under PHP 4 and PHP 5. The source code and the documentation contents are distributed under the LGPLv3 license. Details on licensing can be taken from the license page Details on the contents of each release can be taken from the respective release notes.

The CHM version of the offline documentation can be displayed under LINUX with the programms GnoCHM avaliable under http://sourceforge.net/project...p_id=96084 or xCHM downloadable under http://xchm.sourceforge.net/download.html. These applications are based on the chmlib (http://www.jedrea.com/chmlib/).


 Revision 1.9

Release 1.9 (stable) contains libraries for the use under PHP 4 and PHP 5. Please note, that with the release 1.7-RC2 two different architecture releases are delivered to prepare the separation of the two branches. The version was tested with versions greater than PHP 5.2.6 and <= PHP 4.4.8. This version is meant to be installed on production systems.

The article Migration from 1.8 to 1.9 summarizes the changes, that have to be applied to existing applications, because the new version does not only contain new geatures, but also changes to the API.

Major changes to the version 1.9 (stable) are:
  • Refactoring: The APF filter implementation was completely reworked in the 1.9 branch. This includes, that the definition of filters as well as the configuration of input and output filter via the Registry. The documentation of the new filter implementation can be read about in the Filter chapter. Along this refactoring form filters were introduced, too. Details on the form filter feature is contained in the section usage of form filters.
  • Improvement: To ease debugging with the integrated error handling meachnism, the stacktrace is only displayed up to the error cause. This gains clariry and fades out unnecessary entries resulting from the error handler.
  • Refactoring: The filesystemHandler component was now removed from the release as announced within the notes of the 1.8 release. For file system interaction, the FilesystemManager can now be used as a replacement (for details see below).
  • Enhancement: The error handling of the framework was made mor flexible. This means, that the component used for global error handling can be re-configured by registry if desired. The documentation and the extension of the error handling can be read about in the error handling chapter.
  • Improvement: The value of the registry offset URLBasePath (namespace: apf::core) now additionally contains the protocol type (http/https).
  • Enhancement: The framework was added a ExceptionHandler component, to offer global exception handling similar to the error handling mechanism. This enables the interception of uncaught exceptions thrown within applications or global modules. The operation, extension and usage can be taken from the exception handling section. Please note, that this feature is only available in the PHP 5 release.
  • Bugfix: The log buffer is now cleared with every call of flushLogBuffer(). This avoids multiple log entries of the same type.
  • Bugfix: The MySQLxHandler/MySQLxHandler creates a new connection, even, if the connection data are the same. This avoids interference of database connections, that make use of the same connection data, but use a different database.
  • Improvement: Now, the data type INT is used instead of TINYINT while creating the CREATE TABLE statements for the GenericORMapper. This makes a greater data room addressable. Details on the discussion can be taken from the german language forum under Forum.
  • Improvement: The GenericORMapper was added the loadRelationMultiplicity() method. This function returns the multiplicity of a dedicated relation to be able to react on special situations (e.g. no relation available, ...). The documentation of the GenericORMapper thus contains the new chapter loading the relation multiplicity.
  • Bugfix: The private method __getAssociationsByObjectName() was fixed to return only those associations, that refer to the current object. The bug caused faulty statements due to not allowed JOIN conditions.
  • Enhancement: The release 1.9 contains a completely revised and fully documented version of the usermanagement module. Because the module is based on the GenericORMapper the data model can also be directly used with it. So the user management module can be used as a generic and multitenancy user management backend for several applications. The documentation thus contains the new chapter Module - usermanagement.
  • Refactoring: During the enhancement of the GenericORMapper, the Pager was subjected to a refactoring. The new revision now contains full compatibility with the or mapper and performance optimization by means of database result caching. Further, the pager now uses the ConnectionManager and features two new config params. The documentation of this component was updated concerning the new features and the API changes. An updated configuration example can be obtained in the adventure-configpack-* release files.
  • Refactoring: The business component of the comment module was adapted to the new API of the Pager component. Please note, that updating this module must include an update of the pager module.
  • Enhancement: The form taglibs now support form filters. The filter libs are based on the core filter and enable you to filter the content of text fields. The usage of the form filters is documentated in the chapter usage of form filters. The section also contains a number of real life application examples.
  • Enhancement: As well, the deprecated variablenHandler class was removed from the release. Until now, the RequestHandler can be used to retrieve values from the request or assign default values if they are not existent. The documentation of this new component can be read about in the class reference table of the RequestHandler.
  • Enhancement: In order to combine front controller based applications, the taglib <generic:importdesign /> now includes the dependent action feature. This means, that an action, that is needed by the included module (e.g. for navigation purposes) is registered with the front controller. This enhancement was previously discussed in the german language forum The documentation of the taglib was updated and the new possibility can be seen in the Generic importdesign tag section.
  • Enhancement: The APF release now includes a cookie handling component - the CookieManager. It includes methods to set, manipulate and delete HTTP cookies within APF namespaces. The documentation chapter CookieManager describes the usage.
  • Refactoring: The deprecated classes abstractCacheManager, cacheV4Manager, objectCacheManager and statCacheManager were replaced by the CacheManager component.
  • Refactoring: The deprecated component bbCodeparser was removed from the release. Please use the AdvancedBBCodeParser introduced in the 1.8 release.
  • Refactoring The ImageManager was subjected to a refactoring. Here is a list of changes to the class:
    • The class was renamed from imageManager to ImageManager
    • The method resizeImage() was renamed to resizeImageOld() and marked as deprecated. This change was made due to compatibility reasons and the method will be removed in the 1.10 branch.
    • The new method resizeImage() replaces the previous implementation.
    • The function getImageAttributes() replaces the schowImageAttributes() method. The latter one will be removed from the code in the 1.10 branch. It is now still contained due to compatibility reasons.
    • The resizeImage() replaces all resize methods contained in the ImageManager. In the 1.10 branch, the resizeImageOld() and generateThumbnail() will be removed.
  • RC1 feedback: The methods __getForm(), __templatePlaceholderExists(), __placeholderExists(), __getTemplate(), and setPlaceHolder() do no longer create errors on neighbour object access in the PHP5 release version. Details can be taken from the german language forum post Fragen zu Formular-Doku.
  • RC1 feedback: The StreamMediaAction out of the tools::media::actions namespace and the ShowImageAction out of the modules::socialbookmark::biz::actions namespace now send an enhanced set of HTTP headers, that enable the browser so cache the images.
Files with names like adventure-codepack-* only contain the framework libraries, files with names like adventure-demopack-* the framework libraries plus a demo application and the documentation site. For beginners it is recommended to download the demo packages. Release files with a name like adventure-configpack-* contain a set of example configuration files. As of release 1.8-RC1 the adventure-perfcodepack-* release is included. This package contains php files, that are free of comments and whitspaces and help you to gain performance on hosting environments having no byte-code-caching configured.

Documentation

The following documentation files are available for this release:



Subversion repository

The files included in this release are also available in SVN. To check out the current release, please refer to the following URLs:

SVN web view: http://adventurephpfra.svn.sourceforge.net/viewvc/adventurephpfra/tags/1.9
SVN url: https://adventurephpfra.svn.sourceforge.net/svnroot/adventurephpfra/tags/1.9


Release packages

File name Date File size File type
adventure-codepack-1.9-2009-04-26-1248-php4.tar.bz2 2009-04-26 440.3 bz2
adventure-codepack-1.9-2009-04-26-1248-php4.tar.gz 2009-04-26 559.2 gz
adventure-codepack-1.9-2009-04-26-1248-php4.zip 2009-04-26 826.9 zip
adventure-codepack-1.9-2009-04-26-1248-php5.tar.bz2 2009-04-26 440.2 bz2
adventure-codepack-1.9-2009-04-26-1248-php5.tar.gz 2009-04-26 559.6 gz
adventure-codepack-1.9-2009-04-26-1248-php5.zip 2009-04-26 826.8 zip
adventure-configpack-1.9-2009-04-26-1248-noarch.tar.bz2 2009-04-26 7.6 bz2
adventure-configpack-1.9-2009-04-26-1248-noarch.tar.gz 2009-04-26 8 gz
adventure-configpack-1.9-2009-04-26-1248-noarch.zip 2009-04-26 14 zip
adventure-demopack-1.9-2009-04-26-1248-php4.tar.bz2 2009-04-26 528.6 bz2
adventure-demopack-1.9-2009-04-26-1248-php4.tar.gz 2009-04-26 644.7 gz
adventure-demopack-1.9-2009-04-26-1248-php4.zip 2009-04-26 948.5 zip
adventure-demopack-1.9-2009-04-26-1248-php5.tar.bz2 2009-04-26 528.7 bz2
adventure-demopack-1.9-2009-04-26-1248-php5.tar.gz 2009-04-26 645.2 gz
adventure-demopack-1.9-2009-04-26-1248-php5.zip 2009-04-26 948.4 zip
adventure-perfcodepack-1.9-2009-04-26-1248-php4.tar.bz2 2009-04-26 397.4 bz2
adventure-perfcodepack-1.9-2009-04-26-1248-php4.tar.gz 2009-04-26 447.3 gz
adventure-perfcodepack-1.9-2009-04-26-1248-php4.zip 2009-04-26 597.5 zip
adventure-perfcodepack-1.9-2009-04-26-1248-php5.tar.bz2 2009-04-26 397.4 bz2
adventure-perfcodepack-1.9-2009-04-26-1248-php5.tar.gz 2009-04-26 447.4 gz
adventure-perfcodepack-1.9-2009-04-26-1248-php5.zip 2009-04-26 597.5 zip



 Revision 1.8

Release 1.8 (stable) contains libraries for the use under PHP 4 and PHP 5. Please note, that with the release 1.7-RC2 two different architecture releases are delivered to prepare the separation of the two branches. The version was tested with versions greater than PHP 5.2.6 and <= PHP 4.4.8. This version is meant to be installed on production systems.

Major changes to the version 1.8 (stable) are:
  • Enhancement: As of release 1.8-RC1, the adventure-perfcodepack-* files are shipped additionally. These packages contain php files, that are free of comments and whitspaces and help you to gain performance on hosting environments having no byte-code-caching configured.
  • Improvement: The benchmark ids within classes derived from core_taglib_importdesign are now composed in a more generic way. This leads to better clarity analyzing the benchmark report.
  • Enhancement: The service manager now tells the service, which type of service it is. The legal values are SINGLETON, SESSIONSINGLETON und NORMAL. For this reason, the coreObject class definition was added the __ServiceType attribute.
  • Improvement: The error message of the Document::__loadContentFromFile() was improved in order to male debugging more easy.
  • Improvement: The MySQLHandler now escapes bind params applied to the executeStatement() method to avoid SQL injections.
  • Enhancement: The registry namespace apf::core now features a new, protected value: CurrentRequestURL. This param contains the complete request URL. This new attribute is used as a basis for the URL generation within the *:mediastream and the form:captcha tags.
  • Enhancement: In order to do more complex logging, the AdvancedLogger was added to the release. The documentation of the component can be seen in the class reference table - AdvancedLogger section.
  • Refactoring: The implementation of the html:template was rewritten as well as the derived classes. Prior to the change, tags added by the template:addtaglib were not transformed, because they didn't call the registerTagLibModule() method. Details on this issue can be seen in the german language forum within the <*:mediastream- />-Tags fertig topic.
  • Performance improvement: all remaining include_once()'s were replaced with include() calls to gain performance a little bit more.
  • Bugfix: within the init() function of the MySQLxHandler, the debug mode was not activated due to a typo of the configuration parameters.
  • Enhancement: initiated by a discussion in the php.de-Forum the idea of a core:appendnode tag was born. The taglib imports another template into the scope of another template and so enables the reusability of templates and forms. After another enhancement, the transformOnPlace() methods can be used to generate the output. The documentation of the tag can be read about in the special taglibs chapter.
  • Bugfix: if the MySQLHandler was used without the connectionManager, the escapeValue() had no valid database connection established.
  • Refactoring: As the roadmap mentions, the filesystemHandler was refactored as well. The functions provided by this component are now included in the FilesystemManager that can be found in the tools namespace. The documentation can be seen at the class reference table - FilesystemManager chapter. Please note, that the filesystemHandler located in the core::filesystem namespace was marked as deprecated and will be removed in the next release.
  • Improvement: the tag fcon:importdesign was added the attribute sessionsingleton. If it is set to true, the model is created in SESSIONSINGLETON mode. The documentation containing the description of the new attribute can be found under Standard taglibs.
  • Refactoring: Beneath other components, the bbcode parser was redesigned, too. The component contained within this release is much more generic and can be extended easily. Nevertheless, it contains predefined standard provider, that can be replaced or extended as desired. The documentation was updated and does now contain a chapter about the AdvancedBBCodeParser describing the configuration, the usage and the enhancement of the component. Please note, that the bbCodeParser is maked as deprecated and will be removed in the next release.
  • Enhancement: A discussion in the APF forum led to the idea of an abstract media streamer. This component should enable the developer to directly deliver media files from the application's namespace via an apf tag. For this reason, a base tag class, including the functionality, and the taglibs needed to use the mechanism within templates and forms was implemented. The documentation of the tag can be found in the special taglibs section.
  • Enhancement: A discussion about the implementation of the usermanagement module in the german language forum, ended up in the decision to create a more generic importdesign tag. Thus, the generic:importdesign was born. Compared to the fcon:importdesign tag, the implementation is more generic and hence lets you retrieve the template namespace from the model class, too. The current release now contains this implementation in the tools::html::taglib namespace. The documentation can be found in the special taglibs section.
  • Bugfix: The html_taglib_form::__createFormElement() method contained an error while initializing a form element's Context and Language. The reason for this bug was a typo, that was not recognized during automated tests.
  • Test improvement: As discussed in the thread Mehrsprachenfähigkeit in den Template Dateien (german), a tag was designed, that is able to translate special tags similar to the eZ component's behaviour. The improvement is marked as TEST, within the next release it will become STABLE.
  • Refactoring: While refactoring of some framework components, the CacheManager was updated, too. Because of the provider concept, various backends can be used. In order to use the component right away, the most important providers are already included. The documenation can be seen in the class reference table - CacheManager chapter. An application sample is included in the How to implement view based caching article.
  • Enhancement: Due to a request in the german language forum (see Implementierung des usermanagement-Moduls (german) for more details), the GenericORMapper was enhanced. The method loadRelatedObjects() now is able to solve additional relations described in the GenericCriterionObject and the loadNotRelatedObjects() function loads objects, that are not related to another. Also in this case, the GenericCriterionObject can be used to specify additional relations.
    With aid of the addRelationConfiguration() and addMappingConfiguration() methods, the mapping ans relation configuration can be influenced on runtime. These two functions enable the developer to keep the configuration more flexible.
    The documentation of the GenericORMapper was thus updated and some more examples were added.
  • Bugfix: The captcha-image-url-generation was improved, so that a valid url is generated for both url rewriting and normal mode. Further, addressing subfolders in normal mode was fixed.
  • Enhancement: The <form:captcha /> tag now features an attribute named clearonerror. If it is set to true, the content of the captcha text field is cleared on wrong user input. The updated documentation can be found in the builtin modules page.
  • 1.8-RC1 feedback: As of the feedback on the GenericORMapper component, two bugs were fixed. First, updates on objects are now only done when attributes have changed, second, the __getAssociationsByObjectName() now returns only relevant associations.

Files with names like adventure-codepack-* only contain the framework libraries, files with names like adventure-demopack-* the framework libraries plus a demo application and the documentation site. For beginners it is recommended to download the demo packages. Release files with a name like adventure-configpack-* contain a set of example configuration files. As of release 1.8-RC1 the adventure-perfcodepack-* release is included. This package contains php files, that are free of comments and whitspaces and help you to gain performance on hosting environments having no byte-code-caching configured.

Documentation

The following documentation files are available for this release:



Subversion repository

The files included in this release are also available in SVN. To check out the current release, please refer to the following URLs:

SVN web view: http://adventurephpfra.svn.sourceforge.net/viewvc/adventurephpfra/tags/1.8
SVN url: https://adventurephpfra.svn.sourceforge.net/svnroot/adventurephpfra/tags/1.8


Release packages

File name Date File size File type
adventure-codepack-1.8-2009-01-09-2214-php4.tar.bz2 2009-01-09 250.9 bz2
adventure-codepack-1.8-2009-01-09-2214-php4.tar.gz 2009-01-09 291.3 gz
adventure-codepack-1.8-2009-01-09-2214-php4.zip 2009-01-09 514.8 zip
adventure-codepack-1.8-2009-01-09-2214-php5.tar.bz2 2009-01-13 251.1 bz2
adventure-codepack-1.8-2009-01-09-2214-php5.tar.gz 2009-01-13 291.7 gz
adventure-codepack-1.8-2009-01-09-2214-php5.zip 2009-01-13 500.3 zip
adventure-configpack-1.8-2009-01-09-2214-noarch.tar.bz2 2009-01-09 6.6 bz2
adventure-configpack-1.8-2009-01-09-2214-noarch.tar.gz 2009-01-09 6.9 gz
adventure-configpack-1.8-2009-01-09-2214-noarch.zip 2009-01-09 12.1 zip
adventure-demopack-1.8-2009-01-09-2214-php4.tar.bz2 2009-01-09 352.3 bz2
adventure-demopack-1.8-2009-01-09-2214-php4.tar.gz 2009-01-09 393.8 gz
adventure-demopack-1.8-2009-01-09-2214-php4.zip 2009-01-09 652.5 zip
adventure-demopack-1.8-2009-01-09-2214-php5.tar.bz2 2009-01-13 352.4 bz2
adventure-demopack-1.8-2009-01-09-2214-php5.tar.gz 2009-01-13 394.3 gz
adventure-demopack-1.8-2009-01-09-2214-php5.zip 2009-01-13 635.7 zip
adventure-perfcodepack-1.8-2009-01-09-2214-php4.tar.bz2 2009-01-09 176.8 bz2
adventure-perfcodepack-1.8-2009-01-09-2214-php4.tar.gz 2009-01-09 189.7 gz
adventure-perfcodepack-1.8-2009-01-09-2214-php4.zip 2009-01-09 307.2 zip
adventure-perfcodepack-1.8-2009-01-09-2214-php5.tar.bz2 2009-01-13 176.6 bz2
adventure-perfcodepack-1.8-2009-01-09-2214-php5.tar.gz 2009-01-13 189.7 gz
adventure-perfcodepack-1.8-2009-01-09-2214-php5.zip 2009-01-13 294.1 zip
modules_captcha_1.8-2009-01-09-2214-noarch.zip 2009-04-12 89.3 zip



 Revision 1.7

Release 1.7 contains libraries for the use under PHP 4 and PHP 5. Please note, that with the release 1.7-RC2 two different architecture releases are delivered to prepare the separation of the two branches. The version was tested with versions greater than PHP 5.2.6 and <= PHP 4.4.8. This version is meant to be installed on production systems.

Major changes to the version 1.7 are:
  • Bugfix connectionManager: in case of multiple usage of the same connection it came to interferences of the database connection. For this reason, the caching mechanism was applied to the connectionManager.
  • The @ sign was removed in the MySQLHandler to let debugging of failed database connections be mor easy.
  • Bugfix frontcontrollerRequestFilter: if no action input parameters were given, the front controller filter threw an error. This issue was fixed by propery initializing the param array.
  • The optional $URLRewriting arguments were removed from the page and front controller. Still using this params in combination with the registry led to filter errors. Please refere to http://forum.adventure-php-framework.org/de/viewtopic.php?f=5&t=54&st=0&sk=t&sd=a&start=15#p250 (german) for details on that bug.
  • Enhancement newspager module: by means of the datadir param added in the <core:importdesign /> call, the data directory containing the news files can be configured as desired. Moreover, the error messages of the module were improved.
  • Enhancement guestbook module: the form was added a CAPTCHA to avoid SPAM.
  • Enhancement usermanagement module: a sample bootstrap file and a documentation uml was added.
  • Bugfix captcha module: the missing dependencs to the sessionManager was resolved. This bug lead to errors on displaying the captcha image.
  • Enhancement kontakt4 module: the form was added a CAPTCHA to avoid SPAM.
  • Bugfix comment module: the captcha url generation was corrected so that the captcha image is also delivered in case of normal url style. In past, the module only supported the url rewrite mode. Further, dependencies to the previous documentation page were removed.
  • Bugfix <fcon:importdesign /> tag: the model object was not imported properly, due to the fact, that the tag expected the import() call to take place in the bootstrap file already.
  • Enhancement of the framework: the linkHandler and frontcontrollerLinkHandler generate urls with encoded ampersands to be W3C compliant. The so generated urls cause redirects via header() to fail. Due to this reason, the HeaderManager was instroduced. This component resolves the encoded ampersands and redirects to the target page as desired. The documentstion of the class is only available in SVN, because this feature was planned for the 1.8 release
  • Enhancement ui_getstring: the error messages of the class ui_getstring were improved and enhanced to ease debugging during development. This class is the base class for the <*:getstring /> tags.
  • Bugfix Logger: the log dir initialization was moved to the flushLogBuffer() method. The reason for this change is, that ist is not necessary to create the log dir every time, but only when the logger needs to flush log messages. Especially when trying the example page on local environment, strange error messages occured before the code change. If no messages have to be flushed, the shutdown process is much faster now.
  • Cleanup errorManager: the "text-only" error message was removed from the errorManager, because the page controller classes are always present. So, the error message can always be displayed in graphical mode.
  • Enhancement Logger: the initialization of the log directory was switched to absolut directory style. If you use relative addressing, the PHP module's path interpretation is wrong under certain situations. This leads to strange "due to directory restriction" errors. To ensure, that the logs can be written successfully, please initialize the LogDir directive with absolute paths only. Please have a look at Class reference table - Logger. for more details.
  • Enhancement of the <form:genericval /> tag: the tag now features a regular expression validation option. To use the option, the validator tag attribute must contain RegExp. Then the tag implementation uses the regular expression provided by the second attribute (regexp) to execute the validation of the desired element. The documentation under Generic validator was updated, too.
  • Bugfix myValidator: for this release, the myValidator's validateNumber() method recognizes negative or float numbers as valid numbers. The validation implementation therefore uses the PHP function is_numeric().
  • API change: as announced in the 1.7-RC1 changelog, the getFormElementsByType() function was removed from the html_taglib_form class.
  • Enhancement of the modules: the framework now features three brand new modules: captcha, genericormapper und usermanagement. To avoid SPAM messages, the captcha module was already added to the guestbook. For further details on the usage of the taglib, please refer to the CAPTCHA taglib documentation section. The genericormapper OR mapper component is intended to store, load and manipulate objects from a relational database. The documentation of this beta component can be seen on the german documentation page under Generischer OR-Mapper. The usermanagement module is based on the generic OR mapper and includes a universal user, group and role management. This module is beta, too. The documentation is currently created, but not available online yet.
  • Corrections to the sandbox: the documentation pages of the demopack were updated.
  • Bugfix Tutorials: To make the download package of the My first website tutorial running again, the code was migrated to release 1.7 style. Please note: in order to run the example, please download a codepack release suitable for your PHP version. For details, please have a look at the README.
  • Enhancement of the form taglibs: to be able to generate dynamic forms, the <form:marker /> tag was introduced. Together with the
    • addFormContentBeforeMarker()
    • addFormContentAfterMarker()
    • addFormElementBeforeMarker()
    • addFormElementAfterMarker()
    methods, the html_taglib_form class now is able to generate dynamic forms in a comfortable way. Furthermore, the method addFormElement() was refactored to fit the new form element creation style. Hence, the documentation was extended by the dynamic forms chapter. Details on the feature discussion can be read about in the german forum under html_taglib_placeholder gesucht.
  • Documentation update: the whole documentation now contains anchor links. Moreover, each documentation page now contains a quick navigation for easy navigation.
  • Bugfix of the ui_element class: in case of '0' values, the form presetting did not work as expected. Please refer to Presetting of form values not correct when entering '0' for further details.
  • Enhancement of the tutorials: creation of a new forum-based tutorial "Minimales Modul mit dem APF" (german language only). The tutorial can be seen on http://forum.adventure-php-framework.org/de/viewtopic.php?f=6&t=44.
  • Enhancement of the standard registry values: the directive LibPath was added to the apf::core namespace. This value containes the dynamically generated base path to your apf code base. It can be used to address content located in the code base (e.g. images). The value is created read only and can thus not be manipulated during runtime. Details can be seen on the end of the basics.
  • API change to the form taglibs: the getFormElementsByType() method added in release 1.6 was renamed to getFormElementsByTagName(). The latter function does not expect the class name of the taglib, but the tag name of the desired tags (e.g. "form::text"). In order to be backward compatible, the beta series contains both methods. Please note, that the deprected function will be removed by 1.7 (stable).
  • The errorpage was translated into englisch language.
  • Implementation of the Registry component and removing of the ApplicationManager. Due to this changes, adaption to the bootstrap files is necessary. Details on the migration from versions lower than 1.7 to 1.7 can be found on the Migration from version 1.6 to 1.7 page.
  • Implemenation of the GenerigORMappers. Please note, that the code of the mapper is not available in this beta release, because the API is currently not stable. To receive an impression of how the mapper can be used, please have a look at the Generischer-OR-Mapper (at the moment only in german language) documentation page.
  • The packaging process was changed. Packages with the architecture suffix php4 are meant to be installed on PHP 4 servers, files with php5 should be used in PHP 5 environments and archives with noarch can be applied to any of the both architecture types.
  • The form tag libs have been added the form:addtaglib tag. With aid of this tag, further tags can be added to a form. Due to the fact, that the form's functionality is extended by another taglib implementation, the functionality included there remains reusable and can be added to further forms as well. The documentation of this new tag can be found on the standard taglibs page.

Files with names like adventure-codepack-* only contain the framework libraries, files with names like adventure-demopack-* the framework libraries plus a demo application and the documentation site. For beginners it is recommended to download the demo packages. Release files with a name like adventure-configpack-* contain a set of example configuration files.

Documentation

The following documentation files are available for this release:



Subversion repository

The files included in this release are also available in SVN. To check out the current release, please refer to the following URLs:

SVN web view: http://adventurephpfra.svn.sourceforge.net/viewvc/adventurephpfra/tags/1.7
SVN url: https://adventurephpfra.svn.sourceforge.net/svnroot/adventurephpfra/tags/1.7


Release packages

File name Date File size File type
adventure-codepack-1.7-2008-10-20-2204-php4.tar.bz2 2008-11-02 218.8 bz2
adventure-codepack-1.7-2008-10-20-2204-php4.tar.gz 2008-11-02 252.3 gz
adventure-codepack-1.7-2008-10-20-2204-php4.zip 2008-11-02 391.5 zip
adventure-codepack-1.7-2008-10-20-2204-php5.tar.bz2 2008-11-02 218.9 bz2
adventure-codepack-1.7-2008-10-20-2204-php5.tar.gz 2008-11-02 252.3 gz
adventure-codepack-1.7-2008-10-20-2204-php5.zip 2008-11-02 391.4 zip
adventure-configpack-1.7-2008-10-20-2204-noarch.tar.bz2 2008-11-02 6 bz2
adventure-configpack-1.7-2008-10-20-2204-noarch.tar.gz 2008-11-02 6.2 gz
adventure-configpack-1.7-2008-10-20-2204-noarch.zip 2008-11-02 10.5 zip
adventure-demopack-1.7-2008-10-20-2204-php4.tar.bz2 2008-11-02 314.2 bz2
adventure-demopack-1.7-2008-10-20-2204-php4.tar.gz 2008-11-02 343.3 gz
adventure-demopack-1.7-2008-10-20-2204-php4.zip 2008-11-02 517.5 zip
adventure-demopack-1.7-2008-10-20-2204-php5.tar.bz2 2008-11-02 314.4 bz2
adventure-demopack-1.7-2008-10-20-2204-php5.tar.gz 2008-11-02 343.3 gz
adventure-demopack-1.7-2008-10-20-2204-php5.zip 2008-11-02 517.4 zip



 Revision 1.6

Release 1.6 contains libraries for the use under PHP 4 and PHP 5. This version is a compatibility version as well as the last version, that does not use all language features, but fully operates with PHP 5. The version was tested with versions greater than PHP 5.2.1 and <= PHP 4.4.6. This version is meant to be installed on production systems.

Major changes to the version 1.6-*-php4_php5 are:
  • Created an overview page for reference projects (german only).
  • Created an article on XSS and code injection in context of the adventure php framework.
  • Wrote an article on how to build AJAX applications with the adventure php framework.
  • In Release 1.6-RC1 a new component for abstraction of database access layer components was added. For this reason, the connectionManager was created. Further, the release contains a database driver for the SQLite library. To use this feature you must have installed PHP with version 5.0.0 or higher. The documentation can be seen on the class reference page.
  • The singleton implementation was now enhanced by a abstract session singleton class. This class enables the developer to create classes that are singleton duing a PHP session. The documentation can be seen on the class reference page.
  • Enhancement to the __getServiceObject() and __getAndInitServiceObject() methods of the coreObject class. A new Attribute now defines, how the service layer classes are created. Permitted values are NORMAL, SINGLETON or SESSIONSINGLETON.
  • Generation of image links in the bbCodeParser class was changed to front controller image deliverance.
  • Translation of the contact form tutorial into english language. Now only the guestbook tutorials must be translated.
  • The roadmap was corrected due to timeline changes.
  • Reworking to the README files in the adventure-demopack-* files.
  • Update to some parts of the documentation.
  • Bugfix to the pagerManager's method getPager(). Here, the language of the Document class was not set correctly. See http://forum.adventure-php-framework.org/en/viewtopic.php?f=9&t=11 for more details.
  • Bugfix to the MySQLHandler class. During usage of the connectionManager and while having varios database connections within one application, it came to interference of the established connections. This led to strange application behaviours and errors.
    Please note: If you are using the connectionManager please be sure to use different users for each connection definition. This is necessary, due to the fact, that the mysql server assigns identical connection ids to connections established with the same combination of host, user and password. This also leads to interference of connections.
  • Bugfix of the __extractTagLibTags() method: during parser errors the taglib was not printed. Please see http://forum.adventure-php-framework.org/de/viewtopic.php?f=5&t=30&p=93#p93 for more details.
  • Performance improvement to the import() function. Files that are already included are marked now by the framework. This gains the performance of importing files up to 30%.
  • The adventure-demopack-* release files were completely reworked. Now they do not contain the entire online website, because the installation of the online documentation page often lead to problems. For this reason a totally new demostration page was developed that can easily be installed on any machine and with zero configuration.
    Note:
    On LINUX or UNIX systemen the following commands should be executed after extracting the package so that the filesystem permissions are correctly set:
      cd /path/to/extracted/package
      for DIR in $(find -type d); do chmod a+x,o-w $DIR; done
      for DIR in $(find -type f); do chmod a-x $DIR; done
      chown -R apache:apache /path/to/extracted/package
    
    The cause is here, that the packages are created on a windows build server on which the LINUX and/or UNIX filesystem rights are not set correctly.
  • To ease the developer's work another package was introduced that contains example configuration files for the modules shipped with each release. When you have decided to use it, please unpack it to the apps/ directory. After that the configuration files must be copied to the context sensitive folders where the ConfigurationManager expects them to be.

    Example:
    For the module kontakt4 the adventure-configpack-* includes two files in the /config/modules/kontakt4 folder. If the module is included in a project that uses the context sites::myproject the files must be moved to the+ /config/modules/kontakt4/sites/myproject folder. The prefix of these two files (by default: EXAMPLE) must also be adapted to the APPS__ENVIRONMENT's configuration of the project.
  • In order to ease reference a list of form element, the method getFormElementsByType() was introduced. This function returns a list of form elements that are of the same type. The mandatory parameter therefore indicates the name of the class (e.g. "form_taglib_text") of the form element. Details can be seen in the API documentation.
  • The taglibs html:template and html:form now implement the transformOnPlace feature. That means that these elements can be displayed on their place of definition within a DOM node in case the transformOnPlace() is applied to the desired object. For this reason, the developer saves time. For more details on the feature discussion, please have a look at http://forum.adventure-php-framework.org/de/viewtopic.php?f=5&t=36 (german content only). A brief introduction on this feature is provided in the templates section in chapter 2.2 and the forms section in chapter 1.
  • In order to ease the output of lists, the iterator template was introduced. This template is able to display object or associative array lists. The origin feature discussion can be seen under http://forum.adventure-php-framework.org/de/viewtopic.php?p=125#p125 (german content only), the tag functionality is described in the standard taglibs section in chapter 6.
  • Bugfix to the form:multiselect taglib. If the form element was filled in a document controller, the presetting was not executed correctly. For this reason the transform() method was reimplemented.
  • Bugfix to the form:multiselect taglib. If the form element was filled in a document controller, the validation was not executed correctly. For this reason the private __validate() method was reimplemented.
  • To make the readout of select and multiselect fields more comfortable, the two functions getSelectedOptions() (select field) und getSelectedOptions() (multiselect field) were added. These function return the currently selected option in case of a select field an a list of selected options in case of a multiselect field. Details on using these methods have been added to the forms section in chapter 3. The API documentation was updated, too.
  • General bugfixes and performance enhancements.
Please note that the hints of the last revision concerning the inclusion of software modules via import() are relevant for this version, too!

Files with names like adventure-codepack-* only contain the framework libraries, files with names like adventure-demopack-* the framework libraries plus a demo application and the documentation site. For beginners it is recommended to download the demo packages. Release files with a name like adventure-configpack-* contain a set of example configuration files.

Documentation

The following documentation files are available for this release:



Subversion repository

The files included in this release are also available in SVN. To check out the current release, please refer to the following URLs:

SVN web view: http://adventurephpfra.svn.sourceforge.net/viewvc/adventurephpfra/tags/1.6
SVN url: https://adventurephpfra.svn.sourceforge.net/svnroot/adventurephpfra/tags/1.6


Release packages

File name Date File size File type
adventure-codepack-1.6-15.06.2008-php4_php5.tar.bz2 2008-10-19 191.6 bz2
adventure-codepack-1.6-15.06.2008-php4_php5.tar.gz 2008-10-19 219.1 gz
adventure-codepack-1.6-15.06.2008-php4_php5.zip 2008-10-19 335.7 zip
adventure-configpack-1.6-15.06.2008-php4_php5.tar.bz2 2008-10-19 4.7 bz2
adventure-configpack-1.6-15.06.2008-php4_php5.tar.gz 2008-10-19 4.8 gz
adventure-configpack-1.6-15.06.2008-php4_php5.zip 2008-10-19 10.7 zip
adventure-demopack-1.6-15.06.2008-php4_php5.tar.bz2 2008-10-19 171.2 bz2
adventure-demopack-1.6-15.06.2008-php4_php5.tar.gz 2008-10-19 196.4 gz
adventure-demopack-1.6-15.06.2008-php4_php5.zip 2008-10-19 302.8 zip



 Revision 1.5

Release 1.5 contains libraries for the use under PHP 4 and PHP 5. This version is a compatibility version as well as the last version, that does not use all language features, but fully operates with PHP 5. The version was tested with versions greater than PHP 5.2.1 and <= PHP 4.4.6. This version is meant to be installed on production systems. Revision 1.5 merely is a bugfix and documentation update release.

Major changes to this version are:
  • Installation und configuration of a german and english language support forum. The english forum can be found under http://forum.adventure-php-framework.org/en.
  • Test of the UTF-8 processing of the framework. This test was passed during application development for a backend software to control a streaming server (http://streamadmin.nmm.de.nmm.de). The program installed there is based on the release 1.4 with all patches available.
  • Enhancement of some applications delivered with the release to be multilangual.
  • Translation of the documentation into english language.
  • Translation of the tutorial block into english language. Now only the tutorials contact form and guestbook must be translated.
  • Introduction of a multilingual menu.
  • Deletion of the method isButtonPushed() from the baseController class. This functionality is fully included in the form taglibs.
  • Addition of the generateURLParams() to the frontcontrollerLinkHandler component to generate a parameter array to use with the generateLink() function by the namespace, name and parameters of an action. For detailled information please refer to FrontController, chapter 1.4.3.
  • Bugtracking was moved to the forum. Please report bugs to http://forum.adventure-php-framework.org/en/viewforum.php?f=9. in the future.
  • Within this release a complete rewritten class reference table was added, that describes the major tools of the framework. There you can find descriptions on the usage and real life examples.
  • The comment function module now features a CAPTCHA SPAM protection due to the fact the the contact form was spammed for several days. For this reason, the module was enhanced by a new front controller action, that serves the CAPTCHA images and the business tier was changed to understand the handling of the CAPTCHA string.
  • The roadmap was corrected due to timeline changes.
  • The MySQLHandler was added the new public method escapeValue() to be able to escape strings used within MySQL statements afterwards.
  • The bugfixes for the FrontController und frontcontrollerLinkHandler discussed in the forum are completely included in this release.
  • Bugfix to the contact form as described under http://forum.adventure-php-framework.org/en/viewtopic.php?f=9&t=7.
  • The bbCodeParser was changed to support front controller-style delivery of images. This release also includes bugfixes to the bbCodeParser as the class generated incorrect front controller action links in non-rewrite mode.
  • The stringAssistant was enhanced with the method generateCaptchaString to generate a CAPTCHA string. The length of the string can be configured during function call.
  • Reworking to the README files in the adventure-demopack-* files.
  • General bugfixes and performance enhancements.
Please note that the hints of the last revision concerning the inclusion of software modules via import() are relevant for this version, too!

Files with names like adventure-codepack-* only contain the framework libraries, files with names like adventure-demopack-* the framework libraries plus a demo application and the documentation site. For beginners it is recommended to download the demo packages.

Documentation

The following documentation files are available for this release:



Subversion repository

The files included in this release are also available in SVN. To check out the current release, please refer to the following URLs:

SVN web view: http://adventurephpfra.svn.sourceforge.net/viewvc/adventurephpfra/tags/1.5
SVN url: https://adventurephpfra.svn.sourceforge.net/svnroot/adventurephpfra/tags/1.5


Release packages

File name Date File size File type
adventure-codepack-1.5-15.01.2008-php4_php5.tar.bz2 2008-10-19 186.1 bz2
adventure-codepack-1.5-15.01.2008-php4_php5.tar.gz 2008-10-19 211.6 gz
adventure-codepack-1.5-15.01.2008-php4_php5.zip 2008-10-19 319.2 zip
adventure-demopack-1.5-15.01.2008-php4_php5.tar.bz2 2008-10-19 4710.5 bz2
adventure-demopack-1.5-15.01.2008-php4_php5.tar.gz 2008-10-19 4986.4 gz
adventure-demopack-1.5-15.01.2008-php4_php5.zip 2008-10-19 5196 zip
bugfix_1.5_15.01.2008_1.6-RC1_pagecontroller_token_not_displayed.zip 2008-10-19 23.2 zip



Suchmaschinenoptimierung mit Ranking-Hits
Powered by WebRing.