Pular para o conteúdo
Setup do Dev
Programação

O PHP do terminal e o do site podem ser versões diferentes, e o php -v não avisa

Na máquina da redação, o php -v diz 8.5.7 e o Apache roda o 8.5.11, com outro php.ini e outras extensões. Veja como perguntar ao servidor web.

Por Setup do Dev
4 min de leitura
Compartilhar
Capa do Setup do Dev em azul-escuro: "O php -v não é o PHP do seu site", com 8.5.7 diferente de 8.5.11 em destaque e um terminal em que o php -v mostra 8.5.7 e o curl no site local mostra PHP/8.5.11

Na semana em que a PHP2Shell passou a ser explorada, a pergunta mais comum foi “o meu PHP já está corrigido?”. E a resposta mais comum foi um php -v no terminal. Só que o terminal pode estar falando de outro PHP. Na máquina da redação, estava:

$ php -v
PHP 8.5.7 (cli) (built: Jun  2 2026 21:14:36) (NTS Visual C++ 2022 x64)

$ curl -sI http://127.0.0.1:8097/ | grep -i powered
X-Powered-By: PHP/8.5.11

São dois PHPs no mesmo computador. O do terminal fica em C:\php, instalado à parte para rodar o Composer e os testes. O do site veio com o Laragon e é carregado pelo Apache como módulo, de outra pasta. Quem confere a correção pelo terminal vê a 8.5.7 e não descobre nada sobre o site. A mesma confusão aparece em qualquer servidor com mais de uma versão instalada, porque o comando php aponta para uma delas e o site pode usar outra.

Dois comandos dizem qual PHP o terminal está usando. O where php no Windows (which php no Linux e no macOS) mostra o executável que o PATH encontra primeiro, e o php --ini mostra o arquivo de configuração que ele leu:

$ where php
C:\php\php.exe

$ php --ini
Loaded Configuration File:         "C:\php\php.ini"
Scan for additional .ini files in: (none)

Nenhum dos dois fala do Apache. Eles só confirmam de onde vem a resposta do php -v.

Pergunte ao servidor web, e não ao terminal

O jeito de saber qual PHP atende o site é perguntar a ele: um arquivo PHP na pasta pública, aberto pelo navegador ou pelo curl.

<?php
header('Content-Type: text/plain; charset=utf-8');
echo PHP_VERSION, "\n", PHP_SAPI, "\n", PHP_BINARY, "\n", php_ini_loaded_file(), "\n";
foreach (['memory_limit', 'max_execution_time', 'upload_max_filesize'] as $k) {
    echo $k, ' = ', ini_get($k), "\n";
}

A resposta do nosso Apache:

8.5.11
apache2handler
C:\laragon\bin\apache\httpd-2.4.54-win64-VS16\bin\httpd.exe
C:\laragon\bin\php\php-8.5.11-Win32-vs17-x64\php.ini
memory_limit = 512M
max_execution_time = 36000
upload_max_filesize = 2G

O PHP_SAPI diz quem está rodando o PHP: cli no terminal, apache2handler no módulo do Apache, fpm-fcgi no PHP-FPM. O PHP_BINARY engana: com o módulo do Apache, ele aponta o httpd.exe, porque o PHP roda dentro do processo do Apache. A linha que mais interessa é a do php.ini, que não é o mesmo do terminal.

Apague o arquivo assim que ler a resposta. Uma página que mostra versão, caminhos e configuração é um mapa para quem procura servidor desatualizado, e o mesmo vale para o phpinfo() esquecido numa pasta.

O mesmo executável no terminal ainda não é o site

A tentação seguinte é rodar no terminal o php.exe da pasta do Laragon. Ele mostra a versão certa e as extensões, mas não a configuração do site. O manual do PHP lista seis diretivas que a linha de comando sobrescreve depois de ler o php.ini, e uma delas é o max_execution_time, que no terminal é sempre 0, sem limite. No nosso teste, o mesmo PHP 8.5.11 mostrou 0 pela linha de comando e 36.000 segundos, ou dez horas, pelo Apache.

Tabela comparando o PHP do terminal e o do site na mesma máquina com Windows 11 e Laragon: versão 8.5.7 contra 8.5.11, PHP_SAPI cli contra apache2handler, php.ini diferentes, memory_limit 128M contra 512M, upload_max_filesize 8M contra 2G, max_execution_time 0 contra 36000 e 46 extensões contra 44
O PHP do terminal e o do site, lado a lado, no teste do Setup do Dev

As extensões também não batem. Comparando o php -m dos dois, o do terminal tem Xdebug, ftp, pdo_sqlite e sqlite3, que o do site não tem. O do site tem mysqli e xsl, que faltam no terminal. Um teste que passa no terminal usando SQLite falharia no site, e um script de manutenção que precisa do mysqli quebraria no terminal.

O Composer usa o PHP do terminal

O composer -V mostra qual PHP o Composer usa, e aqui ele respondeu PHP version 8.5.7 (C:\php\php.exe). É com essa versão que ele confere as exigências dos pacotes, e não com a do site. Entre 8.5.7 e 8.5.11 a diferença não importa, mas com ramos diferentes, um 8.4 no terminal e um 8.2 no site, o composer install pode aceitar um pacote que o site não roda. A configuração platform do composer.json existe para fixar a versão do servidor nessa conta.

A versão no cabeçalho é um convite

O mesmo curl mostrou mais do que a redação queria: Server: Apache/2.4.54 (Win64) OpenSSL/1.1.1p PHP/8.5.11. Quem varre a internet atrás de PHP sem correção lê exatamente esse cabeçalho. O expose_php = Off no php.ini tira o X-Powered-By, e o ServerTokens Prod no Apache encurta o Server para só “Apache”. Nenhum dos dois substitui atualizar, mas tiram o servidor da lista fácil.

A opinião do Setup do Dev: para saber se o site está corrigido, pergunte ao site. O php -v responde sobre o terminal, o Composer e as tarefas agendadas que rodam pela linha de comando, e isso também importa. A versão que atende o visitante, porém, só aparece numa página servida pelo próprio servidor web.

Fonte: Manual do PHP: diferenças da linha de comando

Produzido com auxílio de IA e revisado pela redação.

Comentários (0)

Ainda não há comentários. Comece a conversa.

Deixe seu comentário

Seu e-mail não será publicado. O primeiro comentário de cada pessoa passa por moderação.

Seja respeitoso

Neste artigo

  1. Pergunte ao servidor web, e não ao terminal
  2. O mesmo executável no terminal ainda não é o site
  3. O Composer usa o PHP do terminal
  4. A versão no cabeçalho é um convite

Mais lidas

Editorias

Leia também

Newsletter semanal

O essencial da tecnologia, toda sexta no seu e-mail

Uma curadoria da redação com as notícias que importam para quem desenvolve, joga e trabalha com tecnologia. Sem spam.

Ao assinar, você concorda com a política de privacidade. Cancele quando quiser.