Extensions
section, push the Find More Extensions
button).
Foswiki 1.x installations must be configured before mod_perl is enabled
in Apache. Run configure before enabling mod_perl in Apache.
or else Apache will not start, reporting an error about a missing
lib/LocalSite.cfg
. You will need to: bin/configure
mod_perl
active.
Update config file
button and you'll get your config file.
In the web server configuration, you will need to load mod_perl
but it is also recommended to load the
Apache HTTP Request Library (module apreq).
If apreq
is not loaded, the following error may be encountered in certain situations, e.g., during login:
apache2: symbol lookup error: /usr/lib/perl5/auto/APR/Request/Apache2/Apache2.so: undefined symbol: apreq_handle_apache2
mod_perl
installation Engine
entry in the General execution environment
table.
mod_perl
is installed and enabled by checking
in configure's "Environment Variables" section. a sample:
SERVER_SIGNATURE | Apache/2.2.9 (Debian) mod_apreq2-20051231/2.6.0 mod_perl/2.0.4 Perl/v5.10.0 Server at 127.0.0.1 Port 2116 |
SERVER_SOFTWARE | Apache/2.2.9 (Debian) mod_apreq2-20051231/2.6.0 mod_perl/2.0.4 Perl/v5.10.0 |
apache2ctl
$ apache2ctl -M | grep perl_module perl_module (shared)If not found, enable mod_perl with
$ a2enmod mod_perl
mod_perl
can be very slow, so some configuration
changes are recommended.
Access the configure script. (On Foswiki 1.x, you will need to click the Yes, I've read all the documentation
button to show the expert settings.)
Go to Store Settings
: Store Implementation
: If using RCS, adjust to RcsLite
. (If using the PlainFile store, no change is needed.)
Search Algorithm
: use Foswiki::Store::SearchAlgorithms::PurePerl
or Foswiki:Extensions/NativeSearchContrib
mod_perl
configuration tuning mod_perl
limits the size of attachments to 64M by default. Set the
APREQ2_ReadLimit
to the maximum expected upload to permit larger
attachments.
Note that this should be kept in sync with the Foswiki ATTACHFILESIZELIMIT
,
set in Site Preferences, default taken from
Site Preferences.
<IfModule mod_perl.c> PerlSwitches -wT # DO NOT USE THIS with Foswiki 2.0 # mod_perl_startup.pl must exist, otherwise Apache will not start. PerlRequire "/var/www/foswiki/tools/mod_perl_startup.pl" APREQ2_ReadLimit 104857600 </IfModule>
restart
Apache in order for configuration changes take effect.
bin/configure
script is an exception and should be run as a plain CGI script. The required SetHandler cgi-script
should already be specified in the
in your Apache config or bin/.htaccess
file.
<FilesMatch "configure.*"> SetHandler cgi-script . . </FilesMatch>
bin/
directory, you may face problems as they were not designed to be executed under mod_perl
. You should configure them to be run as plain CGI scripts. You can replace Files
directive by FilesMatch and list all the exceptions.
<FilesMatch "[script name needing CGI].*"> SetHandler cgi-script . . </FilesMatch>
File | Description |
---|---|
tools/mod_perl_startup.pl |
Perl script |
lib/Foswiki/Engine/Apache2/MP20.pm |
Perl module |
lib/Foswiki/Engine/Apache2.pm |
Perl module |
lib/Foswiki/Engine/Apache/MP13.pm |
Perl module |
lib/Foswiki/Engine/Apache.pm |
Perl module |
lib/Foswiki/Contrib/ModPerlEngineContrib/DEPENDENCIES |
|
lib/Foswiki/Contrib/ModPerlEngineContrib.pm |
Perl module |
data/System/ModPerlEngineContrib.txt |
Documentation |
Change History: | ||||||||||
08 Dec 2017 (1.06) | Foswikitask:Item14544: SCRIPTURL breaks when X-FORWARDED-HOST has multiple values (partial fix). | |||||||||
30 Apr 2017 (1.05) | Foswikitask:Item14381: Preserver URL Encoding of the Foswiki URI. | |||||||||
26 Nov 2016 (1.04) | Released with Foswiki 2.1.3. Old Apache 1.x modules have been removed from the DEPENDENCIES file. | |||||||||
08 Apr 2016 (1.03) | Foswikitask:Item14022 Change foswiki.org links to https. | |||||||||
16 Jan 2016 (1.02) | Foswikitask:Item13926 Fix backwards compatibility with Foswiki 1.1. | |||||||||
20 Oct 2015 (1.01) | Released with Foswiki 2.0.3. Foswikitask:Item13830: Unable to upload utf-8 filenames as attachments. |
|||||||||
14 Jun 2015 (1.00) | Released with Foswiki 2.0. Foswikitask:Item13378: Foswikitask:Item13405: Update for UNICODE core Foswikitask:Item13228: Fix JSON operation with Apache Request 2 Foswikitask:Item13125: CGI updates Foswikitask:Item13225: Fix compatibility with Apache 2.4 Foswikitask:Item13052: Documentation improvements for APREQ2_ReadLimit Foswikitask:Item9139: Improve compatibility. |
|||||||||
03 Sep 2009 (0.9.2) | Improved documentation regarding module apreq | |||||||||
12 Apr 2009 (0.9.1) | Improved documentation | |||||||||
12 Jan 2009 (0.9.0) | Initial Release | |||||||||
Dependencies: |
|
Author | Foswiki:Main.GilmarSantosJr |
Version | 1.07 |
Release | 08 Dec 2017 |
Repository | https://github.com/foswiki/ModPerlEngineContrib |
Copyright | © 2009-2015 Gilmar Santos Jr and Foswiki Contributors |
License | GPL (Gnu General Public License) |
Home | https://foswiki.org/Extensions/ModPerlEngineContrib |
Support | https://foswiki.org/Support/ModPerlEngineContrib |