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 wgetDebian e Ubuntu
apt-get install nano wget2 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 -aA 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.gzPara 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.gzOs 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 -vA 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_dirA 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.socomo 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.inie 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.soEm seguida, salve o arquivo e reinicie o servidor web Apache:
service httpd restart
service php-fpm restart4.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.iniPHP de linha de comando (CLI)
nano /etc/php/7.0/cli/php.iniPHP CGI (usado para modos CGI e Fast_CGI)
nano /etc/php/7.0/cgi/php.iniPHP FPM
nano /etc/php/7.0/fpm/php.inie 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.soEm seguida, salve o(s) arquivo(s) e reinicie o servidor web Apache e o php-fpm:
service apache2 restart
service php7.0-fpm restart5 Testar Ioncube
Vamos verificar se o loader do ioncube foi instalado com sucesso. Primeiro, testarei o PHP da linha de comando. Execute:
php -vEu 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
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.