Unlike others, we're more than happy to support any of your customers if there is a specific need. We do expect our customers to create adequate documentation and to have a level of understanding in terms of installing the loaders for their PHP application, but we're very happy to support your customers if the need arises.

The recent version 13 of SourceGuardian includes GUI that we reworked with Qt5. That was a serious change and Qt5 apps depend on much more shared libraries. GUI for Linux was build on Debian 10 and must work on it and newer releases of Debian or Ubuntu. It must also work on other modern Linux distros. Sorry, but we did not get a chance to test GUI on other Linux distros or older versions.

 

If SourceGuardian GUI does not start on your Linux, it's very likely that your system is missing some of the required shared libs. In this case, you may use two commands below to try to know what libs are missed and then either email us or try to install them.  Run Terminal app and cd to SourceGuardian installation folder:

 

> ldd ./SourceGuardian | grep "not found"

 

if the above command produces no results, try this:

 

> QT_DEBUG_PLUGINS=1 ./SourceGuardian

 

If any shared libs are missed, you may read about it in the console. Please let us know and we can add them to the application package. 

 

If you need a quick solution for running GUI, you may also try this and install Qt5. (package name and package manager may differ on your Linux)

 

sudo apt-get install qt5-default

 

And finally you may download the CLI version of SourceGuardian which has much less shared libs dependencies or use the CLI version included within GUI in the "bin" subfolder.

 

Below is a quick update to this FAQ which may help.

If you are not using Ubuntu or Debian or they are not the recent, libcurl4 may be missed. You will see it's missed by running ldd on the executable as described above. If this is the case, please install libcurl4

 

Ubuntu/Debian: sudo apt-get install libcurl4

CentOS: sudo yum install libcurl

 

All the Qt5 shared libs are included and you may find them in the "lib" subfolder within the installation folder. But if you are getting a message about missed libQt5Core etc, it means your OS is ignoring relative paths to the shared libs as they are set within the executable. In this case you may try running the encoder GUI with the following command or modify RUNME.sh or create your own shell script:

cd /path/to/sourceguardian/folder

LD_LIBRARY_PATH=/path/to/sourceguardian/folder/lib ./SourceGuardian  

 

(please change the path to the actual path where the application is installed)

 

If you are getting a problem encoding for PHP 8 or 8.1 on WIndows and getting an error about  'VCRUNTIME140.dll', it means the Microsoft VC Redistributable packages are not installed on your machine or outdated. This package is included with SourceGuardian and is installed by default but there may be version check issues etc which made it not installed or not updated. 

 

PHP Warning: 'C:\WINDOWS\SYSTEM32\VCRUNTIME140.dll' 14.13 is not compatible with this PHP build linked with 14.28 in Unknown on line 0

In this case please download the VC Redistributable installer from Microsoft. Use the links on the top of the page which mention Visual Studio 2017. You need to download and install the 32-bit version regardless if your windows is 32 or 64-bit. 

 

vc_redist.x86.exe

https://docs.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170

 

this is a direct download link (if it does not work, use the link above)

 

 

After installing, reboot and then start SourceGuardian and try encoding again.

 

Linux shared libraries dependencies:

 

- Linux CLI encoder and tools include custom libcurl and do not depend on the system one

 

- Linux CLI encoder min GLIBC version is 2.17 (except PHP 5.3 encoder, was 2.27 for all). It means the CLI encoder may run on older Linux systems like CentOS 7 and many others. Automatic registration is available for the CLI version on the first run of the CLI 'sourceguardian' executable. Note: PHP 5.3 encoder still depends on GLIBC 2.27, but you may exclude encoding for it with --phpversion 5.4+ command line option or change to a higher version.

 

- Linux GUI still requires newer Linux with GLIBC 2.27+ It's built on Debian 10 and tested on Debian 10 and Ubuntu with Gnome and Cinnamon desktop IDE. If you use another Linux, GUI may work if all the shared libraries dependencies are resolved. In case GUI does not work, you may use the CLI version on Linux.

 

- if you have libwebp.so.6 error, try this:

 The GLIBC requirements for Linux loaders:

 

- for x64 is GLIBC_2.14

- for aarch64 is GLIBC_2.17

 

 MSVCR90.DLL is required PHP < 7.2 encoders. This lib is missed in new Windows. Install from Microsoft.