CWP with php 8.1.34

build_php_fpm_8_1_34.md

Build do PHP-FPM 8.1.34 no CWP

Data da preparação: 15/08/2026.

Estado anterior

Antes desta preparação, o PHP-FPM 8.1 não estava instalado:

/opt/alt/php-fpm81/ não existia
php-fpm81.service não existia

O arquivo 8.1_last_build.ini também não existia e não foi criado manualmente. Ele deve ser gerado pelo painel ao clicar em Save Options.

Nenhuma instalação PHP já ativa, serviço, pool ou socket foi alterado durante esta preparação.

Observação sobre o ciclo de vida

O PHP 8.1.34 é a última versão oficial da série 8.1. Essa série chegou ao fim do suporte oficial em 31/12/2025. O build permanece útil para compatibilidade com aplicações antigas, mas aplicações compatíveis devem preferencialmente ser migradas para uma série do PHP ainda suportada.

Arquivos persistentes alterados

• /usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/8.1.ini

Criado:

• /usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/build_pecl_module.sh

Modificados:

apcu.sh
imagick.sh
ioncube.sh
mailparse.sh
mcrypt.sh
memcache.sh
mongodb.sh
opcache.sh
redis.sh
sourceguardian.sh
sqlsrv.sh
ssh2.sh
uploadprogress.sh
xdebug.sh

As referências aos quatro scripts pre_run abaixo foram removidas do 8.1.ini, mas os próprios arquivos não foram alterados:

php81.sh
gdavif.sh
ldap.sh
firebird.sh

O imap7.sh foi preservado porque o PHP 8.1 ainda contém a extensão IMAP no core e usa as bibliotecas UW-IMAP.

O script antigo sodium.sh não foi alterado; ele deixou de ser chamado porque Sodium agora é compilado diretamente do fonte oficial do PHP.

Os scripts memcached.sh e yaz.sh não estão associados a opções do 8.1.ini e não foram alterados.

Correção do zlib e das opções salvas

O bloco [zlib] continha:

include=zlib-dir

O arquivo também possuía uma seção separada [zlib-dir], que geraria o argumento antigo e desnecessário:

--with-zlib-dir=/usr

A dependência e a seção redundante foram removidas. Isso evita que a interface do CWP trate zlib-dir como uma segunda opção obrigatória e permite salvar todas as escolhas normalmente.

O zlib continua selecionável e será compilado com:

--with-zlib=/usr

Ajustes no 8.1.ini

• O pre-script antigo php81.sh, que recompilava um PCRE externo, foi removido.
• mbstring, pcntl, posix, shmop e sockets passam a ser compilados como módulos compartilhados.
• O PCRE interno do PHP é usado com --without-external-pcre.
• LDAP usa a sintaxe válida --with-ldap=/usr --with-ldap-sasl.
• PDO Firebird usa as bibliotecas do sistema em /usr.
• Sodium é compilado do core com --with-sodium.
• A segunda seção duplicada de calendar foi removida.
• O pre-script antigo do AVIF foi removido; a biblioteca já disponível no sistema é usada por --with-avif.
• Os pre-scripts antigos de LDAP e Firebird foram removidos porque as bibliotecas e os headers do sistema já estão disponíveis.

Estas opções continuam no core do PHP 8.1 e foram preservadas:

pspell
imap
imap-ssl
kerberos

Depois do ajuste, o painel apresenta 63 opções válidas. Dessas, 50 geram opções do configure, expandidas em 53 argumentos efetivos quando todas são selecionadas.

Extensões externas

O novo build_pecl_module.sh usa diretórios temporários exclusivos, downloads HTTPS com falha explícita, versões fixadas, compilação paralela, verificação do arquivo .so, verificação de bibliotecas dinâmicas e criação determinística do arquivo .ini.

Versões fixadas:

APCu             5.1.28
Imagick          3.8.1
Mailparse        3.2.0
Mcrypt           1.0.9
Memcache         8.2
MongoDB          2.3.3
Redis            6.3.0
SQLSRV           5.12.0
PDO_SQLSRV       5.12.0
SSH2             1.5.0
Uploadprogress   2.0.2
Xdebug           3.5.3

SQLSRV e PDO_SQLSRV usam a versão estável 5.12.0. A linha 5.13 removeu o suporte ao PHP 8.1 e ao PHP 8.2; a linha 5.12 mantém suporte ao PHP 8.1 e seus metadados PECL declaram PHP 8.1 como versão mínima.

O Memcache 8.2 recebe a correção dos includes php_smart_string*.h e é compilado em modo serial para evitar corrida de compilação.

Os loaders são baixados diretamente dos fornecedores e validados antes da ativação:

ionCube:        ioncube_loader_lin_8.1.so
SourceGuardian: ixed.8.1.lin

O opcache.sh valida e ativa OPcache e mbstring, cria um INI neutro para o Sodium compilado no core e mantém os módulos sensíveis comentados nos respectivos arquivos .ini.

Estado esperado após o build

Todos os módulos visíveis no painel podem ser selecionados.

Serão compilados, porém permanecerão desativados:

mcrypt
pcntl
posix
shmop
sockets
ssh2
xdebug

Motivos:

• pcntl: controle de processos, sinais e forks; inadequado para uso geral em servidor web compartilhado.
• posix: expõe funções e informações POSIX do sistema.
• shmop: acesso direto à memória compartilhada do sistema.
• sockets: sockets de baixo nível, clientes, servidores e daemons.
• ssh2: shell remoto, execução remota, SCP, SFTP e túneis SSH.
• xdebug: ferramenta de desenvolvimento e depuração, inadequada para produção.
• mcrypt: extensão obsoleta e não mantida; deve ser substituída por OpenSSL ou Sodium.

Os demais módulos selecionados serão ativados, incluindo IMAP, Pspell, mbstring, OPcache, APCu, Imagick, Memcache, Redis, MongoDB, Uploadprogress, ionCube, SourceGuardian, Mailparse, SQLSRV e PDO_SQLSRV.

Backups

Foi criado um backup individual, anterior às alterações, para cada arquivo modificado. Todos usam o marcador:

pre_php81_20260815_033000.backup

Configuração:

/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/8.1.ini.pre_php81_20260815_033000.backup

Scripts:

/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/apcu.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/imagick.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/ioncube.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/mailparse.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/mcrypt.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/memcache.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/mongodb.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/opcache.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/redis.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/sourceguardian.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/sqlsrv.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/ssh2.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/uploadprogress.sh.pre_php81_20260815_033000.backup
/root/cwp_bkp/usr_local_cwpsrv_htdocs_resources_conf_el8_php-fpm_selector/external_modules/8.1/xdebug.sh.pre_php81_20260815_033000.backup

Os SHA-256 dos 15 backups foram comparados com os originais antes da primeira alteração e todos coincidiram.

Validações realizadas

• O 8.1.ini foi carregado com parse_ini_file(): 63 seções válidas.
• Não restou nenhuma dependência include inexistente.
• Não existem seções duplicadas.
• Todos os scripts .sh do diretório 8.1 passaram em sh -n.
• Não restou referência indevida a caminhos ou loaders de outras versões do PHP nos arquivos modificados.
• As 12 URLs das versões PECL fixadas responderam corretamente e os arquivos compactados passaram no teste de integridade.
• Os metadados PECL das 12 versões aceitam o PHP 8.1.34.
• A versão SQLSRV/PDO_SQLSRV 5.12.0 foi conferida na matriz oficial da Microsoft para PHP 8.1.
• O Xdebug 3.5.3 foi conferido na matriz oficial de compatibilidade com PHP 8.1.
• Os arquivos oficiais de ionCube e SourceGuardian contêm loaders para PHP 8.1 e os arquivos compactados passaram no teste de integridade.
• O fonte oficial do PHP 8.1.34 teve o SHA-256 validado: 3c5b060ec8e0d5dd1d8237823f3161cc8bc5342aab3c46893eba9857759c4bfa.
• O fonte foi submetido a um configure real com os mesmos 53 argumentos que o painel produzirá ao selecionar tudo.
• O configure terminou com código 0, sem opções desconhecidas ou erros.
• O preflight confirmou IMAP com SSL e Kerberos, Pspell, pcntl, posix, shmop, sockets, AVIF, LDAP, PostgreSQL, PDO Firebird, Sodium e Argon2.
• A ausência de opagent foi registrada apenas como integração opcional de profiling do OPcache e não impede a compilação.
• Os diretórios temporários das validações foram removidos.
• Nenhum build foi iniciado durante esta preparação.

Resultado do build e validação pós-build

O build iniciado pelo painel em 15/08/2026 terminou com a mensagem:

Build Completed

A instalação resultante é:

PHP 8.1.34 NTS
PHP API:             20210902
Zend Module API:     20210902
Zend Extension API:  420210902

O 8.1_last_build.ini foi criado pelo painel com as 63 opções selecionadas. O bloco [version] contém major="8.1" e minor=""; esse campo vazio é apenas metadado do painel. O fonte usado no log, o binário, php-config e phpize confirmam a versão 8.1.34.

Extensões e recursos

O PHP inicia sem warnings e as 44 extensões/recursos esperados ativos foram confirmados. As extensões externas reportaram:

APCu             5.1.28
Imagick          3.8.1
Mailparse        3.2.0
Memcache         8.2
MongoDB          2.3.3
Redis            6.3.0
SQLSRV           5.12.0
PDO_SQLSRV       5.12.0
Uploadprogress   2.0.2
ionCube          15.5.0
SourceGuardian   17.0.0

Os sete módulos compilados, mas mantidos desativados nos INIs, foram carregados individualmente com php -n e aprovados:

mcrypt    1.0.9
pcntl     8.1.34
posix     8.1.34
shmop     8.1.34
sockets   8.1.34
ssh2      1.5.0
xdebug    3.5.3

Também foram confirmados:

• PDO com Firebird, MySQL, PostgreSQL, SQLite e SQL Server;
• GD com FreeType, JPEG, PNG, XPM, WebP e AVIF;
• IMAP c-client 2007f com SSL e Kerberos;
• Argon2i e Argon2id;
• Sodium compilado no core e funcional mesmo com php -n;
• OPcache ativo com otimização habilitada;
• 18 arquivos .so, além de php e php-fpm, sem dependências dinâmicas ausentes no ldd.

PHP-FPM

O serviço php-fpm81.service ficou habilitado e ativo, com PID mestre 3286166. O teste php-fpm -t aprovou a configuração e o socket abaixo está escutando:

/opt/alt/php-fpm81/usr/var/sockets/cwpsvc.sock

Ainda não existem pools de usuários em /opt/alt/php-fpm81/usr/etc/php-fpm.d/users/. Por isso o PHP-FPM registra o aviso de que o padrão users/*.conf não encontrou arquivos. Isso é esperado enquanto nenhum site estiver atribuído ao PHP 8.1 e não afeta o pool cwpsvc.

Mensagens não impeditivas no log

O log contém avisos de getcwd entre alguns scripts porque o diretório de trabalho anterior já havia sido removido. Cada script mudou para seu próprio diretório válido e todas as extensões seguintes foram compiladas e instaladas.

Também apareceu uma mensagem isolada de criação concorrente de .libs durante uma compilação paralela. O make terminou com sucesso e o módulo resultante foi carregado e validado.

A mensagem final abaixo pertence somente à notificação do painel e não ao build do PHP:

Error:Can't add notification!

Não restaram diretórios temporários php81-* dos scripts externos em /usr/local/src.

Procedimento no painel

1. Atualizar a página do CWP para recarregar o 8.1.ini.
2. Abrir PHP-FPM Selector → PHP 8.1.34 → opções.
3. Marcar todas as 63 opções exibidas.
4. Clicar em Save Options.
5. Confirmar que o arquivo 8.1_last_build.ini foi criado pelo painel.
6. Iniciar o build do PHP 8.1.34.
7. Acompanhar:

tail -f /var/log/php-selector-rebuild.log

Depois do build, conferir:

/opt/alt/php-fpm81/usr/bin/php -v
/opt/alt/php-fpm81/usr/bin/php --ini
/opt/alt/php-fpm81/usr/bin/php -m

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/mongodb.sh

#!/bin/sh
SCRIPT_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd)
exec sh "$SCRIPT_DIR/build_pecl_module.sh" mongodb 2.3.3 mongodb extension enabled --enable-mongodb

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/opcache.sh

#!/bin/sh
set -eu

PHP_PREFIX=/opt/alt/php-fpm81/usr
PHP="$PHP_PREFIX/bin/php"
PHP_CONFIG="$PHP_PREFIX/bin/php-config"
INI_DIR="$PHP_PREFIX/php/php.d"

if [ ! -x "$PHP" ] || [ ! -x "$PHP_CONFIG" ]; then
    echo "ERRO: PHP/php-config do PHP 8.1 não encontrado"
    exit 1
fi

EXT_DIR=$("$PHP_CONFIG" --extension-dir)
OPCACHE_SO="$EXT_DIR/opcache.so"

if [ ! -f "$OPCACHE_SO" ]; then
    echo "ERRO: $OPCACHE_SO não encontrado"
    exit 1
fi

if ! "$PHP" -n -d "zend_extension=$OPCACHE_SO" \
    -r 'exit(extension_loaded("Zend OPcache") ? 0 : 1);'
then
    echo "ERRO: OPcache do PHP 8.1 não pôde ser carregado"
    exit 1
fi

for MODULE in mbstring pcntl posix shmop sockets; do
    if [ ! -f "$EXT_DIR/$MODULE.so" ]; then
        echo "ERRO: $EXT_DIR/$MODULE.so não encontrado"
        exit 1
    fi

    if ! "$PHP" -n -d "extension=$EXT_DIR/$MODULE.so" \
        -r "exit(extension_loaded('$MODULE') ? 0 : 1);"
    then
        echo "ERRO: $MODULE do PHP 8.1 não pôde ser carregado"
        exit 1
    fi
done

install -d -m 0755 "$INI_DIR"

printf '%s\n' '; Sodium compilado no core do PHP 8.1' \
    > "$INI_DIR/sodium.ini"

printf '%s\n' 'extension=mbstring.so' \
    > "$INI_DIR/00-mbstring.ini"

{
    printf 'zend_extension=%s\n' "$OPCACHE_SO"
    printf '%s\n' 'opcache.enable=1'
    printf '%s\n' 'opcache.memory_consumption=128'
    printf '%s\n' 'opcache.interned_strings_buffer=8'
    printf '%s\n' 'opcache.max_accelerated_files=5000'
    printf '%s\n' 'opcache.revalidate_freq=60'
    printf '%s\n' 'opcache.enable_cli=1'
} > "$INI_DIR/opcache.ini"

for MODULE in pcntl posix shmop sockets; do
    printf ';extension=%s.so\n' "$MODULE" \
        > "$INI_DIR/$MODULE.ini"
done

echo "OPcache e mbstring ativados; pcntl, posix, shmop e sockets desativados"

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/redis.sh

#!/bin/sh
SCRIPT_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd)
exec sh "$SCRIPT_DIR/build_pecl_module.sh" redis 6.3.0 redis extension enabled --enable-redis

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/sourceguardian.sh

#!/bin/sh
set -eu

BUILD_ROOT=/usr/local/src
PHP_PREFIX=/opt/alt/php-fpm81/usr
PHP="$PHP_PREFIX/bin/php"
INI_DIR="$PHP_PREFIX/php/php.d"
DEST_DIR=/usr/local/sourceguardian
LOADER_NAME=ixed.8.1.lin

cd "$BUILD_ROOT"
WORK_DIR=$(mktemp -d "$BUILD_ROOT/php81-sourceguardian.XXXXXX")

cleanup()
{
    cd "$BUILD_ROOT" 2>/dev/null || return
    rm -rf -- "$WORK_DIR"
}

trap cleanup EXIT HUP INT TERM

ARCHIVE="$WORK_DIR/sourceguardian.zip"
EXTRACT_DIR="$WORK_DIR/extracted"

install -d -m 0755 "$EXTRACT_DIR"

curl --fail --location --retry 3 --connect-timeout 20 \
    https://www.sourceguardian.com/loaders/download/loaders.linux-x86_64.zip \
    --output "$ARCHIVE"

unzip -j -o "$ARCHIVE" "$LOADER_NAME" -d "$EXTRACT_DIR"
SOURCE_LOADER="$EXTRACT_DIR/$LOADER_NAME"

if [ ! -f "$SOURCE_LOADER" ]; then
    echo "ERRO: loader SourceGuardian para PHP 8.1 não encontrado"
    exit 1
fi

install -d -m 0755 "$DEST_DIR" "$INI_DIR"
install -m 0644 "$SOURCE_LOADER" "$DEST_DIR/$LOADER_NAME"

if ! "$PHP" -n -d "zend_extension=$DEST_DIR/$LOADER_NAME" \
    -r 'exit(extension_loaded("SourceGuardian") ? 0 : 1);'
then
    echo "ERRO: loader SourceGuardian para PHP 8.1 não pôde ser carregado"
    exit 1
fi

printf 'zend_extension=%s/%s\n' "$DEST_DIR" "$LOADER_NAME" \
    > "$INI_DIR/sourceguardian.ini"

echo "SourceGuardian PHP 8.1 instalado e ativado"

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/sqlsrv.sh

#!/bin/sh
set -eu

SCRIPT_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd)

sh "$SCRIPT_DIR/build_pecl_module.sh" \
    sqlsrv 5.12.0 sqlsrv extension enabled --enable-sqlsrv

exec sh "$SCRIPT_DIR/build_pecl_module.sh" \
    pdo_sqlsrv 5.12.0 pdo_sqlsrv extension enabled --enable-pdo_sqlsrv

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/ssh2.sh

#!/bin/sh
SCRIPT_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd)
exec sh "$SCRIPT_DIR/build_pecl_module.sh" ssh2 1.5.0 ssh2 extension disabled --with-ssh2=/usr/local

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/uploadprogress.sh

#!/bin/sh
SCRIPT_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd)
exec sh "$SCRIPT_DIR/build_pecl_module.sh" uploadprogress 2.0.2 uploadprogress extension enabled --enable-uploadprogress

/usr/local/cwpsrv/htdocs/resources/conf/el8/php-fpm_selector/external_modules/8.1/xdebug.sh

#!/bin/sh
SCRIPT_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd)
exec sh "$SCRIPT_DIR/build_pecl_module.sh" xdebug 3.5.3 xdebug zend_extension disabled --enable-xdebug

cat /etc/*os-release*
AlmaLinux release 8.10 (Cerulean Leopard)
NAME="AlmaLinux"
VERSION="8.10 (Cerulean Leopard)"
ID="almalinux"
ID_LIKE="rhel centos fedora"
VERSION_ID="8.10"
PLATFORM_ID="platform:el8"
PRETTY_NAME="AlmaLinux 8.10 (Cerulean Leopard)"
ANSI_COLOR="0;34"
LOGO="fedora-logo-icon"
CPE_NAME="cpe:/o:almalinux:almalinux:8::baseos"
HOME_URL="https://almalinux.org/"
DOCUMENTATION_URL="https://wiki.almalinux.org/"
BUG_REPORT_URL="https://bugs.almalinux.org/"

ALMALINUX_MANTISBT_PROJECT="AlmaLinux-8"
ALMALINUX_MANTISBT_PROJECT_VERSION="8.10"
REDHAT_SUPPORT_PRODUCT="AlmaLinux"
REDHAT_SUPPORT_PRODUCT_VERSION="8.10"
SUPPORT_END=2029-06-01

uname -r
4.18.0-553.153.1.el8_10.x86_64