Runtime
| Component | Requirement | Recommendation |
|---|---|---|
| PHP | 8.3 or newer | A currently supported PHP branch with security updates; WBAMS is tested on PHP 8.3, 8.4 and 8.5 |
| ionCube Loader | Version 15 or newer (15.5 or newer on PHP 8.5): WBAMS's own code is encoded with ionCube since 1.13.1 | The free ionCube Loader, switched on for the website's PHP. The installer and Update WBAMS check it and say what is missing before anything is changed |
| Database | MySQL-compatible, InnoDB | Dedicated database and user; strict mode disabled for the current installer |
| Web server | Apache or Nginx | HTTPS, URL rewriting, compression, and sensible static-asset caching. The protective rules WBAMS ships are an Apache .htaccess; on Nginx, write the equivalent refusals yourself |
| Scheduler | PHP CLI | See Set up the scheduler; do not expose scheduler scripts publicly |
| Memory | 64 MB minimum (the installer checks it) | 128 MB or more; 256 MB for reports, imports, updates, and large attachments |
PHP extensions
The installer verifies cURL with SSL, JSON, PDO, PDO MySQL, GD, XML, and Sodium. Sodium is required to authenticate signed license responses; a server without it must not proceed past preflight. WBAMS also benefits from OpenSSL, Mbstring, Intl, Fileinfo, and ZIP where available.
php -v
php -m
php -r "echo PHP_VERSION, PHP_EOL;"
Filesystem
The web-server user must be able to write to the configured compiled-template, attachment, download, and storage locations. Keep sensitive storage outside the public document root whenever practical. Never grant broad world-write permissions to the whole application tree.
OPcache
OPcache is recommended: pages load faster with it on. Keep PHP's opcache.validate_timestamps on (PHP's default), so PHP notices changed files and an update or a hotfix takes effect right away. With it off, the server keeps running the old copies of WBAMS's files until PHP restarts; since 1.13.4 the admin dashboard and System Health say so, and that is the only OPcache setting they warn about besides OPcache being off. On shared hosting, ask the hosting provider to change it. Disable CLI OPcache during maintenance and release validation if the environment shows stale code or CLI crashes.
php -d opcache.enable_cli=0 install/bin/installer.php --status
Network and DNS
- Resolve the public hostname to the WBAMS web server.
- Issue a valid TLS certificate and redirect HTTP to HTTPS.
- Allow outbound HTTPS for license verification, gateways, identity providers, analytics, and update metadata.
- Maintain a current CA certificate store; never work around a TLS failure by disabling certificate verification.
- Restrict database access to the application host or private network.
- Configure trusted proxy addresses before honoring forwarded client-IP headers.