ChurchCRM Application Platform Prerequisites

ChurchCRM has a few platform prerequisites, and a built-in mechanism to ensure that all prerequisites are met. If there are any unmet prerequisites, a message will be displayed during setup and a notification will be displayed during run time.

Prerequisites are validated at every page load, so if the hosting environment is changed to an incomplete / unsupported model, a notification will appear

Validation occurs in https://github.com/ChurchCRM/CRM/blob/master/src/ChurchCRM/Service/AppIntegrityService.php in the getApplicationPrerequisites() function.

Prerequisites

PHP 8.1+

Synopsis

ChurchCRM makes use of many features added with PHP 8.1. Lower versions will not work.

Symptoms of failure

• Errors and warnings about missing functions (especially random_bytes())
• As of ChurchCRM 3.3.0, the setup process will display a message indicating installation with anything below PHP 7.0 is not possible and will halt the installation.

Steps for Resolution

• Shared Hosting (CPanel)
  • Ensure that you have PHP 7.0 or higher selected for this site.
• Self-Hosted Linux:
  • Follow the steps at https://github.com/ChurchCRM/CRM/wiki/Install---Self-Hosted-Linux

PCRE and UTF-8 Support

Multibyte Encoding

PHP Phar

PHP Session

PHP XML

PHP EXIF

PHP iconv

Mcrypt

Mod Rewrite

GD Library for image manipulation

FileInfo Extension for image manipulation

cURL

locale gettext

Include/Config file is writeable

Images directory is writeable

PHP ZipArchive

Mysqli Functions