mirror of
https://github.com/php/web-php.git
synced 2026-03-24 15:22:19 +01:00
139 lines
4.7 KiB
PHP
139 lines
4.7 KiB
PHP
<?php
|
|
require_once 'prepend.inc';
|
|
|
|
$SIDEBAR_DATA='
|
|
<h3>URL examples</h3>
|
|
<p>
|
|
We have many kind of URL shortcuts. Here are some
|
|
examples you can try out:
|
|
<ul>
|
|
<li><a href="http://php.net/echo">http://php.net/echo</a></li>
|
|
<li><a href="http://php.net/it/echo">http://php.net/it/echo</a></li>
|
|
<li><a href="http://php.net/imap">http://php.net/imap</a></li>
|
|
<li><a href="http://php.net/downloads">http://php.net/downloads</a></li>
|
|
<li><a href="http://php.net/searchterm">http://php.net/searchterm</a></li>
|
|
</ul>
|
|
</p>
|
|
|
|
<h3>Quick reference tips</h3>
|
|
<p>
|
|
You can find <a href="tips.php">more
|
|
quick reference tips</a> on our site.
|
|
</p>
|
|
';
|
|
|
|
commonHeader("URL Howto");
|
|
|
|
?>
|
|
|
|
<h1>URL Howto</h1>
|
|
|
|
<p>
|
|
Among the many smart access methods to get to information quickly
|
|
on the PHP site, we decided to implement a system, where there
|
|
is even no need to write something inside a search box, you can
|
|
use short php.net URLs to access pages directly.
|
|
</p>
|
|
|
|
<p>
|
|
Note, that these shortcuts are expected to work on all mirror
|
|
sites, not just at the main site. If you find that some of these
|
|
shortcuts are not working on your mirror site, please report them
|
|
as a "PHP.net Website Problem" at
|
|
<a href="http://bugs.php.net/">http://bugs.php.net/</a>.
|
|
</p>
|
|
|
|
<p>
|
|
There are currently three types of URLs you can use this way.
|
|
For the examples, we'll use the main site URL.
|
|
</p>
|
|
|
|
<h2>Page shortcuts</h2>
|
|
|
|
<p>
|
|
If you write in a php.net URL, like <tt>http://php.net/links</tt>,
|
|
first this URL is matched against the php.net pages. If there is
|
|
a page named <tt>links.php</tt>, then you'll get that page
|
|
immediately. This type of shortcut makes easy to type in a link
|
|
in an IRC conversation or mailing list message. If the script
|
|
finds no page with this name, it tries to find a manual page.
|
|
</p>
|
|
|
|
<h2>Manual shortcuts</h2>
|
|
|
|
<p>
|
|
If your URL can't be matched with a page name, a manual page
|
|
is searched for your query. This is the case for the
|
|
<tt>http://php.net/preg_match</tt> URL. The following pages
|
|
are searched for in the manual:
|
|
<ul>
|
|
<li>Chapter pages, like <tt>http://php.net/installation</tt></li>
|
|
<li>Reference pages, like <tt>http://php.net/imap</tt></li>
|
|
<li>Function pages, like <tt>http://php.net/join</tt></li>
|
|
<li>Class pages, like <tt>http://php.net/dir</tt></li>
|
|
<li>Feature pages, like <tt>http://php.net/safe_mode</tt></li>
|
|
<li>Control structure pages, like <tt>http://php.net/while</tt></li>
|
|
<li>Other language pages, like <tt>http://php.net/oop</tt></li>
|
|
</ul>
|
|
</p>
|
|
|
|
<p>
|
|
This kind of URL will bring up the manual page in the mirror's
|
|
default manual language. This is English for the main site,
|
|
but can be a wide range of languages, depending of the mirror's
|
|
setup. You can see the list of languages used by mirrors at
|
|
<a href="http://php.net/mirrors">http://php.net/mirrors</a>.
|
|
This way if you would like to get an Italian manual page for
|
|
your queries, you can type <tt>http://it.php.net/echo</tt>.
|
|
</p>
|
|
|
|
<p>
|
|
There is another method though for accessing the manual page
|
|
in your preferred language. You can embed the language in the
|
|
URL before the manual search term. <tt>http://php.net/hu/echo</tt>
|
|
will bring up the Hungarian manual page for echo for example.
|
|
</p>
|
|
|
|
<h2>Search shortcuts</h2>
|
|
|
|
<p>
|
|
At last, if there is no PHP page, and there is no manual
|
|
page matching your query, a search is issued on the site with
|
|
the query you typed into the URL. An example of this kind
|
|
of URL is <tt>http://php.net/search_for_this</tt>.
|
|
</p>
|
|
|
|
<h2>Even smarter tricks</h2>
|
|
|
|
<p>
|
|
We also have shortcut aliases to access some resources more quickly,
|
|
and with a nice URL. Aliases are translated to their relevant shortcuts
|
|
before the first step (PHP page search) mentioned above. Some examples
|
|
of shortcut aliases: <tt>http://php.net/whatisphp</tt>,
|
|
<tt>http://php.net/php4news</tt>. The latter is an external page alias,
|
|
as it points to a file on the CVS server, containing information about
|
|
changes in PHP.
|
|
</p>
|
|
|
|
<h1>Get it on your site</h1>
|
|
|
|
<p>
|
|
What enables PHP.net to have this feature is a combination of a
|
|
custom ".htaccess" file, which redirects the browser to another page
|
|
in case of an "Error 401/3/4" and a little search page that looks up
|
|
page names or functions names in the manual corresponding to what
|
|
you searched for in <tt>http://php.net/search_for_this</tt>.
|
|
</p>
|
|
|
|
<p>
|
|
Everything behind this feature is available here:
|
|
<ul>
|
|
<li><a href="http://cvs.php.net/co.php/phpweb/.htaccess">http://cvs.php.net/co.php/phpweb/.htaccess</a></li>
|
|
<li><a href="http://cvs.php.net/co.php/phpweb/error/index.php">http://cvs.php.net/co.php/phpweb/error/index.php</a></li>
|
|
<li><a href="http://cvs.php.net/co.php/phpweb/include/manual-lookup.inc">http://cvs.php.net/co.php/phpweb/include/manual-lookup.inc</a></li>
|
|
<li><a href="http://cvs.php.net/co.php/phpweb/search.php">http://cvs.php.net/co.php/phpweb/search.php</a></li>
|
|
</ul>
|
|
</p>
|
|
|
|
<?php commonFooter(); ?>
|