New addPreFilter() method and PHPTAL_PreFilter base class for filters.
PHPTAL->stripComments() has been implemented as a prefilter. It's smarter now – won't remove contents of comments in <script>.<pre> and supports xml:space="preserve".Old setPreFilter() still works, but hasn't gained any new features.
echoExecute() method for outputting result without buffering.metal:define-slot uses lazy callbacks to avoid buffering.<?xml-stylesheet?> used with PHP short tags (<?) enabled.<![CDATA[ blocks are added automatically where needed for compatibility with text/html and escaping is CDATA-aware.DOCTYPE is automatically changed to <!DOCTYPE html> and namespace declarations/prefixes are omitted.Instructions for alpha version still apply.
New look, bigger text, wider columns, better typography, syntax coloring. Please send complaints/compliments to the mailing list.
A big thanks goes to Levi Stanley from ENE Services LLC who has donated phptal.org domain to the project!
A big thanks goes to Levi Stanley from ENE Services LLC who has donated phptal.org domain to the project!
Fresh alpha package. Changes since last one:
PHPTAL_DIR is gone. PHPTAL now temporarily modifies include_path.
If you have PEAR version of PHPTAL installed and you want to use another, incompatible version and you need to include files from PHPTAL's directory, you'll need to modify include_path to point to your preferred version first. There are helper methods PHPTAL::setIncludePath() and
PHPTAL::restoreIncludePath() to handle this easily.
DOM-related classes and methods renamed once again.
Re-added few basic methods and properties for compatibility with custom attributes written for older PHPTAL versions.
GetTextTranslator sets locale's LC_MESSAGES only when LC_ALL doesn't work. This way you don't need full locale installed on the system to use gettext() (you should, however). setLanguage() now returns language that has been set.
XML namespace of phptal:* attributes has changed from http://xml.zope.org/namespaces/phptal to http://phptal.org/ns/phptal.
&apos entity is better supported.
Lots, lots of code formatting changes and doc comments for conformance with PEAR coding standards.
Fixed variable redefinition bug reported by Ciprian Vieru.
Fixed parsing of code with class constants and dynamic property names in php: expressions (bug reported by Bobby).
This is alpha release (don't use it on live sites!). It includes long overdue fixes to XML parser and PHPTAL's internals which may require some cosmetic changes to templates. Please test it and report problems and bugs you find.
The biggest difference is in handling of entities. Entities are now unescaped before passing to expressions, i.e. ${php:strlen('"')} “sees” just the quote character and returns 1. In previous versions entities were passed as-is to the expressions (and that example would return 6).
Newly added unescaping of entities can expose encoding bugs. Make sure your pages declare document encoding:
Content-Type:application/xhtml+xml;charset=UTF-8 or Content-Type:text/html;charset=UTF-8 HTTP headers (here's how.)text/xml MIME type, use application/xml instead.<meta> tag or send Content-Type:text/html;charset=UTF-8 HTTP header.If you're not using UTF-8 encoding, you must set encoding you use via PHPTAL->setEncoding('ISO-8859-…') (or just switch to UTF-8 already! :)
Only some 8-bit-based encodings are supported. If your encoding is not supported, you may get away with setting ISO-8859-1 instead.
All constants except PHPTAL_DIR and PHPTAL_VERSION have been removed. Remove any PHPTAL-specific define()s and use class methods for configuration (e.g. PHPTAL->setPhpCodeDestination('/tmp/phptal/') for custom temp directory.)
Don't include any PHPTAL's files before including PHPTAL.php. Please report any include-related problems you get (e.g. chicken-egg problems when extending PHPTAL's classes, class not found errors, etc.)
Fixed many quirks related to handling of entities in TALES expressions.
Fixed escaping in CDATA sections: special characters won't be changed to entities, </ and ]]> will be escaped appropriately for output mode used.
Improved XML namespace support. PHPTAL now rejects invalid prefixes and uses namespace URIs internally.
Comments are required to be well-formed (-- is not allowed in comments.)
HTML5 output mode. There's a bit of controversy around HTML5, so let me be clear: this doesn't allow “tagsoup”. PHPTAL still requires templates to be well-formed XML, and the output aims to be clean and conforming HTML5 text/html syntax.
HTML5 output mode is optional and enabled by PHPTAL->setOutputMode(PHPTAL::HTML5). The default output mode is compatible with XHTML/1.x and XHTML5.
Ability to add source resolvers. You can easily implement a fake filesystem that e.g. reads templates from the database. This is better than simply using PHPTAL->setSource(), because it allows external macros to work.
Comments starting with <!--! are stripped from output.
${} behaves more like tal:content="".tal:repeat doesn't “leak” variables to outer scope (bug reported by Richard Cernava.)$gotchas--;
PHPTAL::setForceReparse() to temporarily disable caching.)Filter.php before using filters.PHPTAL_Exception.This release improves speed and reliability of PHPTAL. Most notably:
NULL value of attribute added via tal:attributes now omits entire attribute in most cases (no more class=""!)tal:repeat uses Iterator class exactly the same way foreach() (fixes problem reported by Stas Dovgodko)repeat/…/length is read lazily,-' in external and dynamic macro names (bug spotted by Anton),tal:omit-tag executes condition only once,${…} syntax.Tomek Pęszor wrote nice tutorial on integration of PHPTAL with the Zend Framework and started repository of PHPTAL filters.
setCanonicalize(true) method of PHPTAL_GetTextTranslator enables old behaviour.PHPTAL_TranslationService now requires implementation of setEncoding() method. See manual.structure keyword in i18n:translate, which disables escaping of XML entities, allowing use of XHTML in translation strings.__call can now throw BadMethodCallException when they don't handle called method, allowing PHPTAL to handle this gracefully.tal:define “feature” that caused empty elements to be omitted.During August London Web Standards Meetup I've given presentation about PHPTAL.
The presentation is available for download in Apple Keynote and PDF formats.
<tal:block> element.tal:attributes and tal:define.__isset/__get (problem reported by Anru Chen)