claude-plugins/infraestrutura/skills/cwp-php/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
cwp-php	Gestão de versões PHP no CWP — PHP Switcher, Selector e configuração baseada na documentação oficial.	true

/cwp-php - Gestão PHP CWP (Documentação Oficial)

Gestão de versões PHP no CWP. Zero assumptions, zero hallucinations - apenas informação documentada.

REGRA #38 - ZERO INVENCAO: NUNCA improvisar comandos. Verificar estado actual ANTES de alterar. Pesquisar wiki CWP se necessario. Usar APENAS scripts oficiais.

---

Servidor Alvo

Servidor	IP	MCP	User
CWP Principal	176.9.3.158	ssh-unified	root

---

Documentação Base

• PHP Selector
• PHP Version Switcher
• CWP Scripts

Documentação Hub (Consultar SEMPRE)

Manuais locais (Hub/06-Operacoes/Documentacao/Manuais/CWP/):

• CWP-Manual-Completo.md - Admin Guide (seccao PHP Settings, Switcher, Selector, FPM, PECL) + Wiki (PHP Configuration) - 503KB
• CWP-Guia-do-Utilizador.md - Painel utilizador (seccao Edit PHP.ini, PHP Selector) - 72KB

Quick Reference: Hub/06-Operacoes/Documentacao/Quick-Reference/QR-CWP.md

NotebookLM (pesquisa AI sobre toda a documentacao CWP):

mcp__notebooklm__notebook_query notebook_id:"0ded7bd6-69b3-4c76-b327-452396bf7ea7" query:"php versao selector switcher fpm configuracao"

---

Ferramentas PHP no CWP

O CWP oferece 3 ferramentas para gerir PHP:

Ferramenta	Função
PHP Switcher	Versão principal do CWP (default para novos clientes)
PHP Selector	Permite diferentes versões por pasta/domínio
PHP-FPM Selector	Para sites que usam PHP-FPM

---

Versões PHP Disponíveis (Documentadas)

PHP Selector suporta: 4.4, 5.2, 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1

---

Paths de Configuração

Path	Descrição
/usr/local/cwpsrv/htdocs/resources/conf/el7/php_switcher/	Config CentOS 7
/usr/local/cwpsrv/htdocs/resources/conf/el8/php_switcher/	Config CentOS 8
/var/log/php-rebuild.log	Log de compilação PHP

---

Monitorizar Compilação PHP

# Ver log em tempo real durante instalação de versão PHP
tail -f /var/log/php-rebuild.log

# Ver log completo
cat /var/log/php-rebuild.log

---

Scripts Oficiais

Script	Descrição
/scripts/phpfpm_rebuild_user_conf	Rebuild configuração PHP-FPM de utilizadores

sh /scripts/phpfpm_rebuild_user_conf

---

PHP por Pasta (Documentado)

Cada utilizador pode ter versão PHP diferente por pasta usando .htaccess:

# Exemplo .htaccess para usar PHP específico numa pasta
# (configurar via CWP PHP Selector primeiro)

---

Desactivar Funções Perigosas (Documentado)

PHP Switcher

echo "disable_functions = exec, system, popen, proc_open, shell_exec, passthru, show_source" > /usr/local/php/php.d/disabled_function.ini

Nota: Cada versão PHP tem caminho diferente.

---

Adicionar Flags de Compilação (Documentado)

Ficheiro exemplo CentOS 7 PHP 7.0: /usr/local/cwpsrv/htdocs/resources/conf/el7/php_switcher/7.0.ini

Formato

[nome-unico]
default=0
option="--enable-opcao"

Aviso documentado: "CWP update will overwrite these files" - documentar alterações para reaplicar após updates.

---

Verificações

Versão PHP Actual

php -v

Memory Limit

php -i | grep memory_limit

OPcache Status

php -i | grep -E 'opcache.enable|opcache.memory_consumption'

Processos PHP-FPM

ps aux | grep php-fpm | wc -l

---

Workflows

1. Verificar Versão PHP

php -v | head -1

2. Ver Configuração PHP

php -i | grep -E 'memory_limit|upload_max|post_max|max_execution'

3. Rebuild PHP-FPM Config

sh /scripts/phpfpm_rebuild_user_conf

4. Monitorizar Instalação de Versão PHP

tail -f /var/log/php-rebuild.log

---

Anti-Patterns (NUNCA FAZER)

Anti-Pattern	Risco	Alternativa
Editar .ini sem documentar	Perdido em update	Documentar alterações
Compilar PHP manualmente	Conflito com CWP	Usar PHP Selector
Ignorar php-rebuild.log	Não detectar erros	Monitorizar sempre

---

Notas Importantes

1. PHP Switcher é a versão default para novos utilizadores
2. PHP Selector permite versão por pasta
3. Updates do CWP podem sobrescrever configurações personalizadas
4. Sempre documentar alterações para reaplicar

---

Checklist

• Verificar versão actual (php -v)
• Verificar configuração (php -i)
• Se alterar, documentar mudanças
• Testar sites após alterações
• Verificar logs se problemas

---

Contexto NotebookLM

ANTES de executar, consultar notebooks para contexto especializado:

Notebook	ID	Consultar quando
WordPress Config CLI	fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d	Sempre

mcp__notebooklm__notebook_query({
  notebook_id: "fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d",
  query: "<adaptar ao contexto de PHP versões e configuração CWP>"
})

Integrar insights do NotebookLM nas recomendações e decisões.

---

Versão: 1.0.0 | Autor: Descomplicar® Fonte: wiki.centos-webpanel.com/php-selector, wiki.centos-webpanel.com/php-version-switcher