# Atualização do PHP

## Visão Geral

Este procedimento descreve como realizar a atualização do PHP utilizado pelo sistema SURICATO, garantindo compatibilidade com as versões do sistema.

A atualização do PHP é necessária para:

* Manter a compatibilidade com o Scriptcase;
* Atender aos requisitos das versões mais recentes do SURICATO;
* Garantir estabilidade e segurança do ambiente.

O processo consiste basicamente em:

* Download da versão correta do PHP;
* Substituição dos arquivos no diretório do SURICATO;
* Reinicialização do serviço Apache;
* Validação da atualização.

## Regras de Negócio

* O **SURICATO 3.0 (Scriptcase 9.10)** é compatível **apenas com PHP 8.1**.
* O **SURICATO 3.1 (versão mais recente)** requer **PHP 8.5**.
* A atualização deve respeitar a versão do sistema instalada:
  * **Não utilizar PHP 8.5 no Suricato 3.0**
  * **Obrigatório PHP 8.5 para Suricato 3.1**
* Sempre realizar **backup da pasta PHP antes da atualização**.
* O serviço **Telemática Suricato (Apache)** deve estar **parado durante o processo**.
* Utilizar apenas versões oficiais do PHP disponíveis em:
  * <https://www.php.net/downloads.php>

## Como atualizar o PHP

#### 1. Download do PHP

1. Acesse o site oficial:\
   <https://www.php.net/downloads.php>
2. Localize a versão desejada:
   * Para **Suricato 3.0** → PHP **8.1**
   * Para **Suricato 3.1** → PHP **8.5**
3. Clique em **“Windows downloads”**.
4. Selecione a opção:
   * **Zip**
   * **VS16 x64 Thread Safe**

<figure><img src="/files/THn7a3vbK0De5kK68fao" alt=""><figcaption></figcaption></figure>

#### 2. Extração dos Arquivos

1. Após o download, extraia o arquivo .zip em uma pasta temporária.

<figure><img src="/files/wkJx0WAY2lABJANwDJpg" alt=""><figcaption></figcaption></figure>

#### 3. Parar o Serviço do SURICATO

1. Acesse os serviços do Windows;
2. Localize o serviço:
   * **Telemática Suricato (Apache)**;
3. Pare o serviço.

#### 4. Backup da Versão Atual

1. Acesse o diretório de instalação:

   ```
   C:\Telematica\Suricato
   ```
2. Localize a pasta **php**;
3. Faça uma cópia da pasta e renomeie para:

   ```
   php_old
   ```

<figure><img src="/files/PamWIIlGkdVyXBRvrumD" alt=""><figcaption></figcaption></figure>

#### 5. Atualização do PHP

1. Acesse a pasta onde os arquivos do PHP foram extraídos;
2. Copie **todo o conteúdo**;
3. Cole dentro da pasta:

   ```
   C:\Telematica\Suricato\php
   ```
4. Quando solicitado, clique em:
   * **“Replace the files in the destination”** (Substituir arquivos de destino)

<figure><img src="/files/JtBBVMrz6pw11A6MQqIy" alt=""><figcaption></figcaption></figure>

#### 6. Inicializar o Serviço

1. Retorne aos serviços do Windows;
2. Inicie o serviço:
   * **Telemática Suricato (Apache)**

#### 7. Validação da Atualização

1. Acesse o navegador;
2. Digite o endereço:

   ```
   https://IPdoSuricato/suricato/info.php
   ```
3. Verifique a versão do PHP exibida na tela.

<figure><img src="/files/uNjRUin7KvWcx19z7ZaJ" alt=""><figcaption></figcaption></figure>

## FAQ - Perguntas Frequentes

<details>

<summary>Posso atualizar diretamente para PHP 8.5 em qualquer versão do SURICATO?</summary>

Não. O PHP deve ser compatível com a versão do sistema:

* Suricato 3.0 → PHP 8.1
* Suricato 3.1 → PHP 8.5

</details>

<details>

<summary>O que acontece se eu usar uma versão incorreta do PHP?</summary>

O sistema pode apresentar falhas, incompatibilidades ou até não iniciar.

</details>

<details>

<summary>É obrigatório parar o serviço Apache antes da atualização?</summary>

Sim. Isso evita conflitos e garante a integridade dos arquivos.

</details>

<details>

<summary>Preciso fazer backup da pasta PHP?</summary>

Sim. O backup (ex: **php\_old**) permite reverter rapidamente em caso de problemas.

</details>

<details>

<summary>Como confirmar se a atualização deu certo?</summary>

Acesse:

```
https://IPdoSuricato/suricato/info.php
```

E verifique a versão exibida.

</details>

<details>

<summary>Posso perder configurações ao atualizar o PHP?</summary>

Não normalmente, mas o backup garante segurança caso seja necessário restaurar.

</details>

<details>

<summary>Preciso reiniciar o servidor?</summary>

Não necessariamente. Apenas reiniciar o serviço Apache já é suficiente.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/atualizacao-do-php.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.