php-src/ext/simplexml
Nikita Popov 735bec4f40 Avoid uncollectable cycle in sxe_property_get_adr
The code was storing the created object in a property on the
created object, creating a trivial cycle. This cycle cannot be
collected (even if sxe->tmp is exposed via get_gc), because it
is never rooted (and we cannot safely manually root it).

Change the code to store the created object on the parent node
instead.

The only reason this is not showing up as a leak is that sxe->tmp
is dtor'ed in the dtor handler, which means that these objects
do get collected on shutdown -- but never earlier.
2016-07-16 23:43:24 +02:00
..
examples
tests Merge branch 'PHP-7.0' 2016-07-13 10:50:15 +08:00
config.m4 Merge branch 'PHP-5.5' 2013-08-06 11:09:12 -07:00
config.w32 improve searchability for libxml2 headers 2015-05-10 22:22:03 +02:00
CREDITS Fix writing of SQLite and SimpleXMl extension and add Rob to the credits 2004-03-28 20:27:18 +00:00
php_simplexml_exports.h Merge branch 'PHP-5.6' into PHP-7.0 2016-01-01 19:48:25 +02:00
php_simplexml.h Remove HAVE_SPL checks 2016-01-30 14:53:00 +01:00
README
simplexml.c Avoid uncollectable cycle in sxe_property_get_adr 2016-07-16 23:43:24 +02:00
sxe.c Fixed compilation warnings 2016-06-22 00:40:50 +03:00
sxe.h Merge branch 'PHP-5.6' into PHP-7.0 2016-01-01 19:48:25 +02:00

SimpleXML is meant to be an easy way to access XML data.

SimpleXML objects follow four basic rules:

1) properties denote element iterators
2) numeric indices denote elements
3) non numeric indices denote attributes
4) string conversion allows to access TEXT data

When iterating properties then the extension always iterates over
all nodes with that element name. Thus method children() must be 
called to iterate over subnodes. But also doing the following:
foreach ($obj->node_name as $elem) {
  // do something with $elem
}
always results in iteration of 'node_name' elements. So no further 
check is needed to distinguish the number of nodes of that type.

When an elements TEXT data is being accessed through a property
then the result does not include the TEXT data of subelements.

Known issues
============

Due to engine problems it is currently not possible to access
a subelement by index 0: $object->property[0].

TODO
====

At the moment property access to multiple elements of the same
name returns an array of SimpleXML objects. This should be an 
object of a new type instead so that all kinds of linkage,
assignment and deleting would work.