Auth_Yadis_Discovery.html 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title>Docs For Class Auth_Yadis_Discovery</title>
  7. <link rel="stylesheet" href="../media/stylesheet.css" />
  8. <meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
  9. </head>
  10. <body>
  11. <div class="page-body">
  12. <h2 class="class-name">Class Auth_Yadis_Discovery</h2>
  13. <a name="sec-description"></a>
  14. <div class="info-box">
  15. <div class="info-box-title">Description</div>
  16. <div class="nav-bar">
  17. <span class="disabled">Description</span> |
  18. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  19. </div>
  20. <div class="info-box-body">
  21. <!-- ========== Info from phpDoc block ========= -->
  22. <p class="short-description">State management for discovery.</p>
  23. <p class="description"><p>High-level usage pattern is to call .getNextService(discover) in order to find the next available service for this user for this session. Once a request completes, call .cleanup() to clean up the session state.</p></p>
  24. <p class="notes">
  25. Located in <a class="field" href="_Auth---Yadis---Manager.php.html">/Auth/Yadis/Manager.php</a> (line <span class="field">369</span>)
  26. </p>
  27. <pre></pre>
  28. </div>
  29. </div>
  30. <a name="sec-method-summary"></a>
  31. <div class="info-box">
  32. <div class="info-box-title">Method Summary</span></div>
  33. <div class="nav-bar">
  34. <a href="#sec-description">Description</a> |
  35. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  36. </div>
  37. <div class="info-box-body">
  38. <div class="method-summary">
  39. <div class="method-definition">
  40. <span class="method-result">Auth_Yadis_Discovery</span>
  41. <a href="#Auth_Yadis_Discovery" title="details" class="method-name">Auth_Yadis_Discovery</a>
  42. (<span class="var-type"></span>&nbsp;<span class="var-name">&$session</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$url</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$session_key_suffix</span> = <span class="var-default">null</span>], <span class="var-type"><a href="../OpenID/Auth_Yadis_PHPSession.html">Auth_Yadis_PHPSession</a></span>&nbsp;<span class="var-name">$session</span>)
  43. </div>
  44. <div class="method-definition">
  45. <span class="method-result">void</span>
  46. <a href="#cleanup" title="details" class="method-name">cleanup</a>
  47. ([<span class="var-type">$force</span>&nbsp;<span class="var-name">$force</span> = <span class="var-default">false</span>])
  48. </div>
  49. <div class="method-definition">
  50. <span class="method-result">void</span>
  51. <a href="#getNextService" title="details" class="method-name">getNextService</a>
  52. (<span class="var-type"></span>&nbsp;<span class="var-name">$discover_cb</span>, <span class="var-type"></span>&nbsp;<span class="var-name">&$fetcher</span>)
  53. </div>
  54. </div>
  55. </div>
  56. </div>
  57. <a name="sec-methods"></a>
  58. <div class="info-box">
  59. <div class="info-box-title">Methods</div>
  60. <div class="nav-bar">
  61. <a href="#sec-description">Description</a> |
  62. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  63. </div>
  64. <div class="info-box-body">
  65. <A NAME='method_detail'></A>
  66. <a name="methodAuth_Yadis_Discovery" id="Auth_Yadis_Discovery"><!-- --></a>
  67. <div class="oddrow">
  68. <div class="method-header">
  69. <span class="method-title">Constructor Auth_Yadis_Discovery</span> (line <span class="line-number">390</span>)
  70. </div>
  71. <!-- ========== Info from phpDoc block ========= -->
  72. <p class="short-description">Initialize a discovery object.</p>
  73. <div class="method-signature">
  74. <span class="method-result">Auth_Yadis_Discovery</span>
  75. <span class="method-name">
  76. Auth_Yadis_Discovery
  77. </span>
  78. (<span class="var-type"></span>&nbsp;<span class="var-name">&$session</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$url</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$session_key_suffix</span> = <span class="var-default">null</span>], <span class="var-type"><a href="../OpenID/Auth_Yadis_PHPSession.html">Auth_Yadis_PHPSession</a></span>&nbsp;<span class="var-name">$session</span>)
  79. </div>
  80. <ul class="parameters">
  81. <li>
  82. <span class="var-type"><a href="../OpenID/Auth_Yadis_PHPSession.html">Auth_Yadis_PHPSession</a></span>
  83. <span class="var-name">$session</span><span class="var-description">: An object which implements the Auth_Yadis_PHPSession API.</span> </li>
  84. <li>
  85. <span class="var-type">string</span>
  86. <span class="var-name">$url</span><span class="var-description">: The URL on which to attempt discovery.</span> </li>
  87. <li>
  88. <span class="var-type">string</span>
  89. <span class="var-name">$session_key_suffix</span><span class="var-description">: The optional session key suffix override.</span> </li>
  90. <li>
  91. <span class="var-type"></span>
  92. <span class="var-name">&$session</span> </li>
  93. </ul>
  94. </div>
  95. <a name="methodcleanup" id="cleanup"><!-- --></a>
  96. <div class="evenrow">
  97. <div class="method-header">
  98. <span class="method-title">cleanup</span> (line <span class="line-number">441</span>)
  99. </div>
  100. <!-- ========== Info from phpDoc block ========= -->
  101. <p class="short-description">Clean up Yadis-related services in the session and return the most-recently-attempted service from the manager, if one exists.</p>
  102. <div class="method-signature">
  103. <span class="method-result">void</span>
  104. <span class="method-name">
  105. cleanup
  106. </span>
  107. ([<span class="var-type">$force</span>&nbsp;<span class="var-name">$force</span> = <span class="var-default">false</span>])
  108. </div>
  109. <ul class="parameters">
  110. <li>
  111. <span class="var-type">$force</span>
  112. <span class="var-name">$force</span><span class="var-description">: True if the manager should be deleted regardless of whether it's a manager for $this-&gt;url.</span> </li>
  113. </ul>
  114. </div>
  115. <a name="methodgetNextService" id="getNextService"><!-- --></a>
  116. <div class="oddrow">
  117. <div class="method-header">
  118. <span class="method-title">getNextService</span> (line <span class="line-number">408</span>)
  119. </div>
  120. <!-- ========== Info from phpDoc block ========= -->
  121. <p class="short-description">Return the next authentication service for the pair of user_input and session. This function handles fallback.</p>
  122. <div class="method-signature">
  123. <span class="method-result">void</span>
  124. <span class="method-name">
  125. getNextService
  126. </span>
  127. (<span class="var-type"></span>&nbsp;<span class="var-name">$discover_cb</span>, <span class="var-type"></span>&nbsp;<span class="var-name">&$fetcher</span>)
  128. </div>
  129. <ul class="parameters">
  130. <li>
  131. <span class="var-type"></span>
  132. <span class="var-name">$discover_cb</span> </li>
  133. <li>
  134. <span class="var-type"></span>
  135. <span class="var-name">&$fetcher</span> </li>
  136. </ul>
  137. </div>
  138. </div>
  139. </div>
  140. <p class="notes" id="credit">
  141. Documentation generated on Tue, 21 Apr 2009 11:31:31 -0700 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.3.2</a>
  142. </p>
  143. </div></body>
  144. </html>