> For the complete documentation index, see [llms.txt](https://software-telematica-com.gitbook.io/suricato-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-do-suricato/instalacao-do-suricato/atualizacao-do-php.md).

# 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="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F4KAK4ExUJU8GS5cmJuJo%2Fimage.png?alt=media&amp;token=d66c6d18-93e9-47d3-ae0c-15b6198fc6cc" 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="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F2TfgVXmecA3aw5a8Fj2q%2Fimage.png?alt=media&amp;token=74bda6ab-ed7f-4556-be2c-6006470788da" 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="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F7l40pj214uuqm8jBFykd%2Fimage.png?alt=media&amp;token=e69e8e88-2a79-4f91-a8a4-a24d1d7a8c08" 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="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2Fmb53WINpMaLZDKi0oNyW%2Fimage.png?alt=media&amp;token=d642d917-5032-4cc1-b5f3-b48f5632e82e" 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="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FuZC62N8Sabnhv80LEYVi%2Fimage.png?alt=media&amp;token=2d90882a-b841-4d48-93c0-8b2cb1f526f2" 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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 following URL with the `ask` and `goal` query parameters:

```
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>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.