Instalação PHP · 4 min read · Nov 25, 2025

Como Instalar o IonCube Loader no Debian 11

IonCube é uma extensão PHP que pode decodificar arquivos PHP criptografados e protegidos em tempo de execução. Fornecedores comerciais de programas PHP usam o codificador IonCube para proteger aplicativos, e o loader que instalamos neste tutorial é necessário para executar arquivos codificados com IonCube em seu servidor. O IoncubeLoader está disponível gratuitamente. O loader do Ioncube aumenta a velocidade de carregamento do seu site e impede que outros roubem o código-fonte, convertendo seu PHP em bytecode.

Neste tutorial, explicaremos a instalação do IonCube Loader no Debian 11.

Requisitos

  • Um servidor rodando Debian 11 com PHP (por exemplo, uma configuração LAMP ou LEMP instalada).
  • Um usuário não-root com privilégios sudo.

Começando

Antes de começar, atualize todos os pacotes instalados em seu servidor usando o seguinte comando:

sudo apt update -y  
sudo apt upgrade -y

Instalando o IonCube Loader

Primeiro, você precisará baixar a versão mais recente do IonCube Loader do site oficial deles. Você pode baixar o loader do IonCube para a pasta /tmp do sistema usando o seguinte comando:

cd /tmp  
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

Baixar IonCube loaders

Uma vez que o download esteja completo, extraia o arquivo baixado usando o seguinte comando:

tar -xvzf ioncube_loaders_lin_x86-64.tar.gz

Por padrão, os arquivos serão descompactados em uma pasta ioncube.

Agora, mude o diretório para a pasta ioncube e execute o comando ls para ver todas as extensões:

cd ioncube  
ls

Você deve ver os vários arquivos do loader ioncube correspondentes a várias versões do PHP, como abaixo:

Arquivos do loader IonCube

ioncube_loader_lin_4.1.so     ioncube_loader_lin_5.2.so     ioncube_loader_lin_7.0.so     ioncube_loader_lin_8.1.so  
ioncube_loader_lin_4.2.so     ioncube_loader_lin_5.2_ts.so  ioncube_loader_lin_7.0_ts.so  ioncube_loader_lin_8.1_ts.so  
ioncube_loader_lin_4.3.so     ioncube_loader_lin_5.3.so     ioncube_loader_lin_7.1.so     LICENSE.txt  
ioncube_loader_lin_4.3_ts.so  ioncube_loader_lin_5.3_ts.so  ioncube_loader_lin_7.1_ts.so  loader-wizard.php  
ioncube_loader_lin_4.4.so     ioncube_loader_lin_5.4.so     ioncube_loader_lin_7.2.so     README.txt  
ioncube_loader_lin_4.4_ts.so  ioncube_loader_lin_5.4_ts.so  ioncube_loader_lin_7.2_ts.so  USER-GUIDE.pdf  
ioncube_loader_lin_5.0.so     ioncube_loader_lin_5.5.so     ioncube_loader_lin_7.3.so     USER-GUIDE.txt  
ioncube_loader_lin_5.0_ts.so  ioncube_loader_lin_5.5_ts.so  ioncube_loader_lin_7.3_ts.so  
ioncube_loader_lin_5.1.so     ioncube_loader_lin_5.6.so     ioncube_loader_lin_7.4.so  
ioncube_loader_lin_5.1_ts.so  ioncube_loader_lin_5.6_ts.so  ioncube_loader_lin_7.4_ts.so 

Agora, você precisará selecionar o arquivo do loader ioncube correto de acordo com a versão do PHP instalada em seu servidor. Execute o seguinte comando para ver a versão do PHP instalada em seu servidor:

php -v

Saída:

Verificar versão do PHP

PHP 7.4.33 (cli) (built: Nov  8 2022 11:36:34) ( NTS )  
Copyright (c) The PHP Group  
Zend Engine v3.4.0, Copyright (c) Zend Technologies  
    with Zend OPcache v7.4.33, Copyright (c), by Zend Technologies 

Na saída acima, você deve ver que a versão do PHP instalada é PHP 7.4.33. Portanto, você precisará copiar o arquivo ioncube_loader_lin_7.4.so do diretório ioncube para o diretório de extensões do PHP.

Primeiro, encontre a localização do diretório de extensões do PHP usando o seguinte comando:

php -i | grep extension_dir

Você deve ver a seguinte saída:

extension_dir => /usr/lib/php/20190902 => /usr/lib/php/20190902 

Agora, copie o arquivo do loader ioncube para o diretório de extensões do PHP (/usr/lib/php/20151012) usando o seguinte comando:

cd ioncube  
cp ioncube_loader_lin_7.4.so /usr/lib/php/20190902/

Em seguida, você precisará editar o arquivo php.ini e adicionar o caminho da extensão ioncube. O arquivo que precisa ser editado depende da forma como você usa o PHP em seu sistema, as maneiras mais comuns são mod_php, PHP-FPM, PHP CGI e PHP CLI (PHP de linha de comando), abordarei todas elas abaixo. Se um arquivo não existir, então você não usa essa variante específica do PHP e pode pular para a próxima.

Apache mod_php

Você pode fazer isso com o seguinte comando:

sudo nano /etc/php/7.4/apache2/php.ini

Adicione a seguinte linha ao final do arquivo php.ini:

zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.so

Salve o arquivo.

Em seguida, reinicie o serviço Apache para aplicar as alterações:

sudo systemctl restart apache2

PHP-FPM

Você pode fazer isso com o seguinte comando:

sudo nano /etc/php/7.4/fpm/php.ini

Adicione a seguinte linha ao final do arquivo php.ini:

zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.so

Salve o arquivo.

Em seguida, reinicie o serviço PHP-FPM para aplicar as alterações:

sudo systemctl restart php7.4-fpm

PHP CGI

Você pode fazer isso com o seguinte comando:

sudo nano /etc/php/7.4/cgi/php.ini

Adicione a seguinte linha ao final do arquivo php.ini:

zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.so

Salve o arquivo.

Em seguida, reinicie o serviço Apache para aplicar as alterações:

sudo systemctl restart apache2

PHP CLI (PHP de linha de comando)

Você pode fazer isso com o seguinte comando:

sudo nano /etc/php/7.4/cli/php.ini

Adicione a seguinte linha ao final do arquivo php.ini:

zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.so

Salve o arquivo.

Nenhum serviço precisa ser reiniciado neste caso.

Testando o IonCube Loader

Agora, tudo está configurado corretamente. É hora de testar se o loader do Ioncube está instalado ou não. Você pode testá-lo usando o seguinte comando:

php -v

Se tudo estiver bem, você deve ver a seguinte saída:

PHP 7.4.33 (cli) (built: Nov  8 2022 11:36:34) ( NTS )  
Copyright (c) The PHP Group  
Zend Engine v3.4.0, Copyright (c) Zend Technologies  
    with the ionCube PHP Loader + ionCube24 v12.0.5, Copyright (c) 2002-2022, by ionCube Ltd.  
    with Zend OPcache v7.4.33, Copyright (c), by Zend Technologies

Como você pode ver na saída do comando “com o ionCube PHP Loader + ionCube24 v12.0.5”, adicionamos com sucesso o IoncubeLoader.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.