Skip to content

hugominari/sphp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

sphp - Gerenciador de Versões PHP com Xdebug via Homebrew

Versão: 1.0.6
Autor: Hugo Minari Diniz

✨ Visão Geral

sphp é um script ZSH que permite instalar, trocar, remover e configurar versões do PHP instaladas via Homebrew. Ele também instala e ativa automaticamente o Xdebug, criando ou corrigindo o php.ini mesmo nas versões recentes (ex: PHP 8.4.x).

⚡ Recursos

  • Instala e ativa versões do PHP ([email protected], [email protected], etc.)
  • Atualiza o PATH dinamicamente no ~/.zshrc
  • Instala Xdebug via PECL
  • Cria php.ini quando ausente, com permissão correta
  • Adiciona zend_extension=... para Xdebug automaticamente

⚖ Requisitos

  • macOS com Homebrew
  • Shell ZSH
  • php instalado via Homebrew (brew install php ou php@<versão>)
  • Permissão de sudo para copiar arquivos e modificar /usr/local/bin

📚 Instalação

# Clone este repositório
mkdir -p ~/bin && cd ~/bin
curl -O https://raw.githubusercontent.com/hugominari/sphp/main/sphp.sh
chmod +x sphp.sh

# Instale o script no path padrão
./sphp.sh install-script

❓ Comandos Disponíveis

sphp install <versao>      # Instala o PHP e ativa Xdebug
sphp use <versao>          # Ativa uma versão do PHP já instalada
sphp remove <versao>       # Remove uma versão do PHP e limpa o PATH
sphp list                  # Lista as versões instaladas via brew
sphp install-script [caminho]  # Instala este script como comando 'sphp'

🚀 Exemplo de Uso

sphp install 8.4     # Instala PHP 8.4 e ativa Xdebug automaticamente
php -v               # Deve mostrar "with Xdebug v..."

⚙ Internamente o Script...

  • Detecta e corrige problemas com permissão de pasta /opt/homebrew/etc/php/*
  • Cria php.ini se estiver ausente com config básica:
[PHP]
display_errors = On
error_reporting = E_ALL
  • Encontra dinamicamente o caminho do xdebug.so
  • Reinicia o serviço PHP com brew services restart php

🔗 Integração via Brew Tap (opcional futuro)

brew tap hugominari/tools
brew install sphp

Em desenvolvimento: repositório com Homebrew Formula e suporte a upgrades automáticos.

✅ Resultado Esperado

$ php -v
PHP 8.4.6 (cli) ...
with Xdebug v3.4.2, by Derick Rethans

👤 Licença

MIT License


Contribuições, melhorias e feedbacks são bem-vindos! Hugo Minari Diniz
https://github.com/hugominari

git add . git commit -m "Versão inicial do sphp 1.0.6" git remote add origin [email protected]:hugominari/sphp.git git push -u origin main

About

Simple PHP version manager for macOS using Homebrew — with automatic Xdebug installation and configuration.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages