# FAQ

# Frequently Asked Questions



# (ERRO) NGINX/PHP-FPM - 502 Bad Gateway

## Evidências do Erro:

- Ao acessar o website o `nginx` responde com *status code* `502`e uma página referente ao *status code*
    - Ex: `https://maykon.central.illimitar.com.br:8101/illi/principal` = `502`

[![502.png](https://kb.illimitar.pro/uploads/images/gallery/2025-01/scaled-1680-/captura-de-tela-2025-01-09-as-12-26-50.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-01/captura-de-tela-2025-01-09-as-12-26-50.png)

- Consulte os logs do `systemd` pelo comando `journalctl:````
    journalctl -xe | grep "please specify user and group other than root"
    ```
    
    
    - Verifique se há uma mensagem de erro similar a mensagem abaixo: ```
        ERROR: [pool illi] please specify user and group other than root
        ```

[![Captura de Tela 2025-01-09 às 14.54.41.png](https://kb.illimitar.pro/uploads/images/gallery/2025-01/scaled-1680-/captura-de-tela-2025-01-09-as-14-54-41.png)](https://kb.illimitar.pro/uploads/images/gallery/2025-01/captura-de-tela-2025-01-09-as-14-54-41.png)

## Possível causa:

O erro ocorre porque o PHP-FPM não permite que pools sejam configurados para serem executados diretamente como o usuário `root`, por questões de segurança. Isso pode acontecer se o arquivo de configuração do pool (`/etc/php-fpm.d/illi.conf`) estiver configurado para usar `user = root` e/ou `group = root`.

## Como resolver:

1. [ ]  **Identifique o arquivo de configuração do pool problemático:**
    - Geralmente está localizado em `/etc/php-fpm.d/`.
    - Exemplo: `/etc/php-fpm.d/illi.conf`.
2. [ ]  **Abra o arquivo de configuração para edição:**```
    sudo nano /etc/php-fpm.d/illi.conf
    ```
3. [ ]  **Altere os valores de `user` e `group` para `apache`:**```
    user = apache
    group = apache
    ```
4. [ ]  **Salve as alterações e saia do editor.**
5. [ ]  **Reinicie o serviço PHP-FPM para aplicar as mudanças:**```
    sudo systemctl restart php-fpm
    ```
6. [ ]  **Verifique se o erro foi resolvido:**
    - Consulte o status do serviço PHP-FPM: ```
        sudo systemctl status php-fpm
        ```
    - Teste o acesso ao website para confirmar se a página de login foi apresentada.
7. [ ]  **Garanta que o user/group apache tenha acesso para gerenciar o diretório de sessões:**
    - Acesse o diretório `/var/lib/php/sessions````
        cd /var/lib/php/sessions
        ```
    - Altere o proprietário e o grupo de todos os arquivos, diretórios e subdiretórios no diretório atual para `apache`. ```
        chown -Rf apache:apache .
        ```
8. [ ]  **Garanta que o user/group apache tenha acesso para gerenciar os arquivos do website:**
    - Acesse o diretório onde se encontra os arquivos do website (Ex: `/var/www/illi`) ```
        cd /var/www/illi
        ```
    - Altere o proprietário e o grupo de todos os arquivos, diretórios e subdiretórios no diretório atual para `apache`. ```
        chown -Rf apache:apache .
        ```
9. [ ]  **Verifique se o website voltou a funcionar normalmente**

---

## Vídeo:

[Link](https://drive.google.com/file/d/1IJaMAdzYhvuInycbM3-hbfe47e6pcXTh/view?usp=sharing)