> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Requisitos do AppSignal for PHP

Existem dois requisitos para começar a usar o pacote PHP:

1. Uma [versão do PHP](https://www.php.net/supported-versions) com suporte ativo. Veja nossa [política de manutenção](/support/maintenance-policy).
2. A extensão OpenTelemetry para PHP.

Vamos te guiar pela instalação da extensão OpenTelemetry.

## Instalar a extensão OpenTelemetry para PHP

A extensão OpenTelemetry para PHP fornece hooks em funções PHP que esse pacote usa para instrumentar sua aplicação. Esta é uma extensão PHP que você precisa instalar e habilitar no seu ambiente PHP.

Primeiro, garanta que as dependências de build necessárias estejam disponíveis no seu sistema.

<CodeGroup>
  ```bash title="Ubuntu / Debian" theme={null}
  sudo apt-get install gcc make autoconf
  ```

  ```shell title="macOS" theme={null}
  brew install gcc make autoconf
  ```
</CodeGroup>

Em seguida, instale a extensão OpenTelemetry para PHP usando [PECL](https://pecl.php.net/), [pie](https://github.com/php/pie), [pickle](https://github.com/FriendsOfPHP/pickle) ou [docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer):

<CodeGroup>
  ```shell title="PECL" theme={null}
  pecl install opentelemetry
  ```

  ```shell title="pie" theme={null}
  # Install pie (skip this step if pie is already installed)
  curl -L https://github.com/php/pie/releases/latest/download/pie.phar -o /usr/local/bin/pie && chmod +x /usr/local/bin/pie

  # Install the extension
  pie install open-telemetry/ext-opentelemetry
  ```

  ```shell title="pickle" theme={null}
  # Install pickle (skip this step if pickle is already installed)
  curl -L https://github.com/FriendsOfPHP/pickle/releases/latest/download/pickle.phar -o /usr/local/bin/pickle && chmod +x /usr/local/bin/pickle

  # Install the extension
  pickle install opentelemetry
  ```

  ```dockerfile title="docker-php-extension-installer" theme={null}
  # Use the docker-php-extension-installer script in your Dockerfile when using official PHP Docker images
  ADD --chmod=0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
  RUN install-php-extensions opentelemetry
  ```
</CodeGroup>

Por fim, habilite a extensão no arquivo de configuração da sua instalação PHP. Esse arquivo de configuração geralmente se chama `php.ini`, e sua localização pode ser encontrada executando `php --ini`. Adicione as seguintes linhas a ele:

```ini INI theme={null}
[opentelemetry]
extension=opentelemetry.so
```

<Note>
  Ao usar o script [docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer) para instalar a extensão `opentelemetry`, a extensão é habilitada automaticamente e você não precisa editar manualmente o arquivo `php.ini`.
</Note>

## Criar uma nova aplicação no AppSignal

Por favor, siga primeiro o [guia de instalação](/guides/new-application) ao adicionar uma nova aplicação ao AppSignal.

Ao final desse guia, você receberá uma Push API key e uma URL do endpoint do collector. Você precisará de ambas para configurar o AppSignal for PHP.