EXT: punkt.de Tools (pt_tools)¶

Convert errors to exceptions¶

Convert errors to exceptions by using set_error_handler(). Errors¶

Catch uncaught exceptions¶

Catch uncaught exceptions (by using set_exception_handler()) and¶

After having installed the extension itself, you have to include the static extension template “pt_tools” to your Typoscript template.

With the static template included, you may want to configure pt_tools for your individual needs. All configurations can be done in TYPO3's Constant Editor. Please refer to the chapter 'Configuration' for details.

Category: PT_TOOLS [= general configuration]¶

Category: PT_TOOLS::MSGBOX [= configuration for class tx_pttools_msgBox]¶

Category: PT_TOOLS::FORMCHECKER [= configuration for class tx_pttools_formchecker]¶

Category: PT_TOOLS::FORMTEMPLATEHANDLER [= configuration for class tx_pttools_formTemplateHandler]¶

v1.0.1:¶

removed SVN control directories for TER version

v1.0.0:¶

• improved and extended available security tools in tx_pttools_div: added quoteStr() as a string quoting method to prevent SQL injections in TypoScript code (for usage as TS userFunction, see inline PHPdoc comment for example), improved existing XSS prevention methods htmlOutput() and htmlOutputArray(), added XSS prevention method htmlOutputArrayAccess() for automatic filtering of complete objects implementing PHP's ArrayAccess interface
• added new payment API classes (to res/objects/): tx_pttools_paymentRequestInformation, tx_pttools_paymentReturnInformation
• added new interfaces (to res/abstracts/): tx_pttools_iPageable, tx_pttools_iTemplateable, tx_pttools_iSettableByArray, tx_pttools_iQuickformRenderer, iSingletonCollection
• added a templatable form renderer based on PEAR HTML_Quickform: added renderer interface res/abstract/class.tx_pttools_iQuickformRenderer.php, renderer class res/objects/class.tx_pttools_qfDefaultRenderer.php and renderer templates res/tmpl/tx_pttools_quickformRenderer*.html
• added several new Smarty modifiers to res/smarty_plugins (stdWrap, explodeAndPrint, urlencode, convertDate, trace, registerValue, numberFormat, includeCssFile, includeJsFile)
• added new toolbox methods to tx_pttools_div: hasGroupAccess(), isAssociativeArray(), isIntegerish(), stdWrapArray(), getLangObject() [use the latest if you need a lang object and don't want to care about the context you're in]
• added new exception tx_pttools_exceptionNotImplemented (in res/objects/exceptions)
• added new hooks in tx_pttools_div::localRedirect() (to allow things to be done before redirecting) and in tx_pttools_smartyAdapter::__construct() (to allow adding other locations for smarty plugin directories)
• tx_pttools_finance::getFormattedPriceString() respects locale's thousands separator now
• class.tx_pttools_assert.php: fixed isNotEmptyString() for usage with string '0', added assertion isAssociativeArray()
• tx_pttools_smartyAdapter now reads language file from EXT:<extkey>/locallang.xml by default (instead of throwing an error if nothing is configured)
• tx_pttools_debug (including global trace() method): ignores tx_pttools_exception inclusion in non TYPO3-mode now (thus allows to use the base class functions in any arbitrary context now), added exceptionToTxt() and extended catchUncaughtExceptionsExceptionHandler() to display exception in text format when in CLI mode
• miscellaneous minor internal improvements, additions and fixes

v0.4.1:¶

• Smarty: adapted compile and cache directories to the defaults of the current smarty extension (changed default initialisation for tx_pttools_smartyAdapter constructor, added default directory config in ext_localconf.php (may be overwritten individually); IMPORTANT : your extensions using Smarty should create the required directories with an appropriate entry in their emconf.php file (e.g. set 'createDirs' to 'typo3temp/smarty_cache,typo3temp/smarty_compile')
• revision of tx_pttools_sessionStorageAdapter and tx_pttools_feUsersessionStorageAdapter: all methods no more dependent on $GLOBALS['TSFE'], but now on $GLOBALS['TSFE']->fe_user only - this allows you to use the adapters in the eID context as well (where we do not have a TSFE) by creating a FE user in your eID script (see chapter “Users manual” above)
• tx_pttools_div::typoscriptRegistry(): bugfix for isValidUid() assertion, improved TSFE assertion
• tx_pttools_div: added new method :getPeriodAsInt() to translate time periods to convert strings describing time periods to integers of given unit
• tx_pttools_assert:
• isMySQLRessource() works with other t3lib_db objects now, added new optional parameter in-between(!)
• isType(): marked as deprecated now (use isInstanceOf() instead)
• added some new assertions to tx_pttools_assert: isNotNull(), isPositiveInteger(), isValidEmail(), loggedIn()
• tx_pttools_formTemplateHandler allows arbitrary JavaScript event handlers for all kinds of inputs now
• miscellaneous internal improvements (tx_pttools_div::mergeConfAndFlexform(), tx_pttools_div::returnExtConfArray(), tx_pttools_div::hookRequest(), tx_pttools_exceptionDatabase::__construct(), tx_pttools_debug::trace(), faketsfe.inc.php) and logging additions

v0.4.0:¶

• major revision of Smarty integration: complete re-write of tx_pttools_smartyAdapter (fully backwards compatible), added new class res/objects/class.tx_pttools_smartyCompiler.php, added directory “smarty_plugins” (containing additional modifiers and callback functions for usage with the Smarty templating engine, e.g. a modifier to access TYPO3 locallang labels directly from the Smarty template)
• major revision of the collection concept: added new abstract class tx_pttools_collection for arbitrary item collections, new class contains most (slightly modified) methods of former tx_pttools_objectCollection, tx_pttools_objectCollection now extends tx_pttools_collection and provides object related functionality only, tx_pttools_registry now extends new abstract class tx_pttools_collection to allow arbitrary registry entries; fixed bug if no search value was given to collection method keys()
• added new debugging features: added extension configuration option “convertErrorsToExceptions” and “catchUncaughtExceptions” in extension manager, added appropriate set_*_Handler in ext_localconf.php and new tx_pttools_debug methods convertErrorToExceptionErrorHandler() and catchUncaughtExceptionsExceptionHandler(). Using these new options you're enabled to catch errors and uncaught exceptions and display them with a nice backtrace (for details refer to the EM's option descriptions). In combination with TYPO3's "systemLog" these options can provide a mighty tool while developing and for monitoring
• improvements of formTemplateHandler: fixed textarea handling bug, added left.gif (copied from Apache icons), buttons now can have an arbitrary number of event handlers, clickbuttons allowed now, improved form elements checks, FTH manual extended for Javascript functions, added form sections (via SECTIONSTART and SECTIONEND)
• added cookie check method tx_pttools_div::checkCookies() and new TS option cookieErrorPage in Constant Editor for this method
• tx_pttools_div: fixed bug in returnTyposcriptSetup() (if TSFE is incompletely loaded, e.g. with preBeUser hook), revised hookRequest(), added new methods typoscriptRegistry(), getTS(), clearCache(), sanitizeIntList()
• tx_pttools_debug: removed method backtraceErrorHandler(), added new method cleanBacktrace(), extended inDevContext() (BE admins are in dev context by default now), adapted default CSS path in exceptionToHTML(), improved trace()
• improvements of tx_pttools_finance: getFormattedPriceString() configurable now (added new TS option currencyFormat in Constant Editor), getFormattedPriceString() now separates decimal places using "." or "," depending on locale
• tx_pttools_assert: fixed bug in matchesPattern(), added some new assertion methods, miscellaneous improvements
• tx_pttools_formchecker: added new methods checkNone(), checkMultiselect()
• tx_pttools_cliHandler: added new method readFileRelToCliScript()
• tx_pttools_formReloadHandler: converted all methods to static methods
• tx_pttools_exception: added new method handle(), use this from now on instead of now deprecated method handleException()
• inc/faketsfe.inc.php: fake TSFE provides a cObj now
• minor internal improvements and logging additions, added some French locallang labels for formchecker

v0.3.0:¶

• major revision of tx_pttools_msgBox: removed inline CSS styles and icon related constants - default messagebox styles are now defined in the extension's static template at plugin.pt_tools._CSS_DEFAULT_STYLE to allow overriding with individual styles by Typoscript; removed inheritance from tslib_pibase (removed inherited properties scriptRelPath und extKey, changed language handling); calling an invalid messagebox type throws an exception now (instead of former display of the error within the messagebox) IMPORTANT : Styling of the "tx_pttools_msgBox" has changed - if you did not use the default values for the former (and henceforth no more used) Constant Editor/Typoscript parameters "msgboxFontHeadline", "msgboxFontMsg", "msgboxColHeadlineBg", "msgboxColMsgBg" or "msgboxColBorder", you have to apply your differing settings by adapting the default styles now defined in the extension's static template at "plugin.pt_tools._CSS_DEFAULT_STYLE" (defaults to be found in file pt_tools/static/setup.txt)!
• major revision of tx_pttools_objectCollection: implementation of SPL ArrayAccess interface; made property selectedId permanently available now; added new methods, exceptions and improvements
• major revision of exception handling (all changes are backwards compatible): added new classes in res/objects/exceptions for each special exception case of tx_pttools_exception (public usage of tx_pttools_exception's 2nd constructor parameter and EXCP_* constants are deprecated now!); exceptions are logged in devlog, sysLog and tsLog now; getter methods added to tx_pttools_exception
• revision of tx_pttools_formchecker: removed inheritance from tslib_pibase and inherited properties scriptRelPath und extKey, changed language handling for all check methods
• added assertion handling: new class res/staticlib/class.tx_pttools_assert.php for miscellaneous assertions, new class res/objects/exceptions/tx_pttools_exceptionAssertion for failed assertions
• added Registry design pattern implementation: new class res/objects/class.tx_pttools_registry.php
• added new class res/objects/class.tx_pttools_collectionElementSelector.php (see doc/manual_collectionElementSelector.txt for details)
• improved exception output possibilities for developers by adding new tx_pttools_debug methods getCodeSnippet(), exceptionToHTML() and traceToHtml() + new CSS file res/tmpl/exception.css
• tx_pttools_formTemplateHandler: fixed bug with hidden fields, added SplitDate input field processing
• tx_pttools_div: added new methods getPid(), outputToPopup() and inDevContext() (see inline comments for documentation), new optional param for mergeConfAndFlexform() to avoid exceptions
• tx_pttools_beSubmodule now allows also non-admins to access the backend modules
• raised TYPO3 dependency to version 4.0+
• minor internal improvements and bugfixes, converted locallang file in res/objects to XML

v0.2.5:¶

• tx_pttools_formchecker: changed default patterns in static/constants.txt to fix UTF-8 German umlaut problems on Linux
• tx_pttools_formchecker and tx_pttools_formTemplateHandler: fixed length check bug for UTF-8
• tx_pttools_msgBox: moved hardcoded message box HTML code to template file (configurable via TypoScript/Constant Editor), removed obsolete function generateMsgBoxHTML_OLD()
• tx_pttools_div::returnTyposcriptSetup() now usable for eID scripts, too
• tx_pttools_beSubmodule::printSearchForm: added parameter configuration for method
• tx_pttools_div::readLLfile(): added exception if $GLOBALS['LANG'] is no object
• changed visibility of miscellaneous object properties and methods from “private” to “protected” for better support of OOP inheritance

v0.2.4:¶

• added this manual and changelog
• overhaul of tx_pttools_exception (general cleanup, error code constants added)
• fix in faketsfe.inc.php, imrovement of tx_pttools_div::mergeConfAndFlexform()

EXT: punkt.de Tools (pt_tools) - 12