EasyApache Custom Modules

Custom Apache and PHP modules add features to the EasyApache system, and are accessible from both the command line and graphical WHM interfaces. These modules are compiled into Apache and/or PHP just like the modules provided with EasyApache.

Before you begin

You can find documentation for creating custom modules for your server in WHM at Main > Software > EasyApache (Apache Update) > Help > Cpanel::Easy Framework POD, or and via command line at /scripts/easyapache --perldoc.

You can download a few sample custom modules below. These modules are not likely to be included in EasyApache in the near future.

Important: If you have problems building Apache with your custom modules, and you are unable to troubleshoot the problem, run /scripts/easyapache --skip-custom-optmods to build Apache and PHP without any custom modules. (Or, access the WHM equivalent found in EasyApache's Help section).

Custom modules

Installing a custom module

To install a custom module:

1. Download and unzip it into /var/cpanel/easy/apache/custom_opt_mods/.
2. When logged into your server as root, you can install any module listed below by running the following commands. Be sure to replace $NAME.tar.gz with the filename of the module you wish to download:

wget http://easyapache.cpanel.net/optmods/$NAME.tar.gz
tar -C /var/cpanel/easy/apache/custom_opt_mods -xzf $NAME.tar.gz

Removing a custom module

In order to remove a custom module from the server, simply delete the files you created when you issued the above commands. The module will be removed from all future builds and the EasyApache interface.

Available modules

Warning: cPanel does not provide support for custom modules, including the ones linked below.

mod_auth_mysql — This module allows you to authenticate users and authorize access through a MySQL database. Supports Apache 1.3 and 2.0 only.

• Download: custom_opt_mod-mod_auth_mysql.tar.gz
• mod_auth_mysql project page.

mod_GeoIP — This module looks up the IP address of the client web user in the GeoIP database.

• Download: custom_opt_mod-mod_geoip.tar.gz
• mod_GeoIP project page

mod_wsgi — This module embeds the Python interpreter into Apache, for faster Python applications.

• Download the mod_wsgi module from code.google.com.

GD with JIS-mapped Japanese font support — This module provides JIS-mapped Japanese font support for the GD library under PHP5.

• Download: custom_opt_mod-php5-gd_jis_mapped_japanese_font_support.tar.gz

Turkish locale patch for PHP5 — This module improves PHP5 support for Turkish.

• Download: custom_opt_mod-php5-turkish_locale_patch.tar.gz

suPHP PAM patch — This module allows you to use limits ( /etc/security*.conf) with suPHP.

• Download: custom_opt_mod-suphp_pam_patch.tar.gz
• suPHP PAM patch information

mpm-itk — This module lets you run each virtual host with its own UID and GID.

• Download: MPMitk.tar.gz
• mpm-itk information

PHP4 — This module is provided for users who want to use PHP version 4.

• Download: custom_opt_mod-PHP449.tar.gz

Warning: PHP 4 is no longer supported in EasyApache 3.15 and above. See the cPanel press release for more information.