Location: PHPKode > projects > PHP on Trax > johnpipi-trax-f599562/trax/doc/__filesource/fsource_PHPonTrax__vendortraxrouter.php.html
<html>
<head>
<title>File Source for router.php</title>
<link rel="stylesheet" type="text/css" href="../media/style.css">
</head>
<body>

<table border="0" cellspacing="0" cellpadding="0" height="48" width="100%">
  <tr>
    <td class="header_top">PHPonTrax</td>
  </tr>
  <tr><td class="header_line"><img src="../media/empty.png" width="1" height="1" border="0" alt=""  /></td></tr>
  <tr>
    <td class="header_menu">
  		  [ <a href="../classtrees_PHPonTrax.html" class="menu">class tree: PHPonTrax</a> ]
		  [ <a href="../elementindex_PHPonTrax.html" class="menu">index: PHPonTrax</a> ]
		  [ <a href="../elementindex.html" class="menu">all elements</a> ]
    </td>
  </tr>
  <tr><td class="header_line"><img src="../media/empty.png" width="1" height="1" border="0" alt=""  /></td></tr>
</table>

<table width="100%" border="0" cellpadding="0" cellspacing="0">
  <tr valign="top">
    <td width="200" class="menu">
	<div id="todolist">
			<p><a href="../todolist.html">Todo List</a></p>
	</div>
      <b>Packages:</b><br />
              <a href="../li_PHPonTrax.html">PHPonTrax</a><br />
              <a href="../li_PHPonTraxTest.html">PHPonTraxTest</a><br />
            <br /><br />
                  
                </td>
    <td>
      <table cellpadding="10" cellspacing="0" width="100%" border="0"><tr><td valign="top">

<h1 align="center">Source for file router.php</h1>
<p>Documentation is available at <a href="../PHPonTrax/_vendor_trax_router_php.html">router.php</a></p>
<div class="php">
<div class="listing"><pre><ol><li><a name="a1"></a><span class="src-php">&lt;?php</span></li>
<li><a name="a2"></a><span class="src-doc">/**</span></li>
<li><a name="a3"></a><span class="src-doc"> *  File containing the Router class</span></li>
<li><a name="a4"></a><span class="src-doc"> *</span></li>
<li><a name="a5"></a><span class="src-doc"> *  (PHP 5)</span></li>
<li><a name="a6"></a><span class="src-doc"> *</span></li>
<li><a name="a7"></a><span class="src-doc"> *  </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PHPonTrax</span></li>
<li><a name="a8"></a><span class="src-doc"> *  </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Id: router.php 174 2006-03-14 04:10:15Z haas $</span></li>
<li><a name="a9"></a><span class="src-doc"> *  </span><span class="src-doc-coretag">@copyright</span><span class="src-doc"> (c) 2005 John Peterson</span></li>
<li><a name="a10"></a><span class="src-doc"> *  </span></li>
<li><a name="a11"></a><span class="src-doc"> *   Permission is hereby granted, free of charge, to any person obtaining</span></li>
<li><a name="a12"></a><span class="src-doc"> *   a copy of this software and associated documentation files (the</span></li>
<li><a name="a13"></a><span class="src-doc"> *   &quot;Software&quot;), to deal in the Software without restriction, including</span></li>
<li><a name="a14"></a><span class="src-doc"> *   without limitation the rights to use, copy, modify, merge, publish,</span></li>
<li><a name="a15"></a><span class="src-doc"> *   distribute, sublicense, and/or sell copies of the Software, and to</span></li>
<li><a name="a16"></a><span class="src-doc"> *   permit persons to whom the Software is furnished to do so, subject to</span></li>
<li><a name="a17"></a><span class="src-doc"> *   the following conditions:</span></li>
<li><a name="a18"></a><span class="src-doc"> *</span></li>
<li><a name="a19"></a><span class="src-doc"> *   The above copyright notice and this permission notice shall be</span></li>
<li><a name="a20"></a><span class="src-doc"> *   included in all copies or substantial portions of the Software.</span></li>
<li><a name="a21"></a><span class="src-doc"> *</span></li>
<li><a name="a22"></a><span class="src-doc"> *   THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,</span></li>
<li><a name="a23"></a><span class="src-doc"> *   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF</span></li>
<li><a name="a24"></a><span class="src-doc"> *   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND</span></li>
<li><a name="a25"></a><span class="src-doc"> *   NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE</span></li>
<li><a name="a26"></a><span class="src-doc"> *   LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION</span></li>
<li><a name="a27"></a><span class="src-doc"> *   OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION</span></li>
<li><a name="a28"></a><span class="src-doc"> *   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</span></li>
<li><a name="a29"></a><span class="src-doc"> */</span></li>
<li><a name="a30"></a>&nbsp;</li>
<li><a name="a31"></a><span class="src-doc">/**</span></li>
<li><a name="a32"></a><span class="src-doc"> *  Convert a URL to an action</span></li>
<li><a name="a33"></a><span class="src-doc"> *  </span><span class="src-doc-coretag">@tutorial</span><span class="src-doc"> PHPonTrax/Router.cls</span></li>
<li><a name="a34"></a><span class="src-doc"> */</span></li>
<li><a name="a35"></a><span class="src-key">class </span><a href="../PHPonTrax/Router.html">Router</a> <span class="src-sym">{</span></li>
<li><a name="a36"></a>&nbsp;</li>
<li><a name="a37"></a>    <span class="src-doc">/**</span></li>
<li><a name="a38"></a><span class="src-doc">     *  Route table</span></li>
<li><a name="a39"></a><span class="src-doc">     *</span></li>
<li><a name="a40"></a><span class="src-doc">     *  For a description of the structure, see</span></li>
<li><a name="a41"></a><span class="src-doc">     *  </span><span class="src-doc-inlinetag">{@tutorial PHPonTrax/Router.cls#table the Router tutorial}</span><span class="src-doc">.</span></li>
<li><a name="a42"></a><span class="src-doc">     *  Routes are added by calling </span><span class="src-doc-inlinetag">{@link connect()}</span><span class="src-doc"> and looked up</span></li>
<li><a name="a43"></a><span class="src-doc">     *  by calling </span><span class="src-doc-inlinetag">{@link find_route()}</span><span class="src-doc">.</span></li>
<li><a name="a44"></a><span class="src-doc">     *  &lt;b&gt;FIXME:&lt;/b&gt; Should we have a Route class to describe an</span></li>
<li><a name="a45"></a><span class="src-doc">     *  entry in the route table?</span></li>
<li><a name="a46"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">string[][] </span></li>
<li><a name="a47"></a><span class="src-doc">     */</span></li>
<li><a name="a48"></a>    <span class="src-key">private </span><a href="../PHPonTrax/Router.html#var$routes">$routes</a> = <span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a49"></a>&nbsp;</li>
<li><a name="a50"></a>    <span class="src-doc">/**</span></li>
<li><a name="a51"></a><span class="src-doc">     *  Last route found by a call to find_route()</span></li>
<li><a name="a52"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">string[] </span></li>
<li><a name="a53"></a><span class="src-doc">     */</span></li>
<li><a name="a54"></a>    <span class="src-key">private </span><a href="../PHPonTrax/Router.html#var$selected_route">$selected_route</a> = <span class="src-id">null</span><span class="src-sym">;</span></li>
<li><a name="a55"></a>&nbsp;</li>
<li><a name="a56"></a>    <span class="src-doc">/**</span></li>
<li><a name="a57"></a><span class="src-doc">     *  Default route path</span></li>
<li><a name="a58"></a><span class="src-doc">     *</span></li>
<li><a name="a59"></a><span class="src-doc">     *  This route path is added to the route table if the table is</span></li>
<li><a name="a60"></a><span class="src-doc">     *  empty when find_route() is called.</span></li>
<li><a name="a61"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">string </span><span class="src-doc">constant</span></li>
<li><a name="a62"></a><span class="src-doc">     */</span></li>
<li><a name="a63"></a>    <span class="src-key">private </span><a href="../PHPonTrax/Router.html#var$default_route_path">$default_route_path</a> = <span class="src-str">&quot;:controller/:action/:id&quot;</span><span class="src-sym">;</span></li>
<li><a name="a64"></a>&nbsp;</li>
<li><a name="a65"></a>    <span class="src-doc">/**</span></li>
<li><a name="a66"></a><span class="src-doc">     *  Count of the number of elements in $routes</span></li>
<li><a name="a67"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">integer </span></li>
<li><a name="a68"></a><span class="src-doc">     */</span></li>
<li><a name="a69"></a>    <span class="src-key">public </span><a href="../PHPonTrax/Router.html#var$routes_count">$routes_count</a> = <span class="src-num">0</span><span class="src-sym">;</span></li>
<li><a name="a70"></a>&nbsp;</li>
<li><a name="a71"></a>    <span class="src-doc">/**</span></li>
<li><a name="a72"></a><span class="src-doc">     *  Accessor method to return contents of $selected_route</span></li>
<li><a name="a73"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string[] </span><span class="src-doc">Contents of $selected_route</span></li>
<li><a name="a74"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $selected_route</span></li>
<li><a name="a75"></a><span class="src-doc">     */</span></li>
<li><a name="a76"></a>    <span class="src-key">function </span><a href="../PHPonTrax/Router.html#methodget_selected_route">get_selected_route</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a77"></a>        <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$selected_route">selected_route</a><span class="src-sym">;</span></li>
<li><a name="a78"></a>    <span class="src-sym">}</span></li>
<li><a name="a79"></a>&nbsp;</li>
<li><a name="a80"></a>    <span class="src-doc">/**</span></li>
<li><a name="a81"></a><span class="src-doc">     *  Accessor method to add a route to the route table</span></li>
<li><a name="a82"></a><span class="src-doc">     *</span></li>
<li><a name="a83"></a><span class="src-doc">     *  The route is added to the end of</span></li>
<li><a name="a84"></a><span class="src-doc">     *  </span><span class="src-doc-inlinetag">{@link $routes the route table}</span><span class="src-doc">. If $params is not an array,</span></li>
<li><a name="a85"></a><span class="src-doc">     *  NULL is stored in the route parameter area.</span></li>
<li><a name="a86"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$path </span></li>
<li><a name="a87"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">mixed[] </span><span class="src-doc-var">$params </span></li>
<li><a name="a88"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $routes</span></li>
<li><a name="a89"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $routes_count</span></li>
<li><a name="a90"></a><span class="src-doc">     */</span></li>
<li><a name="a91"></a>    <span class="src-key">function </span><a href="../PHPonTrax/Router.html#methodconnect">connect</a><span class="src-sym">(</span><span class="src-var">$path</span><span class="src-sym">, </span><span class="src-var">$params </span>= <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a92"></a>        <span class="src-key">if</span><span class="src-sym">(</span><span class="src-sym">!</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$params</span><span class="src-sym">)) </span><span class="src-var">$params </span>= <span class="src-id">null</span><span class="src-sym">;</span></li>
<li><a name="a93"></a>        <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes">routes</a><span class="src-sym">[</span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes_count">routes_count</a><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'path'</span><span class="src-sym">] </span>= <span class="src-var">$path</span><span class="src-sym">;</span></li>
<li><a name="a94"></a>        <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes">routes</a><span class="src-sym">[</span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes_count">routes_count</a><span class="src-sym">]</span><span class="src-sym">[</span><span class="src-str">'params'</span><span class="src-sym">] </span>= <span class="src-var">$params</span><span class="src-sym">;</span></li>
<li><a name="a95"></a>        <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes_count">routes_count</a> = <a href="http://www.php.net/count">count</a><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes">routes</a><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a96"></a>    <span class="src-sym">}</span></li>
<li><a name="a97"></a>&nbsp;</li>
<li><a name="a98"></a>    <span class="src-doc">/**</span></li>
<li><a name="a99"></a><span class="src-doc">     *  Find first route in route table with path that matches argument</span></li>
<li><a name="a100"></a><span class="src-doc">     *</span></li>
<li><a name="a101"></a><span class="src-doc">     *  First, assure that the route table </span><span class="src-doc-inlinetag">{@link $routes}</span><span class="src-doc"> has at</span></li>
<li><a name="a102"></a><span class="src-doc">     *  least one route by adding</span></li>
<li><a name="a103"></a><span class="src-doc">     *  </span><span class="src-doc-inlinetag">{@link $default_route_path the default route}</span><span class="src-doc"> if the table is</span></li>
<li><a name="a104"></a><span class="src-doc">     *  empty.  Then search the table to find the first route in the</span></li>
<li><a name="a105"></a><span class="src-doc">     *  table whose path matches the argument $url. If $url is an</span></li>
<li><a name="a106"></a><span class="src-doc">     *  empty string, it matches a path that is an empty string.</span></li>
<li><a name="a107"></a><span class="src-doc">     *  Otherwise, try to match $url to the path part of the table</span></li>
<li><a name="a108"></a><span class="src-doc">     *  entry according to</span></li>
<li><a name="a109"></a><span class="src-doc">     *  </span><span class="src-doc-inlinetag">{@link http://www.php.net/manual/en/ref.pcre.php Perl regular expression}</span></li>
<li><a name="a110"></a><span class="src-doc">     *  rules.  If a matching route is found, return it any to the caller, and</span></li>
<li><a name="a111"></a><span class="src-doc">     *  also save a copy in </span><span class="src-doc-inlinetag">{@link $selected_route}</span><span class="src-doc">; if no matching</span></li>
<li><a name="a112"></a><span class="src-doc">     *  route is found return null.</span></li>
<li><a name="a113"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$url </span></li>
<li><a name="a114"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> build_route_regexp()</span></li>
<li><a name="a115"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $default_route_path</span></li>
<li><a name="a116"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $routes</span></li>
<li><a name="a117"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $routes_count</span></li>
<li><a name="a118"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@uses</span><span class="src-doc"> $selected_route</span></li>
<li><a name="a119"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">mixed </span><span class="src-doc">Matching route or null.  Path is in return['path'],</span></li>
<li><a name="a120"></a><span class="src-doc">     *                    params in return['params'],</span></li>
<li><a name="a121"></a><span class="src-doc">     */</span></li>
<li><a name="a122"></a>    <span class="src-key">function </span><a href="../PHPonTrax/Router.html#methodfind_route">find_route</a><span class="src-sym">(</span><span class="src-var">$url</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a123"></a>        <span class="src-comm">//error_log('url='.$url);</span></li>
<li><a name="a124"></a>        <span class="src-comm">// ensure at least one route (the default route) exists</span></li>
<li><a name="a125"></a>        <span class="src-key">if</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes_count">routes_count</a> == <span class="src-num">0</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a126"></a>            <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#methodconnect">connect</a><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$default_route_path">default_route_path</a><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a127"></a>        <span class="src-sym">}</span></li>
<li><a name="a128"></a>&nbsp;</li>
<li><a name="a129"></a>        <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$selected_route">selected_route</a> = <span class="src-id">null</span><span class="src-sym">;</span></li>
<li><a name="a130"></a>&nbsp;</li>
<li><a name="a131"></a>        <span class="src-key">foreach</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$routes">routes</a> <span class="src-key">as </span><span class="src-var">$route</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a132"></a>            unset<span class="src-sym">(</span><span class="src-var">$route_regexp</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a133"></a>            unset<span class="src-sym">(</span><span class="src-var">$reg_exp</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a134"></a>            <span class="src-var">$route_regexp </span>= <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#methodbuild_route_regexp">build_route_regexp</a><span class="src-sym">(</span><span class="src-var">$route</span><span class="src-sym">[</span><span class="src-str">'path'</span><span class="src-sym">]</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a135"></a>            <span class="src-comm">//error_log(&quot;route regexp=/$route_regexp/&quot;);</span></li>
<li><a name="a136"></a>            <span class="src-key">if</span><span class="src-sym">(</span><span class="src-var">$url </span>== <span class="src-str">&quot;&quot; </span>&amp;&amp; <span class="src-var">$route_regexp </span>== <span class="src-str">&quot;&quot;</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a137"></a>                <span class="src-comm">//error_log('selected');</span></li>
<li><a name="a138"></a>                <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$selected_route">selected_route</a> = <span class="src-var">$route</span><span class="src-sym">;</span></li>
<li><a name="a139"></a>                <span class="src-key">break</span><span class="src-sym">;</span></li>
<li><a name="a140"></a>            <span class="src-sym">} </span><span class="src-key">elseif</span><span class="src-sym">(</span><a href="http://www.php.net/preg_match">preg_match</a><span class="src-sym">(</span><span class="src-str">&quot;</span><span class="src-str">/<span class="src-var">$route_regexp</span>/</span><span class="src-str">&quot;</span><span class="src-sym">,</span><span class="src-var">$url</span><span class="src-sym">) </span>&amp;&amp; <span class="src-var">$route_regexp </span>!= <span class="src-str">&quot;&quot;</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a141"></a>                <span class="src-comm">//error_log('selected');</span></li>
<li><a name="a142"></a>                <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$selected_route">selected_route</a> = <span class="src-var">$route</span><span class="src-sym">;</span></li>
<li><a name="a143"></a>                <span class="src-key">break</span><span class="src-sym">;</span></li>
<li><a name="a144"></a>            <span class="src-sym">} </span><span class="src-key">elseif</span><span class="src-sym">(</span><span class="src-var">$route</span><span class="src-sym">[</span><span class="src-str">'path'</span><span class="src-sym">] </span>== <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$default_route_path">default_route_path</a><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a145"></a>                <span class="src-comm">//error_log('defaulted');</span></li>
<li><a name="a146"></a>                <span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$selected_route">selected_route</a> = <span class="src-var">$route</span><span class="src-sym">;</span></li>
<li><a name="a147"></a>                <span class="src-key">break</span><span class="src-sym">;</span></li>
<li><a name="a148"></a>            <span class="src-sym">}</span></li>
<li><a name="a149"></a>        <span class="src-sym">}</span></li>
<li><a name="a150"></a>        <span class="src-comm">//error_log('selected route='.var_export($this-&gt;selected_route,true));</span></li>
<li><a name="a151"></a>        <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-&gt;</span><a href="../PHPonTrax/Router.html#var$selected_route">selected_route</a><span class="src-sym">;</span></li>
<li><a name="a152"></a>    <span class="src-sym">}                                 </span><span class="src-comm">// function find_route($url)</span></li>
<li><a name="a153"></a>&nbsp;</li>
<li><a name="a153"></a>    </li>
<li><a name="a154"></a>    <span class="src-doc">/**</span></li>
<li><a name="a155"></a><span class="src-doc">     *  Build a regular expression that matches a route</span></li>
<li><a name="a156"></a><span class="src-doc">     *</span></li>
<li><a name="a157"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@todo</span><span class="src-doc"> &lt;b&gt;FIXME:&lt;/b&gt; Should this method be private?</span></li>
<li><a name="a158"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@todo</span><span class="src-doc"> &lt;b&gt;FIXME:&lt;/b&gt; Shouldn't the regexp match be the same as</span></li>
<li><a name="a159"></a><span class="src-doc">     *   for a PHP variable name? '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*'</span></li>
<li><a name="a160"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$route_path </span><span class="src-doc"> A route path.</span></li>
<li><a name="a161"></a><span class="src-doc">     *  </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span><span class="src-doc">Regular expression that matches the route in</span></li>
<li><a name="a162"></a><span class="src-doc">     *                 $route_path</span></li>
<li><a name="a163"></a><span class="src-doc">     */</span></li>
<li><a name="a164"></a>    <span class="src-key">function </span><a href="../PHPonTrax/Router.html#methodbuild_route_regexp">build_route_regexp</a><span class="src-sym">(</span><span class="src-var">$route_path</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a165"></a>        <span class="src-comm">//        echo &quot;entering build_route_regexp(), \$route_path is '$route_path'\n&quot;;</span></li>
<li><a name="a166"></a>&nbsp;</li>
<li><a name="a167"></a>        <span class="src-var">$route_regexp </span>= <span class="src-id">null</span><span class="src-sym">;</span></li>
<li><a name="a168"></a>&nbsp;</li>
<li><a name="a169"></a>        <span class="src-key">if</span><span class="src-sym">(</span><span class="src-sym">!</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$route_path</span><span class="src-sym">)) </span><span class="src-sym">{</span></li>
<li><a name="a170"></a>            <span class="src-var">$route_path </span>= <a href="http://www.php.net/explode">explode</a><span class="src-sym">(</span><span class="src-str">&quot;/&quot;</span><span class="src-sym">,</span><span class="src-var">$route_path</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li><a name="a171"></a>        <span class="src-sym">}</span></li>
<li><a name="a172"></a>        <span class="src-comm">//error_log(&quot;route path:\n&quot;.var_export($route_path,true));</span></li>
<li><a name="a173"></a>        <span class="src-key">if</span><span class="src-sym">(</span><a href="http://www.php.net/count">count</a><span class="src-sym">(</span><span class="src-var">$route_path</span><span class="src-sym">) </span>&gt; <span class="src-num">0</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a174"></a>            <span class="src-key">foreach</span><span class="src-sym">(</span><span class="src-var">$route_path </span><span class="src-key">as </span><span class="src-var">$path_element</span><span class="src-sym">) </span><span class="src-sym">{</span></li>
<li><a name="a175"></a>                <span class="src-key">if</span><span class="src-sym">(</span><a href="http://www.php.net/preg_match">preg_match</a><span class="src-sym">(</span><span class="src-str">'/:[a-z0-9_\-]+/'</span><span class="src-sym">,</span><span class="src-var">$path_element</span><span class="src-sym">)) </span><span class="src-sym">{</span></li>
<li><a name="a176"></a>                    <span class="src-var">$reg_exp</span><span class="src-sym">[</span><span class="src-sym">] </span>= <span class="src-str">'[a-z0-9_\-]+'</span><span class="src-sym">;</span></li>
<li><a name="a177"></a>                <span class="src-sym">} </span><span class="src-key">else </span><span class="src-sym">{</span></li>
<li><a name="a178"></a>                    <span class="src-var">$reg_exp</span><span class="src-sym">[</span><span class="src-sym">] </span>= <span class="src-var">$path_element</span><span class="src-sym">;</span></li>
<li><a name="a179"></a>                <span class="src-sym">}</span></li>
<li><a name="a180"></a>            <span class="src-sym">}</span></li>
<li><a name="a181"></a>            <span class="src-key">if</span><span class="src-sym">(</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$reg_exp</span><span class="src-sym">)) </span><span class="src-sym">{</span></li>
<li><a name="a182"></a>                <span class="src-var">$route_regexp </span>= <span class="src-str">&quot;^&quot;</span>.<a href="http://www.php.net/implode">implode</a><span class="src-sym">(</span><span class="src-str">&quot;\/&quot;</span><span class="src-sym">,</span><span class="src-var">$reg_exp</span><span class="src-sym">)</span>.<span class="src-str">&quot;</span><span class="src-str">$</span><span class="src-str">&quot;</span><span class="src-sym">;</span></li>
<li><a name="a183"></a>            <span class="src-sym">}</span></li>
<li><a name="a184"></a>        <span class="src-sym">}</span></li>
<li><a name="a185"></a>        <span class="src-key">return </span><span class="src-var">$route_regexp</span><span class="src-sym">;</span></li>
<li><a name="a186"></a>    <span class="src-sym">}</span></li>
<li><a name="a187"></a>&nbsp;</li>
<li><a name="a188"></a><span class="src-sym">}</span></li>
<li><a name="a189"></a>&nbsp;</li>
<li><a name="a190"></a><span class="src-comm">// -- set Emacs parameters --</span></li>
<li><a name="a191"></a><span class="src-comm">// Local variables:</span></li>
<li><a name="a192"></a><span class="src-comm">// tab-width: 4</span></li>
<li><a name="a193"></a><span class="src-comm">// c-basic-offset: 4</span></li>
<li><a name="a194"></a><span class="src-comm">// c-hanging-comment-ender-p: nil</span></li>
<li><a name="a195"></a><span class="src-comm">// indent-tabs-mode: nil</span></li>
<li><a name="a196"></a><span class="src-comm">// End:</span></li>
<li><a name="a197"></a><span class="src-php">?&gt;</span></li>
</ol></pre></div>
</div>
        <div class="credit">
		    <hr />
		    Documentation generated on Thu, 04 May 2006 19:47:52 -0600 by <a href="http://www.phpdoc.org">phpDocumentor 1.3.0RC4</a>
	      </div>
      </td></tr></table>
    </td>
  </tr>
</table>

</body>
</html>
Return current item: PHP on Trax