---
name: deploy-php-cli-path
description: "O `php` global no servidor é php-cgi e falha ao rodar `php spark`. Usar o caminho explícito do php-cli."
metadata: 
  node_type: memory
  type: project
  originSessionId: e41195c3-9cad-46c0-aa7c-2a7fba7c3815
---

No servidor de produção, executar `php spark migrate` (ou qualquer `spark`) com `php` puro falha:

```
The cli tool is not supported when running php-cgi. It needs php-cli to function!
```

**Why:** o `php` default no PATH do root vem do cPanel e é `php-cgi`, não `php-cli`.

**How to apply:** sempre usar caminho absoluto do php-cli:

```
/opt/cpanel/ea-php83/root/usr/bin/php spark migrate
```

E sempre rodar via `sudo -u agmusiccom` pra não criar arquivos cache com ownership errado:

```bash
cd /home/agmusiccom/public_html/sistema.agmusic && \
  sudo -u agmusiccom /opt/cpanel/ea-php83/root/usr/bin/php spark migrate
```

**PHP-FPM que serve o site `sistema.agmusic.com.br`**: `ea-php81` (PHP 8.1), apesar do CLI ser 8.3.30. Conferido via `/usr/local/cpanel/bin/whmapi1 php_get_vhost_versions`.

**Restart FPM correto**: `systemctl restart ea-php81-php-fpm` (o `/scripts/restartsrv_apache_php_fpm` às vezes só reinicia o 80 e ignora o 81). Sempre confirmar com `systemctl is-active ea-php81-php-fpm`.

**Views também passam pelo OPcache** com `validate_timestamps=0` (provável neste servidor). Mudanças em `.php` de view não aparecem até FPM ser reiniciado. Sempre `systemctl restart ea-php81-php-fpm` após deploy de view se a mudança não refletir.

PHP-CLI disponíveis no servidor (12/mai/2026):
- /opt/cpanel/ea-php73/root/usr/bin/php
- /opt/cpanel/ea-php74/root/usr/bin/php
- /opt/cpanel/ea-php80/root/usr/bin/php
- /opt/cpanel/ea-php81/root/usr/bin/php
- /opt/cpanel/ea-php82/root/usr/bin/php
- **/opt/cpanel/ea-php83/root/usr/bin/php** ← versão atual do site (PHP 8.3.30)

Ver também: [[deploy_procedimento]]