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

Como instalar o Ioncube Loader no CentOS, Debian e Ubuntu

O Ioncube loader é um módulo PHP para carregar arquivos que foram protegidos com o software Ioncube Encoder. O Ioncube é frequentemente usado por fornecedores de software PHP comerciais para proteger seu software, portanto, é provável que você encontre um arquivo codificado em Ioncube mais cedo ou mais tarde ao instalar extensões para software de CMS ou de loja escrito em PHP. Neste tutorial, explicarei a instalação do módulo Ioncube loader em detalhes para CentOS, Debian e Ubuntu.

1 Pré-requisitos

Seu servidor deve ter a linguagem de programação PHP instalada. Usarei o editor de linha de comando Nano e o aplicativo de download de linha de comando wget. Nano e Wget estão instalados na maioria dos servidores; caso estejam faltando em seu servidor, instale-os com apt / yum:

CentOS

yum install nano wget

Debian e Ubuntu

apt-get install nano wget

2 Baixar Ioncube Loader

Os arquivos do Ioncube loader podem ser baixados gratuitamente da Ioncube Inc. Eles existem para sistemas Linux de 32 bits e 64 bits.

No primeiro passo, verificarei se o servidor é um sistema de 32 bits ou 64 bits. Execute:

uname -a

A saída será semelhante a esta:

Quando o texto contém “x86_64”, então o servidor executa um Kernel Linux de 64 bits. Caso contrário, é um Kernel de 32 bits (i386). A maioria dos servidores Linux atuais executa um Kernel de 64 bits.

Baixe o Loader no formato tar.gz para a pasta /tmp e descompacte-o:

Para Linux x86_64 de 64 bits:

cd /tmp  
wget http://downloads3.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz  
tar xfz ioncube_loaders_lin_x86-64.tar.gz

Para Linux i386 de 32 bits:

cd /tmp  
wget http://downloads3.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz  
tar xfz ioncube_loaders_lin_x86.tar.gz

Os arquivos são descompactados em uma pasta com o nome “ioncube”.

3 Qual Ioncube Loader é o certo?

Quando você executa “ ls /tmp/ioncube “ então você verá que há muitos arquivos de loader no diretório ioncube.

Os arquivos têm um número que corresponde à versão do PHP para a qual foram feitos e também há uma versão “_ts” (Thread Safe) de cada loader. Usaremos a versão sem segurança de thread aqui.

Para descobrir a versão do PHP instalada, execute o comando:

php -v

A saída será semelhante a esta:

Para esta tarefa, apenas os dois primeiros dígitos do número da versão na primeira linha de resultado importam; neste servidor, executarei PHP 7.0. Anotamos esse número, pois precisamos dele para os próximos passos.

Agora é hora de descobrir onde está o diretório de extensões desta versão do PHP; execute o seguinte comando para encontrar o nome do diretório:

php -i | grep extension_dir

A saída deve ser semelhante à da captura de tela:

Eu marquei o caminho na captura de tela; o diretório de extensões neste servidor é “/usr/lib/php/20151012”. O nome do diretório será diferente para cada versão do PHP e distribuição Linux; use apenas o que você obtiver do comando e não o que eu obtive aqui.

Agora copie o loader do ioncube para nossa versão do PHP 7.0 para o diretório de extensões /usr/lib/php/20151012:

cp /tmp/ioncube/ioncube_loader_lin_7.0.so /usr/lib/php/20151012/

Substitua “7.0” acima pela sua versão do PHP e “/usr/lib/php/20151012” pelo diretório de extensões da sua versão do PHP.

4 Configurar PHP para o Ioncube Loader

O próximo passo de configuração é um pouco diferente para CentOS e Debian/Ubuntu. Teremos que adicionar uma linha:

zend_extension = /usr/lib/php/20151012/ioncube_loader_lin_7.0.so

como a primeira linha no(s) arquivo(s) php.ini do sistema. Novamente, o caminho acima contém o diretório de extensões “/usr/lib/php/20151012” e a versão do PHP “7.0”; certifique-se de substituí-los para corresponder à configuração do seu sistema. Começarei com as instruções para CentOS.

4.1 Configurar o Ioncube loader no CentOS

O CentOS tem apenas um arquivo php.ini central onde precisamos adicionar o loader do ioncube. Abra o arquivo /etc/php.ini com um editor:

nano /etc/php.ini

e adicione “zend_extension =” mais o caminho para o loader do ioncube como a primeira linha no arquivo.

zend_extension = /usr/lib/php/20151012/ioncube_loader_lin_7.0.so

Em seguida, salve o arquivo e reinicie o servidor web Apache:

service httpd restart  
service php-fpm restart

4.2 Configurar o Ioncube loader no Debian e Ubuntu

Debian e Ubuntu usam arquivos php.ini separados para PHP CLI (linha de comando), CGI, Apache2 e modo FPM. Os caminhos dos arquivos são:

  • /etc/php/7.0/apache2/php.ini
  • /etc/php/7.0/cli/php.ini
  • /etc/php/7.0/cgi/php.ini
  • /etc/php/7.0/fpm/php.ini

Um arquivo deve ser editado para habilitar o loader do ioncube no modo PHP correspondente. Você pode deixar de fora arquivos para modos PHP que não usa ou onde não precisa de suporte ao loader do ioncube. Também é possível que você não tenha todos os arquivos em seu servidor, então não se preocupe se não conseguir encontrar um dos arquivos.

Apache mod_php

nano /etc/php/7.0/apache2/php.ini

PHP de linha de comando (CLI)

nano /etc/php/7.0/cli/php.ini

PHP CGI (usado para modos CGI e Fast_CGI)

nano /etc/php/7.0/cgi/php.ini

PHP FPM

nano /etc/php/7.0/fpm/php.ini

e adicione “zend_extension =” mais o caminho para o loader do ioncube como a primeira linha no(s) arquivo(s).

zend_extension = /usr/lib/php/20151012/ioncube_loader_lin_7.0.so

Em seguida, salve o(s) arquivo(s) e reinicie o servidor web Apache e o php-fpm:

service apache2 restart  
service php7.0-fpm restart

5 Testar Ioncube

Vamos verificar se o loader do ioncube foi instalado com sucesso. Primeiro, testarei o PHP da linha de comando. Execute:

php -v

Eu marquei a linha em branco que mostra que o loader do ioncube foi habilitado:

with the ionCube PHP Loader (enabled) + Intrusion Protection from ioncube24.com (unconfigured) v10.2.0, Copyright (c) 2002-2018, by ionCube Ltd.

Se você quiser testar o PHP de um site, crie um arquivo “info.php” com este conteúdo:

E abra a URL em um navegador web. Você poderá ver o ioncube na saída do phpinfo():

6 Links

  • CentOS
  • Debian
  • Ubuntu
  • Ioncube
Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.