Translations
Info
All page names need to be in English.
en da  de  fr  it  ja  km  nl  ru  zh

FLOW3 1.0.0 alpha5

From TYPO3Wiki
Jump to: navigation, search
This page belongs to the Flow Team (category Flow)

Release Notes for FLOW3 1.0.0 alpha5

This document contains information about FLOW3 version 1.0.0 alpha5 which was released on October 1st, 2009.

News

notice - Note

As an alpha release, FLOW3 1.0.0-alpha5 is naturally not recommended for production use

News article on typo3.org

What's New?

According to our focus we tried to zap as many gremlins as possible, resulting in 33 resolved issues. Those include bug fixes, documentation updates and of course a slew of new features that make FLOW3 easier to use.

For a full list of new features and improvements please see our Changelog below.

Alpha

Again, as an alpha release, FLOW3 1.0.0-alpha5 is naturally not recommended for production use. Be warned: It's a bit slow, eats more memory than is perhaps healthy and has not yet undergone a full security review. However these issues will be addressed in the upcoming alpha releases and we're confident that FLOW3 1.0.0 final will be a rock solid framework which performs well in production environments.

Next Release

FLOW3 1.0.0 alpha 6 is scheduled for 2nd of November 2009. It will see a new Resource Manager, an updated ExtJS package and probably a lot of tiny things we need for getting things done when it comes to TYPO3 v5.

Your Feedback

We want to hear your opinions! What's your experience with this release? What went well, what didn't? What features are you missing? Join our discussions in the mailing list, IRC channel and twitter ... Check out http://flow.typo3.org/get-involved/ for ways to get involved and get in touch. Get into the FLOW3! - Your FLOW3 Core Team

Download

http://flow.typo3.org/download/

MD5 checksums

MD5 (FLOW3-1.0.0-alpha5.bz2) = cf01c8cf34059866efea0028f27a8ba8
MD5 (FLOW3-1.0.0-alpha5.tgz) = 8344b0181dca814783c8fcafdd0aa541
MD5 (FLOW3-1.0.0-alpha5.zip) = de42b646fdcea08af5ebad0a9f69cebd

Upgrading

This time there were some changes that likely require you to adjust your code (sorry for that!). Here is a list of things to watch out for:

  • The SEVERITY_* constants from the LoggerInterface are gone, use the corresponding PHP constants (LOG_*) instead
  • The EmptyView has been removed, so if you have actions that do not return anything, make them return an empty string - or you will get an error about a template not being found
  • The handling of flash messages has changed. In a controller use $this->flashMessageContainer->add() instead of $this->flashMessages->push(); in a view use <f:flashMessages> instead of a custom loop over the flashMessages variable.
  • If using the form.submit view helper, make sure to put the value in the value attribute, not inside the tag
  • The RangeValidator now expects the arguments "minimum" and "maximum" instead of "startRange" and "endRange"

Changelog

-------------------------------------------------------------------------------
  Changes that require end-user code adjustments
-------------------------------------------------------------------------------

FLOW3 (Log) Removed SEVERITY_* constants and switched to PHP's LOG_* constants, resolves #4824 - r3243
FLOW3 (MVC) The recently introduced class "FlashMessages" was renamed to "FlashMessageContainer" and the property name within the AbstractController was changed to "flashMessageContainer" accordingly. Check your controller code for use of $this->flashMessages! - r3252
FLOW3 (MVC) Removed EmptyView and made NotFoundView display helpful message instead, resolves #4405 - r3212
FLOW3 (Validation) The RangeValidator now expects the arguments "minimum" and "maximum" instead of "startRange" and "endRange". The CountValidator also uses "minimum" and "maxmimum", previously it was "min" and "max" - r3252

Fluid (ViewHelpers) Improved the way flash messages are handled. Now there is a separate "FlashMessages" object which encapsulates handling the flash messages. This removes $this->pushFlashMessage and $this->popFlashMessages inside the Controller and {flashMessages} inside Fluid Template. PLEASE UPGRADE by replacing "$this->pushFlashMessage(" with "$this->flashMessages->add(" inside your Controllers, and use <f:renderFlashMessages /> instead of the custom for loop inside your templates. Note: You can set a custom CSS class for outputting flash messages by using <f:renderFlashMessages class="..." /> inside your templates. Resolves #4638 - r3176
Fluid (ViewHelpers) Fixed the Form Submit ViewHelper. Now, Name and Value are used correctly. Resolves #4488 - r3178

-------------------------------------------------------------------------------
  FLOW3
-------------------------------------------------------------------------------

[TASK]
(Security) Added documentation for the main features of the security framework. Resolves #3624 - r3198
(Cache) Modified the way the md5 hash is created for the APC cache entry prefixes. The hash now matches that of the Environment's temporary path prefix - r3248
(Cache) Fixed memcache (and APC) backend to use the cache identifier in their prefix in order to not overwrite entries from different caches having the same entry identifier. Tweaked Caches.yaml so it is possible to change the default cache backend to something with more options than the TransientMemoryBackend. Relates to #4602 - r3210
(Error) the DebugExceptionHandler now shows a link to Forge for creating an issue - we'll see how that turns out... Resolves #3030 - r3233
(Error) some tweaks to error handling inspired by v4 backport discussion - r3195
(Log) Removed SEVERITY_* constants and switched to PHP's LOG_* constants, resolves #4824 - r3243
(Log) the setting for the maximum log file size is now in bytes instead of MB, relates to #4333 - r3242
(Reflection) Class schemata are now built only when the corresponding class is reflected as well, the schemata are also cached now with other reflection information - r3183
(Reflection) When reflecting method parameters the @param annotations for those are checked for correctness. For now errors are logged to the FLOW3 system logger with debug priority - r3183
(Documentation) Expanded section on annotations used in the code, resolves #4169 - r3221
(Documentation) Added XAMPP installation instructions for the new version. Some adjustments to the old instructions - r3235
(Documentation) Added explanation of add/retrieve behaviour in persistence repositories to the manual, fixes #4755 - r3238
(Documentation) Finished first version of IIS installation documentation - r3240
(Documentation) added warning about XAMPP on Mac to the manual. Fixes #4799 - r3237
(Documentation) Corrected the hints to the windows temporary path in the FLOW3 installation instructions - r3235
(Documentation) Removed an example demonstrating the Objects.php file syntax which is not supported anymore - r3167

[CONFIGURATION]
(Log) Added severityThreshold to the log backend options, in Production context only messages warnings (and above) are logged, in Development context all messages are logged - r3239

[BUGFIX]
fixed description in Package.xml, fixes #4606 - r3202
(Cache) Added missing dependency configuration for memcache and APC backends to Objects.yaml, fixes #4602 - r3210
(Core) When an invalid context is given an error message is displayed, fixes #4596 - r3236
(Error) When an error is caught by the error handler the FLOW3 exception class is used only if available (otherwise the builtin PHP exception is used), fixes #3415 - r3214
(MVC) Cleaned up validator registration in ActionController. Now, @dontvalidate annotations only disable the model-based validators - r3192
(MVC) Now, in case people do not specify an @param annotation, they will get an exception instead of Text being used - r3192
(MVC) The RESTController no longer defines the $id argument for methods, this fixes #4013. You must declare the $id argument properly in your controller actions from now on! - r3225
(Object) Object manager now returns cloned object configurations, fixes #3742; made some tests test what they were supposed to test - r3204
(Reflection) Class schemata are now really built when needed, fixes #4666 - r3191
(Session) Default session save path is now as before (if configzured by the user, uniqueness should be maintained), fixes #4740 - r3216
(Utility) *TypeFromFilename() work now when no extension is present, fixes #3278 - r3230
(Validation) @param string is now validated as string, and not anymore as Text. This fixes numerous bug reports in Fluid - r3192
(Validation) Cleaned up ValidatorResolver. Now, Validators which check the data type from the @param annotation are also added to the validator chain - r3192

[FEATURE]
(Log) The file backend now logs only messages above a given severity, resolves #3864 - r3239
(Log) The file backend now has the ability to rotate log files of they exceed a configured size and can keep a configurable number of log files. Resolves #4333 - r3241
(MVC) The standard view now has some links to documentation, resolves #3467 - r3205
(MVC) Improved the way flash messages are handled. Now there is a separate "FlashMessages" object which encapsulates handling the flash messages. This removes $this->pushFlashMessage and $this->popFlashMessages inside the Controller and {flashMessages} inside Fluid Template. PLEASE UPGRADE by replacing "$this->pushFlashMessage(" with "$this->flashMessages->add(" inside your Controllers, and use <f:renderFlashMessages /> instead of the custom for loop inside your templates. Note: You can set a custom CSS class for outputting flash messages by using <f:renderFlashMessages class="..." /> inside your templates. Resolves #4638 - r3175
(MVC) Now, non-domain-objects can be mapped inside an argument as well. Additionally, improved the exceptions in these cases. Resolves #4631 - r3174
(MVC) If mod_rewrite is not available generated links will include index.php, resolves #87 - r3234
(MVC) Removed EmptyView and made NotFoundView display helpful message instead, resolves #4405 - r3212
(Package) Duplicate packages are now detected and an exception is thrown, resolves #3950 - r3217
(Package) PackageStates.yaml is now created if not present or empty, all available packages are activated. Resolves #3989 - r3213
(Persistence) added removeAll() to base repository, resolves #3852 - r3189
(Persistence) When calling update() with a non-clone an exception is thrown, resolves #4328 - r3207
(Security) Implemented the logoutAction() in the authenctication controller - r3215
(Session) Session save path for PHPSession is now configurable, resolves #1663 - r3211
(Validation) Added CountValidator, resolves #3956 - r3219

[API]
(MVC) Removed enableValidation() and disableValidation() on the Controller Argument. They are not needed anymore - r3192
(MVC) The recently introduced class "FlashMessages" was renamed to "FlashMessageContainer" and the property name within the AbstractController was changed to "flashMessageContainer" accordingly. Check your controller code for use of $this->flashMessages! - r3252
(Validation) The RangeValidator now expects the arguments "minimum" and "maximum" instead of "startRange" and "endRange". The CountValidator also uses "minimum" and "maxmimum", previously it was "min" and "max" - r3252


-------------------------------------------------------------------------------
  Fluid
-------------------------------------------------------------------------------

[FEATURE]
Added internal debug mode. Now, during normal operation, the description of ViewHelper arguments is not parsed anymore. We need to rename the debug mode still - r3172
(TemplateView) made layoutRootPath and partialRootPath configurable. Now templateRootPath defines the path to the "Templates" folder. LayoutRootPath & PartialRootPath can be specified independently. Related to #3296 - r3193
(ViewHelpers) added CycleViewHelper. Resolves #4458 - r3190
(ViewHelpers) added GroupedForViewHelper. Resolves #4460 - r3190
(ViewHelpers) Implemented an ifGrantedAuthority view helper - r3215
(ViewHelpers) Added a Form Password ViewHelper, to generate password input boxes. Resolves #4648 - r3182
(ViewHelpers) added padding viewhelper (by Bastian Waidelich) - r3169
(ViewHelpers) Improved the way flash messages are handled. Now there is a separate "FlashMessages" object which encapsulates handling the flash messages. This removes $this->pushFlashMessage and $this->popFlashMessages inside the Controller and {flashMessages} inside Fluid Template. PLEASE UPGRADE by replacing "$this->pushFlashMessage(" with "$this->flashMessages->add(" inside your Controllers, and use <f:renderFlashMessages /> instead of the custom for loop inside your templates. Note: You can set a custom CSS class for outputting flash messages by using <f:renderFlashMessages class="..." /> inside your templates. Resolves #4638 - r3176

[BUGFIX]
(Core) Made sure that ViewHelper arguments can not be re-declared with the same name. Resolves #4492 - r3178
(ViewHelpers) Fixed the Form Submit ViewHelper. Now, Name and Value are used correctly. Resolves #4488 - r3178

[API]
(ViewHelper) Renamed the "RenderFlashMessages" view helper to "FlashMessages". Replace "<f:renderFlashMessages" by "<f:flashMessages" in your templates if you already used this new feature - r3252


-------------------------------------------------------------------------------
  GettingStarted
-------------------------------------------------------------------------------

[TASK]
(Documentation) added warning about XAMPP on Mac to the manual. Relates to #4799 - r3237


-------------------------------------------------------------------------------
  Kickstart
-------------------------------------------------------------------------------

[FEATURE]
type hints are now created in setters for objects and arrays - r3168


-------------------------------------------------------------------------------
  Welcome
-------------------------------------------------------------------------------

[BUGFIX]
fixed command line instructions on welcome screen, fixes #4551, fixes #4489 - r3201

[TASK]
made sure the link to MyPackage works if mod_rewrite is disabled - r3234

Past Release Notes

If you have skipped one version while upgrading to this version, please make sure to read those ReleaseNotes (see list) also.