Contents 1 Needed Software 2 Getting the needed module from SVN 3 Setup of the Apache vHost for the Staging 4 Using the Staging

[edit] Needed Software

On the machine you use for this setup, you need to have installed a Linux/*BSD with a working Apache (1 or 2) with mod_php4. You will need at least the PHP4 modules pcre (for Perl compatible regular expressions) and xml (for the UTF-8 encoding). PHP5 is fine, too.

[edit] Getting the needed module from SVN

You need to checkout the www module from our SVN, it's located in /trunk. The www module will be the documentroot of your apache, therefor keep care that the apache process can read this dir.

[edit] Setup of the Apache vHost for the Staging

You need to setup a vHost for the staging, here an example to have some vHost for your localhost running on port 8080.

 # listen on this port, too (mostly in file "listen.conf")
 Listen 8080
 
 # staging vhost in a conf file
 <VirtualHost 127.0.0.1:8080>
     # set documentroot + 404 handler
     DocumentRoot <path_to_www>
     ErrorDocument 404 /media/404.php

     # depending on the default you might need to allow
     # access to the dir, so disable the following:
     #<Directory "<path_to_www>">
     #    Order allow,deny
     #    Allow from all
     #</Directory>

     # you might want to catch the logs in separate files:
     #ErrorLog /var/log/apache2/kde.org-error_log
     #CustomLog /var/log/apache2/kde.org-access_log combined

     # php part
     php_value short_open_tag Off
     php_value register_globals No
     php_value allow_url_fopen Off
     php_value disable_functions system,exec,passthru,proc_open,shell_exec,popen,symlink
 
     php_value safe_mode On
     php_value include_path ".:<path_to_www>/media/includes"
     
     # enable .php, add .html here, for developer.kde.org
     AddType application/x-httpd-php .php
 </VirtualHost>

[edit] Using the Staging

After restarting your Apache, you should have a running staging area on http://127.0.0.1:8080. You can now simply access and test all *.kde.org sites within this vhost. They all will behave like they are on their own domain, in their own vhost.

www.kde.org is now available under:

 http://127.0.0.1:8080/sites/www

pim.kde.org is now available under:

 http://127.0.0.1:8080/areas/pim