Cardix is a PHP application that runs on ordinary web hosting. Check these requirements before you install it. The setup page checks most of them for you and shows the result under Server check (see Install Cardix).
PHP version
| Requirement | Value |
|---|---|
| PHP | 7.4 or later; PHP 8.1 or later is recommended |
| Tested with | PHP 7.4 and PHP 8.5 |
| Database server | Not needed. Cardix keeps its data in files in its own folder |
| WordPress | Not needed. Cardix is a standalone application |
PHP extensions
The setup page lists every item as required or recommended.
| Server check item | Level | Why Cardix needs it |
|---|---|---|
| PHP version 7.4 or later | required | Cardix does not run on older PHP |
| JSON functions | required | Settings and data are stored as JSON files |
| Session support | required | Sign-in and private links use PHP sessions |
| ZipArchive (fonts and ready templates) | required | The fonts and the ready templates come as ZIP files inside the package |
| Package files | required | Every file of the install ZIP must be present and unchanged |
| mbstring extension | recommended | Without it, Turkish and Arabic text handling may be unreliable |
| OpenSSL extension | recommended | Without it, licence and security features may not work |
| ARN API access (cURL or allow_url_fopen) | recommended | Without it, the licence cannot be activated with ARN Smart |
| fileinfo extension (upload security) | recommended | Without it, uploaded files are checked less strictly |
| GD extension | recommended | Without it, card images cannot be created |
| FreeType (imagettftext) | recommended | Used by GD to draw text with TrueType fonts |
If a required item is missing, setup cannot continue. If only recommended items are missing, setup can still install in LIMITED mode, but the features listed above will not work. In practice, a working Cardix installation needs GD with FreeType to create card images and cURL or allow_url_fopen to activate the licence.
Optional: the intl extension
Events that repeat every year on a Hijri date (Umm al-Qura calendar) use the PHP intl extension to work out the date each year. Without intl, you enter the date of the next occurrence yourself and the panel reminds you when it is needed. See Schedule events with dates, yearly and Hijri events.
Web server
- Apache: Cardix protects its data folders with
.htaccessfiles. Make sure.htaccessfiles are allowed for the Cardix folder (AllowOverride All). - Nginx: Nginx does not read
.htaccessfiles. After installation, the admin panel checks from your browser whether the data folders are protected and, if they are not, shows two lines to add to the server configuration. See Install Cardix. - HTTPS: run Cardix on an HTTPS address, for example
https://cards.example.com/, and open the setup page over HTTPS.
Folder and file permissions
During installation, setup renames two folders of the package, creates the data folders and writes config.php, .htaccess files and a .user.ini file in the Cardix folder. The PHP user of your hosting must be able to write to the Cardix folder.
Where the hosting allows it, setup also sets these PHP limits for the Cardix folder (in .user.ini, and in .htaccess for Apache with mod_php):
| Setting | Value |
|---|---|
| upload_max_filesize | 32M |
| post_max_size | 40M |
| memory_limit | 256M |
| max_execution_time | 120 |
| max_input_time | 120 |
Browsers
Administrators and participants use Cardix in a web browser with JavaScript turned on. The text of every card is drawn in the browser.