Adventure-PHP-Framework Dokumentations-Seite

URL rewriting

Rank article:
This article has not yet been ranked. Vote this article first of all!

1. Introduction

The adventure php framework enables you, to operate web pages or applications in url rewrite mode or in normal mode. URL rewriting means, that URL params are separated by "/" instead of "&" and "=". This request layout pretends, that the requested ressource is located in a folder path. Another side effect is, that search engines tend to scan slash URLs more likely. Please note, that this technique does not supersede normal search engine optimization.

2. Configuration

If you use the URL rewrite mode, please be aware, that the bootstrap file (e.g. index.php) must be located in the DOCUMENT_ROOT of your webserver or any VHOST. Otherwise, the assignment of params and values can not be guaranteed.

2.1. Apache configuration

Using the URL rewrite mode a .htaccess file must be created. The following code box shows you an example, that can be used with the bigger part of your applications:

# start mod_rewrite
RewriteEngine on

# exclude some directories
RewriteCond %{REQUEST_URI} !^(\/frontend) [NC]

# define the rule itself. Every request that is not matching the exception list is
# redirected to the index.php file
RewriteRule !(index\.php|\.css|\.jpe?g|\.png|\.gif|\.ico)$ /index.php?query=%{REQUEST_URI}&%{QUERY_STRING} [NC,L]

Please note, that the definition

/index.php?query=%{REQUEST_URI}&%{QUERY_STRING}

must remain unaffected. It defines the param, that is used by the pagecontrollerRewriteRequestFilter and frontcontrollerRewriteRequestFilter to analyze the URL parameters and write them to the $_REQUEST-Array. The exception list

!(index\.php|\.css|\.jpe?g|\.png|\.gif|\.ico)$

can be manipulated as desired.

2.2. Framework configuration

To use the framework in URL rewriting mode it is necessary to switch the registry paramater URLRewriting in the apf::core namespace to true. This can be achieved by adding


   $Reg = &Singleton::getInstance('Registry');
   $Reg->register('apf::core','URLRewriting',true);

to your bootstrap file.

3. Usage of the URL rewriting

While using the URL rewriting mode, the following hints should be kept in mind:

Ressources like images, css files or java scripts must be addressed absolutely.
Modules, written for both modes must be aware of the two flavours. If you need to knwo about the current URL layout you can retrieve this information from the registry.
If you are using more than one bootstrap file, please add it to the exception list in the .htaccess file.

Comments

Do you want to add a comment to the article above, or do you want to post additional hints? So please click here. Comments already posted can be found below.

There are no comments belonging to this article.