When using the PHP.net website, there is even no need to get to a search box to access the content you would like to see quickly. You can use short PHP.net URLs to access pages directly.
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 http://bugs.php.net/.
There are currently three types of URLs you can use this way.
If you write in a PHP.net URL, like http://ca3.php.net/get-involved, first this URL is matched against the PHP.net pages. If there is a page named get-involved.php, 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.
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 http://ca3.php.net/preg_match URL. The following pages are searched for in the manual:
- Chapter pages, like http://ca3.php.net/installation
- Reference pages, like http://ca3.php.net/imap
- Function pages, like http://ca3.php.net/join
- Class pages, like http://ca3.php.net/dir
- Feature pages, like http://ca3.php.net/safe_mode
- Control structure pages, like http://ca3.php.net/while
- Other language pages, like http://ca3.php.net/oop
Since there are several manual pages that could potentionally match the query (extension, class, function name..) you are encouraged to use their prefix/suffix:
- Extension TOC: http://ca3.php.net/book.extname (ex: http://ca3.php.net/book.dom).
- Extension intro pages: http://ca3.php.net/intro.extname (ex: http://ca3.php.net/intro.array).
- Extension setup TOC: http://ca3.php.net/extname.setup (ex: http://ca3.php.net/intl.setup).
- Extension install chapter: http://ca3.php.net/extname.installation (ex: http://ca3.php.net/apc.installation).
- Extension configuration: http://ca3.php.net/extname.configuration (ex: http://ca3.php.net/session.configuration).
- Extension resources: http://ca3.php.net/extname.resources (ex: http://ca3.php.net/mysql.resources).
- Extension constants: http://ca3.php.net/extname.constants (ex: http://ca3.php.net/image.constants).
- Class synopsis: http://ca3.php.net/class.classname (ex: http://ca3.php.net/class.xmlreader).
- Class method: http://ca3.php.net/classname.methodname (ex: http://ca3.php.net/pdo.query).
- Functions: http://ca3.php.net/function.functionname (ex: http://ca3.php.net/function.strpos).
This kind of URL will bring up the manual page in your preferred language. You can always override this setting by explicitly providing the language you want to get to. You can embed the language in the URL before the manual search term. http://ca3.php.net/hu/sort will bring up the Hungarian manual page for sort() for example.
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 http://ca3.php.net/search_for_this. The exact behaviour of this search is affected by your own My PHP.net settings.
PHP Developer shortcuts
- Snap downloads: http://snaps.php.net/?53 (ex: latest 5.3 snap. Use ?trunk or ?latest for latest trunk)
- Changelog information: http://php.net/changelog (ex: latest PHP changelog. php5news = latest PHP 5 NEWS, phptrunknews = latest PHP trunk NEWS)
- Bugs: http://php.net/42 (any numeric value redirects to said bug # at bugs.php.net)
- reST based README info: http://php.net/reST/ (lists several README files)
Even smarter tricks
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: http://ca3.php.net/whatisphp, http://ca3.php.net/php4news. The latter is an external page alias, as it points to a file on the Git server, containing information about changes in PHP. There are also some convenient aliases, like http://ca3.php.net/de/phpversion which displays the German manual page for the phpversion() function.
Get it on your site
What enables PHP.net to have this feature is a combination of some ErrorDocument Apache settings, redirecting the browser to another page in case of an "Error 401/3/4" and a little search script that looks up page names or functions names in the manual corresponding to what you searched for in http://ca3.php.net/search_for_this. We also have a general language selection method.
Everything behind this feature is available here: