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 -yInstalando 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
Uma vez que o download esteja completo, extraia o arquivo baixado usando o seguinte comando:
tar -xvzf ioncube_loaders_lin_x86-64.tar.gzPor 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
lsVocê deve ver os vários arquivos do loader ioncube correspondentes a várias versões do PHP, como abaixo:

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 -vSaí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 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_dirVocê 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.iniAdicione a seguinte linha ao final do arquivo php.ini:
zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.soSalve o arquivo.
Em seguida, reinicie o serviço Apache para aplicar as alterações:
sudo systemctl restart apache2PHP-FPM
Você pode fazer isso com o seguinte comando:
sudo nano /etc/php/7.4/fpm/php.iniAdicione a seguinte linha ao final do arquivo php.ini:
zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.soSalve o arquivo.
Em seguida, reinicie o serviço PHP-FPM para aplicar as alterações:
sudo systemctl restart php7.4-fpmPHP CGI
Você pode fazer isso com o seguinte comando:
sudo nano /etc/php/7.4/cgi/php.iniAdicione a seguinte linha ao final do arquivo php.ini:
zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.soSalve o arquivo.
Em seguida, reinicie o serviço Apache para aplicar as alterações:
sudo systemctl restart apache2PHP CLI (PHP de linha de comando)
Você pode fazer isso com o seguinte comando:
sudo nano /etc/php/7.4/cli/php.iniAdicione a seguinte linha ao final do arquivo php.ini:
zend_extension=/usr/lib/php/20190902/ioncube_loader_lin_7.4.soSalve 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 -vSe 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 TechnologiesComo você pode ver na saída do comando “com o ionCube PHP Loader + ionCube24 v12.0.5”, adicionamos com sucesso o IoncubeLoader.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.