Become a Patron!

My Amazon wishlist can be found here.

Life Line

Contributing Advent 1: Xdebug and hidden properties

Today starts the "contributing advent" with a nice bug from Xdebug. I can't possibly be fixing an issue every day, so I've started a while earlier.

This first contribution is for bug #987: "Hidden property names not shown". In PHP it is possible to convert an array to an object with:

<?php
$a = (object) [ "hello", 4 => "mr.", -8 => "elephpant" ];
var_dump( $a );
?>

Xdebug's standard HTML var_dump() as well as the CLI, the coloured CLI and the debugger interface DBGp all suffered from the same issues that numerical properties were not showing in output. For example the above would show:

class stdClass#1 (3) {
        string(5) "hello"
        string(3) "mr."
        string(9) "elephpant"
}

After the committed fix, it now shows:

class stdClass#1 (3) {
  public ${0} =>
  string(5) "hello"
  public ${4} =>
  string(3) "mr."
  public ${-8} =>
  string(9) "elephpant"
}

As you can see, it uses {…} to show it is a special property.

The debugger interface allows properties to be retrieved through the property_get command. This command returns an XML document that looks like:

<response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" command="property_get" transaction_id="4">
        <property name="$o" fullname="$o" address="" type="object" classname="stdClass" children="1" numchildren="6" page="0" pagesize="32">
                <property name="key" fullname="$o-&gt;key" facet="public" address="" type="string" size="5" encoding="base64">
                        <![CDATA[dmFsdWU=]]>
                </property>
                <property name="1" fullname="$o-&gt;1" facet="public" address="" type="int">
                        <![CDATA[0]]>
                </property>
        </property>
</response>

With the fullname property ($o->1) an IDE can then make further requests to dive into the property information, with:

property_get -i 42 -n $o->1

Initially that did not work, and I thought I had to extend the parser with additional rules to differentiate between an associative key and a numerical key. I came up with using $o->{1} as in the var_dump() output from above, and then using a special case to fetch a numerical property with zend_hash_index_find() and the integer value in between { and } instead of the zend_hash_find() that I normally use. An hour later I had implemented this and then came to the conclusion that I could just use zend_symtable_find() — which handles both numerical indexes as strings as well as associate indexes as strings, greatly simplifying the implementation. The change for the debugging interface was not more than: https://github.com/xdebug/xdebug/commit/4d8d5b7092f134e6e5a51a0ea2e6932930a29da9#diff-07a70c2afd727f925169e8b30f1c72dcL455

After adding six test cases, the issues is now resolved.

Shortlink

This article has a short URL available: https://drck.me/adv1301-aen

Comments

No comments yet

Add Comment

Name:
Email:

Will not be posted. Please leave empty instead of filling in garbage though!
Comment:

Please follow the reStructured Text format. Do not use the comment form to report issues in software, use the relevant issue tracker. I will not answer them here.


All comments are moderated