Release notes

Version 1.3.beta2

This version does not include the examples. It is meant to run on both php4 and php5.

There is no 1.3.beta2 version of the examples, please use examples version 1.3.beta1.

What's new

Since phpPeanuts 1.3.beta1a

* measure to protect application developers. The framework itself does and did not not use unchecked request data for includeSkin.
** php-writable files (including an error log file) on a webserver are considered a security risk. Assumes you want to avoid that risk.


Since phpPeanuts 1.3.beta1

Since phpPeanuts 1.2.0

Portablility

This version is meant to run on both php4 and php5, the last with zend.ze1_compatibility_mode = On as well as Off. On php5 the code will not be free of E_STRICT notifications.

If you want your application code to be portable too it has to follow certain rules:

Like phpPeanuts, code that follows these rules should be able to run with equal behavior without modification on both platforms, and on php5 with both zend.ze1 compatibility settings. However, there may still be differences in areas of php that phpPeanuts does not use. This may require some further wrapper functions to be added.

For object oriented application frameworks like phpPeanuts php5 is a much better platform than php4. However, some people are still using php4 as their deployment platform because some website hosting accounts do not yet support php5. PhpPeanuts up to the production release of version 1.3 will be compatible with php4. Next version of phpPeanuts will probably be for php5 only.

Known bugs and limitations

  1. not tested with php5.1. Because we solved most of the the problems that where where found with php5.2 we assume it will work with 5.1 too.
  2. With php 4.4 and 5.2.0 (documentation suggests the same will happen with 5.1) phpPeanuts still triggers some notifications "Only variable references should be returned by reference". PhpPeanuts intensively uses variable references. With respect to references it is like php has broken with the principle of automatic type conversion: whenever a value has to be converted to a reference automatically, notifications are triggered. To avoid these notifications arrays are from now on to be passed by value. In the framework core most of these notifications have been fixed. Some notifications remain: When a function that returns an Error it is not first put into a variable. For this beta we do not consider this enough of a problem to delay its release.
  3. Examples and tests produce "Only variable references should be returned by reference" notifications on php4.4 and 5.1 and up. SqlJoinFilterTest produces E_RECOVERABLE_ERRORs on php5.2.
  4. Column mappings may not be consequently applied. If you need to set a columnName different to the propertyName on an PropertyDescriptor, test your applications database persistence functionality thouroughly. (we don't use this feature ourselves. If someone is using it, please report on how it works and on bugs, otherwise this may never be resolved).
  5. Reference Anomalies: Before the generic workaround was applied (introduced in 1.1 beta 1, released dd 16-11-2004), use of references by phpPeanuts occasionally made uninitialized php variables or associations arbitrarily hold values that seemed to come from another variable. This rarily happened and since the generic workaround it never happend again, so we recon this issue closed. However, it is impossible to guarantee that the problem has been eliminated once and for all. Do not use phpPeanuts for mission critical applications.
  6. Though the framework has a class that is pointed to become the database abstraction layer, there is still quite some code that does not delegate to this layer, but will clearly have to delegate if phpPeanuts has to work on other databases.
  7. produces E_STRICT notifications on php5 (see under portability).