How do I skip Apache config when switching PHP versions with brew-php-switcher?

Use the -s flag, such as 'brew-php-switcher 8.0 -s' to skip Apache entirely, or 'brew-php-switcher 8.0 -s=apache' to skip only Apache while updating other configs. This is useful if you're only working with CLI or Valet.

Brew PHP Switcher vs using Docker for managing PHP versions on Mac?

Brew PHP Switcher is faster for local switches on macOS with Homebrew, ideal for quick project changes. Docker offers isolated, reproducible environments that work across platforms but requires more setup and overhead.

Does Brew PHP Switcher work with PHP 8.4?

Yes, the README indicates support for PHP 8.4 in the installation examples, but ensure you have the corresponding Homebrew package installed. Always check the latest documentation for version compatibility.

Can I use Brew PHP Switcher with Nginx instead of Apache?

No, it's designed specifically for Apache and Valet configurations. For Nginx, you'd need to manually update server blocks or use other tools like Laravel Valet's custom drivers.

What happens if I switch PHP versions while multiple projects are running?

It changes the global PHP version for Apache and CLI, so all projects will use the new version simultaneously. This isn't ideal for concurrent multi-version testing; consider using separate virtual hosts or Docker containers for that.

How to troubleshoot Apache not loading the PHP module after switching?

First, ensure the native OS X PHP module is commented out in your Apache config as per the caveats. Then, verify that Homebrew's PHP module path is correctly added by the script, and restart Apache with 'sudo apachectl restart'.

Open-Awesome

Brew PHP Switcher

MITShellv2.6

A simple shell script to switch Apache and CLI configurations between major PHP versions for Homebrew users on macOS.

GitHub

1.0k stars92 forks0 contributors

What is Brew PHP Switcher?

Brew PHP Switcher is a command-line tool that automates switching between different major versions of PHP on macOS systems where PHP is installed via Homebrew. It updates both Apache web server configurations and the command-line PHP version with a single command, solving the problem of manually editing config files when working on multiple projects with incompatible PHP requirements.

Target Audience

PHP developers on macOS who use Homebrew to manage PHP installations and need to frequently switch between different PHP versions for various projects, such as those maintaining legacy applications alongside modern ones.

Value Proposition

Developers choose Brew PHP Switcher because it eliminates the tedious, error-prone process of manually updating Apache and CLI configurations, providing a reliable, scripted solution that ensures consistency and saves time when managing multiple PHP environments.

Overview

Brew PHP switcher is a simple shell script to switch your apache and CLI quickly between major versions of PHP. If you support multiple products/projects that are built using either brand new or old legacy PHP functionality. For users of Homebrew (or brew for short) currently only.

Use Cases

Best For

Switching PHP versions for Apache web server on macOS
Managing CLI PHP versions across different projects
Working with legacy PHP applications (5.6, 7.x) and modern ones (8.x)
Automating PHP environment configuration for Homebrew users
Reducing manual config edits when testing across PHP versions
Setting up development environments for multiple PHP-based products

Not Ideal For

Developers using operating systems other than macOS, such as Linux or Windows
Projects where PHP is installed via methods other than Homebrew, like MacPorts or direct system installation
Environments using web servers like Nginx instead of Apache
Teams that require running multiple PHP versions simultaneously via virtual hosts or containers

Pros & Cons

Pros

Quick Version Switching

Switches between PHP versions from 5.6 to 8.4 with a single command, automating updates to both Apache and CLI configurations without manual edits.

Apache Integration

Automatically modifies Apache config to use the correct Homebrew PHP module, as detailed in the README's caveats, ensuring seamless web server compatibility.

CLI Synchronization

Updates the command-line PHP version to match the selected version, maintaining consistency across development tools and scripts.

Selective Configuration

Allows skipping or targeting specific configs like Apache or Valet using -s and -c flags, providing flexibility for different setup needs.

Cons

Platform and Tool Lock-in

Only works on macOS with PHP installed via Homebrew, making it useless for cross-platform development or alternative package managers.

Manual Pre-configuration Required

Requires commenting out the native OS X PHP module in Apache config before use, as stated in the caveats, which can be error-prone for newcomers.

Limited Web Server Support

Primarily focuses on Apache; while Valet is supported, other servers like Nginx are not handled, forcing manual adjustments for broader setups.

Frequently Asked Questions

Related Projects

PHP Brew

Brew & manage PHP versions in pure PHP at HOME

Stars5,526

Forks364

Last commit5 months ago

Static PHP CLI

Build standalone portable PHP binaries on Linux, macOS, Windows, with PHP project together, with popular extensions included.

Builds PHP so that multiple versions can be used side by side.

Stars1,048

Forks158

Last commit18 days ago

Homebrew

A package manager for macOS

Stars0

Forks0

Last commit

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub