Support Joomla!

Joomla! 1.5 Documentation

Packages

Package: Yadis

Developer Network License

The Joomla! Developer Network content is © copyright 2006 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution- NonCommercial- ShareAlike 2.5
Source code for file /openid/Services/Yadis/XRI.php

Documentation is available at XRI.php

  1. <?php
  2.  
  3. /**
  4.  * Routines for XRI resolution.
  5.  *
  6.  * @package Yadis
  7.  * @author JanRain, Inc. <[email protected]>
  8.  * @copyright 2005 Janrain, Inc.
  9.  * @license http://www.gnu.org/copyleft/lesser.html LGPL
  10.  */
  11.  
  12. require_once 'Services/Yadis/Misc.php';
  13. require_once 'Services/Yadis/Yadis.php';
  14. require_once 'Auth/OpenID.php';
  15.  
  16. $DEFAULT_PROXY = 'http://proxy.xri.net/';
  17. $XRI_AUTHORITIES = array('!', '=', '@', '+', '$', '(');
  18.  
  19. $parts = array();
  20. foreach (array_merge($__UCSCHAR, $__IPRIVATE) as $pair) {
  21.     list($m, $n) = $pair;
  22.     $parts[] = sprintf("%s-%s", chr($m), chr($n));
  23. }
  24.  
  25. $_escapeme_re = sprintf('/[%s]/', implode('', $parts));
  26. $_xref_re = '/\((.*?)\)/';
  27.  
  28. function Services_Yadis_identifierScheme($identifier)
  29. {
  30.     global $XRI_AUTHORITIES;
  31.  
  32.     if (_startswith($identifier, 'xri://') ||
  33.         (in_array($identifier[0], $XRI_AUTHORITIES))) {
  34.         return "XRI";
  35.     } else {
  36.         return "URI";
  37.     }
  38. }
  39.  
  40. function Services_Yadis_toIRINormal($xri)
  41. {
  42.     if (!_startswith($xri, 'xri://')) {
  43.         $xri = 'xri://' . $xri;
  44.     }
  45.  
  46.     return Services_Yadis_escapeForIRI($xri);
  47. }
  48.  
  49. function _escape_xref($xref_match)
  50. {
  51.     $xref = $xref_match[0];
  52.     $xref = str_replace('/', '%2F', $xref);
  53.     $xref = str_replace('?', '%3F', $xref);
  54.     $xref = str_replace('#', '%23', $xref);
  55.     return $xref;
  56. }
  57.  
  58. function Services_Yadis_escapeForIRI($xri)
  59. {
  60.     global $_xref_re;
  61.  
  62.     $xri = str_replace('%', '%25', $xri);
  63.     $xri = preg_replace_callback($_xref_re, '_escape_xref', $xri);
  64.     return $xri;
  65. }
  66.  
  67. function Services_Yadis_toURINormal($xri)
  68. {
  69.     return Services_Yadis_iriToURI(Services_Yadis_toIRINormal($xri));
  70. }
  71.  
  72. function Services_Yadis_iriToURI($iri)
  73. {
  74.     if (1) {
  75.         return $iri;
  76.     } else {
  77.         global $_escapeme_re;
  78.         // According to RFC 3987, section 3.1, "Mapping of IRIs to URIs"
  79.         return preg_replace_callback($_escapeme_re,
  80.                                      '_pct_escape_unicode', $iri);
  81.     }
  82. }
  83.  
  84.  
  85. function Services_Yadis_XRIAppendArgs($url, $args)
  86. {
  87.     // Append some arguments to an HTTP query.  Yes, this is just like
  88.     // OpenID's appendArgs, but with special seasoning for XRI
  89.     // queries.
  90.  
  91.     if (count($args) == 0) {
  92.         return $url;
  93.     }
  94.  
  95.     // Non-empty array; if it is an array of arrays, use multisort;
  96.     // otherwise use sort.
  97.     if (array_key_exists(0, $args) &&
  98.         is_array($args[0])) {
  99.         // Do nothing here.
  100.     } else {
  101.         $keys = array_keys($args);
  102.         sort($keys);
  103.         $new_args = array();
  104.         foreach ($keys as $key) {
  105.             $new_args[] = array($key, $args[$key]);
  106.         }
  107.         $args = $new_args;
  108.     }
  109.  
  110.     // According to XRI Resolution section "QXRI query parameters":
  111.     //
  112.     // "If the original QXRI had a null query component (only a
  113.     //  leading question mark), or a query component consisting of
  114.     //  only question marks, one additional leading question mark MUST
  115.     //  be added when adding any XRI resolution parameters."
  116.     if (strpos(rtrim($url, '?'), '?') !== false) {
  117.         $sep = '&';
  118.     } else {
  119.         $sep = '?';
  120.     }
  121.  
  122.     return $url . $sep . Auth_OpenID::httpBuildQuery($args);
  123. }
  124.  
  125. function Services_Yadis_providerIsAuthoritative($providerID, $canonicalID)
  126. {
  127.     $lastbang = strrpos($canonicalID, '!');
  128.     $p = substr($canonicalID, 0, $lastbang);
  129.     return $p == $providerID;
  130. }
  131.  
  132. function Services_Yadis_rootAuthority($xri)
  133. {
  134.     global $XRI_AUTHORITIES;
  135.  
  136.     // Return the root authority for an XRI.
  137.  
  138.     $root = null;
  139.  
  140.     if (_startswith($xri, 'xri://')) {
  141.         $xri = substr($xri, 6);
  142.     }
  143.  
  144.     $authority = explode('/', $xri, 2);
  145.     $authority = $authority[0];
  146.     if ($authority[0] == '(') {
  147.         // Cross-reference.
  148.         // XXX: This is incorrect if someone nests cross-references so
  149.         //   there is another close-paren in there.  Hopefully nobody
  150.         //   does that before we have a real xriparse function.
  151.         //   Hopefully nobody does that *ever*.
  152.         $root = substr($authority, 0, strpos($authority, ')') + 1);
  153.     } else if (in_array($authority[0], $XRI_AUTHORITIES)) {
  154.         // Other XRI reference.
  155.         $root = $authority[0];
  156.     } else {
  157.         // IRI reference.
  158.         $_segments = explode("!", $authority);
  159.         $segments = array();
  160.         foreach ($_segments as $s) {
  161.             $segments = array_merge($segments, explode("*", $s));
  162.         }
  163.         $root = $segments[0];
  164.     }
  165.  
  166.     return Services_Yadis_XRI($root);
  167. }
  168.  
  169. function Services_Yadis_XRI($xri)
  170. {
  171.     if (!_startswith($xri, 'xri://')) {
  172.         $xri = 'xri://' . $xri;
  173.     }
  174.     return $xri;
  175. }
  176.  
  177. function Services_Yadis_getCanonicalID($iname, $xrds)
  178. {
  179.     // Returns FALSE or a canonical ID value.
  180.  
  181.     // Now nodes are in reverse order.
  182.     $xrd_list = array_reverse($xrds->allXrdNodes);
  183.     $parser =& $xrds->parser;
  184.     $node = $xrd_list[0];
  185.  
  186.     $canonicalID_nodes = $parser->evalXPath('xrd:CanonicalID', $node);
  187.  
  188.     if (!$canonicalID_nodes) {
  189.         return false;
  190.     }
  191.  
  192.     $canonicalID = $canonicalID_nodes[count($canonicalID_nodes) - 1];
  193.     $canonicalID = Services_Yadis_XRI($parser->content($canonicalID));
  194.  
  195.     $childID = $canonicalID;
  196.  
  197.     for ($i = 1; $i < count($xrd_list); $i++) {
  198.         $xrd = $xrd_list[$i];
  199.  
  200.         $parent_sought = substr($childID, 0, strrpos($childID, '!'));
  201.         $parent_list = array();
  202.  
  203.         foreach ($parser->evalXPath('xrd:CanonicalID', $xrd) as $c) {
  204.             $parent_list[] = Services_Yadis_XRI($parser->content($c));
  205.         }
  206.  
  207.         if (!in_array($parent_sought, $parent_list)) {
  208.             // raise XRDSFraud.
  209.             return false;
  210.         }
  211.  
  212.         $childID = $parent_sought;
  213.     }
  214.  
  215.     $root = Services_Yadis_rootAuthority($iname);
  216.     if (!Services_Yadis_providerIsAuthoritative($root, $childID)) {
  217.         // raise XRDSFraud.
  218.         return false;
  219.     }
  220.  
  221.     return $canonicalID;
  222. }
  223.  
  224. ?>
Documentation generated on Mon, 05 Mar 2007 21:33:12 +0000 by phpDocumentor 1.3.1