Scriptcase Help Center
pt_BR
Idioma
en English pt_BR Portuguese (Brazil) es Spanish

Atualizando o PHP 8.2.x para PHP 8.2.35 no Scriptcase — Windows

Abrir em
Ver como Markdown Abrir no ChatGPT Abrir no Claude
Á

Álvaro Moura

Última atualização em Oct 23, 2026

Para atualizar o PHP utilizado pelo ambiente de desenvolvimento do Scriptcase no Windows e corrigir vulnerabilidades de segurança, será necessário substituir os arquivos do PHP presentes no diretório de componentes do Scriptcase.

O procedimento permite atualizar o PHP 8.2.x para o PHP 8.2.35, preservando os projetos, bancos de dados e configurações existentes.

Neste tutorial, veremos como realizar a atualização manualmente.

Importante: Este tutorial considera a estrutura de diretórios e serviços criada pelo instalador oficial do Scriptcase v10 com PHP 8.2. Caso seu ambiente tenha sido configurado de outra forma, o procedimento será semelhante*. Entretanto, os diretórios, nome de serviços poderão ser diferentes, sendo necessário adaptar as instruções ao seu ambiente.*

Pré - Requisitos

Antes de modificar os arquivos da instalação, realize os procedimentos abaixo.

Verificar a versão e a arquitetura do PHP

  1. Acesse o ambiente de desenvolvimento do Scriptcase.

  2. No menu superior, selecione Ajuda > Diagnóstico.

  3. Verifique a versão atual do PHP.

  4. Salve as informações do diagnóstico.

  5. Localize a informação Architecture e confirme se a arquitetura é x64 ou x86.

O procedimento apresentado utiliza como referência a arquitetura x64, mas também pode ser realizado em instalações x86, utilizando os arquivos correspondentes.

Realizar um backup preventivo

Antes de iniciar a atualização realize um backup de segurança dos seus projetos.

  1. Configurações > Administração

  2. Em seguida, em Serviços > Backup

  3. Defina um nome e clique em Processar e aguarde o processo

  4. O Backup estará finalizado quando o botão Download for exibido. Baixe o zip e armazene em um local seguro.

Passo 1: Parar o ambiente web

  1. No Windows, abra o menu Iniciar e pesquise por Serviços.

  2. Execute o gerenciador de serviços com permissões de administrador.

  3. Localize o serviço ApacheScriptcase10.

  4. Clique com o botão direito sobre o serviço e selecione Parar.

  5. Abra o Gerenciador de Tarefas utilizando Ctrl + Shift + Esc.

  6. Verifique se existem processos php.exe ou php-cgi.exe relacionados ao ambiente do Scriptcase.

Caso existam, encerre os processos correspondentes à instalação que está sendo atualizada.

Importante: Não prossiga com a substituição dos arquivos enquanto os serviços do ambiente estiverem em execução.

Passo 2: Download do PHP 8.2.35 (NTS)

  1. Baixar o PHP 8.2.35 (Non Thread Safe)

  2. Localize a seção correspondente ao PHP 8.2.35.

  3. Baixe a versão Non Thread Safe (NTS) compatível com a arquitetura identificada anteriormente:    - VS16 x64 Non Thread Safe: para instalações de 64 bits.

       - VS16 x86 Non Thread Safe: para instalações de 32 bits.

  4. Selecione o arquivo no formato .zip.

Atenção: O Scriptcase utiliza PHP ***Non Thread Safe (NTS)*****. Portanto, é necessário baixar a versão NTS correspondente à arquitetura do ambiente (x64 ou x86). Não utilize a versão Thread Safe (TS).

Passo 3: Substituir os arquivos do PHP

Após para os serviços e realizar o download do php, siga os passos abaixo:

  1. Acesse o diretório de componentes do Scriptcase:

    C:\Program Files\NetMake\v10-php82\components

  2. Localize a pasta php.

  3. Renomeie a pasta atual para php_old, preservando os arquivos da instalação anterior.

  4. Crie uma nova pasta com o nome php.

  5. Extraia todo o conteúdo do arquivo .zip baixado dentro do diretório criado no passo anterior:
    C:\Program Files\NetMake\v10-php82\components\php

  6. Confirme que os arquivos do PHP foram extraídos diretamente dentro da nova pasta php.

Passo 4: Restaurar as configurações e extensões do Scriptcase

Após atualizar os arquivos do PHP, será necessário recuperar as configurações da instalação anterior, que foram preservadas na pasta php_old.

4.1. Restaurar o arquivo php.ini

  1. Acesse a pasta php_old.

  2. Localize o arquivo php.ini.

  3. Copie o arquivo para a nova pasta php.

Importante: O arquivo php.ini contém as configurações utilizadas pelo PHP no ambiente do Scriptcase. É fundamental manter esse arquivo para preservar os caminhos e as configurações necessários ao funcionamento do ambiente

4.2. Restaurar as extensões do PHP

Para preservar as extensões adicionais utilizadas pelo Scriptcase, siga os passos abaixo:

  1. Acesse o diretório php_old\ext.

  2. Copie todos os arquivos existentes nessa pasta.

  3. Acesse o diretório php\ext da nova instalação.

  4. Cole os arquivos copiados, sem substituir os arquivos que já existem.

Importante: Caso o Windows solicite a substituição de arquivos, selecione a opção para ignorá-los, mantendo os arquivos da nova versão do PHP.

4.3. Restaurar o SourceGuardian

O Scriptcase no PHP 8.2 utiliza o SourceGuardian para o carregamento de componentes protegidos do ambiente de desenvolvimento.

  1. Acesse o diretório php_old.

  2. Localize o arquivo ixed.8.2.win.

  3. Copie esse arquivo para a nova pasta php, sem substituir outros arquivos.

Importante: Caso o Scriptcase apresente um erro relacionado ao SourceGuardian após a atualização, verifique se o arquivo foi copiado corretamente e se o caminho configurado no php.ini está correto.

4.4. Criar o diretório temporário (tmp)

Para garantir o funcionamento correto das sessões e dos arquivos temporários do PHP, será necessário recriar o diretório tmp utilizado pela instalação anterior.

  1. Acesse a pasta php.

  2. Crie uma nova pasta com o nome tmp.

Importante: O diretório tmp deve possuir permissões de escrita para o usuário responsável pela execução do Apache. Essa pasta é utilizada para armazenar arquivos temporários e sessões do PHP. Sua ausência pode provocar erros de sessão e impedir o login no Scriptcase.

Passo 5: Iniciar o ambiente e validar a atualização

Após concluir a substituição dos arquivos e restaurar as configurações, reinicie o ambiente.

  1. Abra novamente o gerenciador de Serviços do Windows.

  2. Localize o serviço ApacheScriptcase10.

  3. Clique com o botão direito sobre o serviço e selecione Iniciar.

  4. Acesse o Scriptcase e realize o login normalmente.

  5. No menu superior, selecione Ajuda > Diagnóstico.

  6. Confirme se a versão apresentada é PHP 8.2.35.

  7. Verifique se as extensões necessárias estão carregadas corretamente.

  8. Abra um projeto existente e execute uma aplicação para confirmar o funcionamento.

Caso o ambiente não inicie corretamente, consulte os logs do Apache e do PHP e verifique as configurações do arquivo php.ini.