Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version. Compare with Current  |   View Page History
New Proposal Template
This page has been created from a template that uses "zones." To proceed:
  1. Edit the page
  2. Replace sample content within each zone-data tag
  3. Remove this notice
  4. Save the page
  5. When you are ready for review, remove the Under Construction notice
Under Construction
This proposal is under construction and is not ready for review.

<ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA[

Zend Framework: Zend_xml2json Component Proposal

Proposed Component Name Zend_xml2json
Developer Notes
Proposers Senthil Nathan
Revision 0.1 - 23 April 2007: Initial proposal. (wiki revision: 8)

Table of Contents

1. Overview

This is a proposal to add a new feature to the Zend_Json module. This new feature will provide a conversion capability. Specifically, it will allow any arbitrary XML formatted document to be converted into JSON formatted string. The following paragraph forms the motivation for this proposal.

Since the late 1990s, many enterprise data architectures have been using XML. That choice made it a common practice for mid-tier (PHP and J2EE) servers to exchange enterprise data with the browser applications in XML format. However, current popularity of JSON makes it a credible data interchange format between browser applications and mid-tier servers. Combined with the rising adoption of Ajax in enterprise-grade applications, JSON is emerging as a natural choice for data encoding at both the client and middle tiers. The key reason being that there is no extra parsing required in the browser applications to interpret JSON formatted data. Because, JSON is readily consumable in browser applications as it follows the data syntax rules of JavaScript. In addition, JSON makes the job of the browser application developers a lot simpler by eliminating the need to deal with all the intricacies of XML.

As Web 2.0 technologies proliferate in large enterprises, it will become necessary for PHP-based mid-tier server applications to exchange enterprise application data with the browser applications in JSON format rather than in XML format. In order to achieve this, server-side PHP application developers have to convert XML-formatted data into JSON-formatted data before sending it to browser. In reality, it would be extremely beneficial to make this conversion as part of the Zend Framework. Hence, this proposal is made to add this simple, but powerful feature in the Zend_Json module.

2. References

3. Component Requirements, Constraints, and Acceptance Criteria

  • This component will require a new static function to be added to Json.php
  • This component *will not * require use of configuration files.
  • This component will add a new class to Zend_Json module.
  • Given a XML formatted string as input, this component will convert the entire XML content into JSON formatted string.
  • This component will keep the nested structure of the XML content intact in the resulting JSON data as well.
  • This component will also optionally convert the XML attributes present in the XML content into a corresponding representation in the resulting JSON data.

4. Dependencies on Other Framework Components

  • Zend_Json
  • Zend_Exception

5. Theory of Operation

A new class named xml2json.php will be added to the Zend_Json module. This file will have a class named Zend_xml2json that will expose a static function called convertXmlToJson. This function takes as input, a SimpleXMLElement object and a boolean value to indicate the need for including the XML attributes in the conversion process. By default, this function will ignore the XML attributes i.e. it will not do anything with the XML attributes during the conversion process. It recursively traverses the nested XML content structure and stores the visited XML contents into a PHP associative array structure. At the end of the XML tree traversal, it returns the PHP array with all the element/value pairs that were present in the XML input content. If needed, this function will also optionally store the XML attributes in the PHP array so that it can be represented in the final JSON data.

A new static function called xml2json will be added to Json.php. This is the function that users will call to convert any arbitrary XML content to JSON data. This function will take as input, a string containing XML formatted content and a boolean value to indicate the need for including the XML attributes in the conversion process. This function will then convert this input string value into SimpleXML. It will call the static function (convertXmlToJson) by passing the SimpleXmlElement and the boolean value as two function parameters. This will result in the SimpleXML object getting converted into a PHP array object. In the end, a call will be made to the encode function in the Zend_Json class to convert the PHP array object to JSON formatted string.

6. Milestones / Tasks

  • Milestone 1: [DONE] Publish this proposal.
  • Milestone 2: Revise proposal, approve for Incubator development.
  • Milestone 3: Commit working prototype to Incubator.
  • Milestone 4: Commit unit tests and documentation.
  • Milestone 5: Promote code from incubator to framework release.

7. Class Index

  • Zend_xml2json

8. Use Cases


... (see good use cases book)

9. Class Skeletons


Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.