SlashpacheConfigFiles
SlashDocumentationIndex - parent These files are what tells Apache to be a slave to perl. Various apache functions are replaced by perl functions.
Notable things:
- Anything ending in .pl is to be interpreted as a perl script handled by Apache::Registry
- Apache is told Files ending in .tmpl are to be handled by Slash::Apache::TemplatePages
- A number of perl modules are added to every Apache process
- Database is set to mysql Slash::DB::MySQL
- AllowOverride None is set on htdocs so .htaccess files will never work, and could not anyway due to the access control phase being taken over.
- The virtual user and 'skin' are set. The code says 'skin' but this is actually a 'theme'
- A number of Apache 'phases' have perl code added to them, which in most cases means Apache uses the perl code rather thamn its own. Among these:
- First Apache phase: post-read-request
- Second Apache phase: URI translation - the index page handler and userdir handler completely replaced
- Fourth Apache phase: access control - Slash::Apache::Banlist, Slash::Apache::User
- Ninth Apache phase: response, aka content handler
- Eleventh Apache phase: cleanup- PerlCleanupHandler ,Slash::Apache::Log ,PerlCleanupHandler,Slash::Apache::Log::UserLog
- AddHandler server-parsed .shtml , AddHandler server-parsed .inc
Main Conf
Located in usr/local/slash/httpd/
This is what the install does to create slash.conf from the default: [root@slashcode httpd]# diff slash.conf.def slash.conf 37a38,39 > #Include /usr/local/slash/site/slashcode.local/slashcode.local.conf > Include /usr/local/slash/site/slashcott.org/slashcott.org.conf
contents of usr/local/slash/httpd/slash.conf :
# this is all the mod perl specific stuff that makes
# slash the root handler for the site
# ... you might want to check to make sure these are not already
# defined in your main httpd.conf, if you have trouble
# $Id$
AddHandler perl-script .pl
PerlHandler Apache::Registry
# For template pages
<FilesMatch "\.tmpl">
SetHandler perl-script
PerlHandler Slash::Apache::TemplatePages
</FilesMatch>
# add in modules for compiling into each process
PerlModule Slash
PerlModule Slash::Apache
PerlModule Slash::Apache::User
PerlModule Slash::Apache::Log
PerlModule Slash::Display::Plugin
PerlModule Slash::XML::RSS
# used in a couple of .pl files
PerlModule Image::Size
# add other, or comment out, DB modules here
PerlModule Slash::DB::MySQL
#PerlModule Slash::DB::PostgreSQL
# add or comment out plugin modules
#PerlModule Slash::Journal
#PerlModule Slash::Search
#PerlModule Slash::XML::FZ
LimitRequestBody 75000
#Include /usr/local/slash/site/slashcode.local/slashcode.local.conf
Include /usr/local/slash/site/slashcott.org/slashcott.org.conf
Site Conf
This is the site specific file included at the end of the file above. The name will vary by site.
Contents of /usr/local/slash/site/slashcott.org/slashcott.org.conf
# note that if your site's path is a symlink, the
# path listed here is most likely the actual path;
# fix it and DocumentRoot if you want to
<Directory /usr/local/slash/site/slashcott.org/htdocs>
Options FollowSymLinks ExecCGI Includes Indexes
AllowOverride None
</Directory>
<VirtualHost *:80>
ServerAdmin mcasadevall@slashcott.org
DocumentRoot /usr/local/slash/site/slashcott.org/htdocs
ServerName slashcott.org
ErrorLog logs/slashcott.org_error_log
CustomLog logs/slashcott.org_access_log common
PerlSetupEnv On
PerlSetEnv TZ GMT
SlashVirtualUser slash
SlashSetVar skin slashcode
# this directive will compile all the templates
# in the database, if cache_enabled is true
# and template_cache_size is 0. Set to On/Off.
# Default is off since most sites don't need it
# much and startup performance, as well as
# memory usage, degrades when it is On...
# setting template_cache_size to 100 or so is
# probably a lot better
SlashCompileTemplates Off
########################
# First Apache phase: post-read-request
# if you have a frontend/backend setup and have X-Forwarded-For
# headers (such as from mod_proxy_add_forward), use this
# to properly populate remote_ip for formkeys etc.
PerlPostReadRequestHandler Slash::Apache::ProxyRemoteAddr
# Second Apache phase: URI translation
# this directive will redirect non-logged-in users to
# index.shtml if they request the home page; turn it
# on to help increase performance or if you are using something
# other than index.pl for the index
PerlTransHandler Slash::Apache::IndexHandler
# this directive will display a user's pages at /~username
PerlTransHandler Slash::Apache::User::userdir_handler
# Third Apache phase: header parsing
# Fourth Apache phase: access control
PerlAccessHandler Slash::Apache::Banlist
PerlAccessHandler Slash::Apache::User
# Fifth Apache phase: authentication
# Sixth Apache phase: authorization
# Seventh Apache phase: MIME type checking
# Eighth Apache phase: fixups
# Ninth Apache phase: response, aka content handler:
# Apache::Registry and whatever else is in the slash.conf file
# Tenth Apache phase: logging
# Eleventh Apache phase: cleanup
PerlCleanupHandler Slash::Apache::Log
PerlCleanupHandler Slash::Apache::Log::UserLog
########################
# this can be used to preload your .pl scripts in the parent,
# saving both startup time and memory in the child
# add/remove scripts from @pls (normally best to include only
# and all commonly used scripts)
PerlModule Apache::RegistryLoader;
<Perl>
# if you need to debug, temporarily turn this on
# $Apache::Registry::Debug = 4;
my @pls = qw(index comments article users journal search ajax firehose);
my $vhost = 'slashcott.org';
my $docroot = '/usr/local/slash/site/slashcott.org/htdocs';
my $r = Apache::RegistryLoader->new;
for my $u (@pls) {
my $f = "$docroot/$u.pl";
$r->handler("/$u.pl", $f, $vhost) if -e $f;
}
</Perl>
DirectoryIndex index.pl index.shtml
ErrorDocument 404 /404.pl
AddType text/xml .xml
AddType application/rss+xml .rdf
AddType application/rss+xml .rss
AddType application/atom+xml .atom
AddType text/vnd.wap.wml .wml
# change default of "iso-8859-1" here (to, for example, utf-8)
# if you change "content_type_webpage" in vars, and vice versa
AddType text/html;charset=iso-8859-1 .shtml
AddHandler server-parsed .shtml
AddType text/html .inc
AddHandler server-parsed .inc
</VirtualHost>