The core code of Sanplex's commercial editions (Standard, Premium, and Enterprise) is encrypted, though the frontend HTML, CSS, JS, configurations, and language items remain open-source. The encryption software used is ionCube. Therefore, to run the commercial editions of Sanplex, you must first install the ionCube extension. If you deployed Sanplex using the one-click installation package, the ionCube extension is already included by default.

1. Download loader-wizard.php (Supports PHP 7.0, 7.1, 7.2, 7.4)

ionCube provides a setup wizard that conveniently detects your PHP runtime environment and automatically generates tailored installation instructions.

Download the loader-wizard from the official site:

https://www.ioncube.com/loader-wizard/loader-wizard.zip

After downloading, extract the file into your Apache www or htdocs directory. For example, see the placeholder below, or place it at: sanplex\www\loader-wizard.php

图1

2. Run the loader-wizard.php Program

Open your browser and access loader-wizard.php. For example: http://localhost/loader-wizard.php. Please modify the actual access path based on your environment.

图2

The loader program will automatically assess your environment and provide specific instructions. (The image below is just an example; please follow the actual interface displayed on your screen):

图3

Follow the wizard's instructions to download the appropriate loader software for your system and place it in the specified directory.

The wizard will also generate a new php.ini file. Use it to replace your system's original php.ini file.

Note: If the wizard prompts you to download a file starting with 00-ioncube and place it in a specific directory, you can instead open this downloaded file, copy its code, and paste it directly into the very first line of your current php.ini file. Save the php.ini file, and you won't need to copy the 00-ioncube file to the server.

Once configured, restart your web server. If you are using Nginx, you will also need to restart the php-fpm service.

3. Verify the Installation

After restarting the server, access loader-wizard.php again in your browser. If the installation is successful, the system will show a confirmation message.

图4

Seeing this interface indicates that the ionCube loader has been successfully installed.

4. macOS Installation Notes (Resolving "operation not permitted")

When using macOS, placing the downloaded loader into designated system directories might trigger an "operation not permitted" error.

How to resolve:

Normally, downloaded files or newly created projects in macOS default to a read-only state. A simple permission command usually solves this:

Bash

sudo chmod -R 777 <path_to_the_parent_directory> 

However, when modifying system directories like usr/bin, the "operation not permitted" error often persists. This is because macOS uses System Integrity Protection (SIP) (the "rootless" mechanism), which prevents modifying certain system files even with root access. To modify these files, you must temporarily disable this protection.

• Restart your Mac and hold down Command + R during startup to enter Recovery Mode. Open the Terminal from the Utilities menu and enter:

  Bash

  csrutil disable 

• Restart your Mac again. You can now modify files in system directories like usr/bin.

PS: To restore the protection mechanism after you finish your setup, re-enter Recovery Mode, open the Terminal, and enter: csrutil enable