Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shivammathur/homebrew-php
:beer: Homebrew tap for PHP 5.6 to 8.5. PHP 8.5 is built nightly.
https://github.com/shivammathur/homebrew-php
arm64 homebrew homebrew-php homebrew-tap macos php php8
Last synced: 3 days ago
JSON representation
:beer: Homebrew tap for PHP 5.6 to 8.5. PHP 8.5 is built nightly.
- Host: GitHub
- URL: https://github.com/shivammathur/homebrew-php
- Owner: shivammathur
- License: mit
- Created: 2019-12-20T04:09:29.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-19T02:10:17.000Z (3 days ago)
- Last Synced: 2024-12-19T02:27:26.113Z (3 days ago)
- Topics: arm64, homebrew, homebrew-php, homebrew-tap, macos, php, php8
- Language: Ruby
- Homepage: https://github.com/shivammathur/homebrew-php/packages
- Size: 4.94 MB
- Stars: 2,569
- Watchers: 18
- Forks: 174
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-starred-test - shivammathur/homebrew-php - :beer: Homebrew tap for PHP 5.6 to 8.5. PHP 8.5 is built nightly. (Ruby)
README
brew tap shivammathur/php
## PHP Support
| PHP Version | NTS Formula | Debug Formula | ZTS Formula | Debug ZTS Formula |
|---------------|--------------------|--------------------------------|----------------------------|----------------------------------------|
| PHP 5.6 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 7.0 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 7.1 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 7.2 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 7.3 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 7.4 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 8.0 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 8.1 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 8.2 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 8.3 | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
| PHP 8.4 | `php` or `[email protected]` | `php-debug` or `[email protected]` | `php-zts` or `[email protected]` | `php-debug-zts` or `[email protected]` |
| PHP 8.5.0-dev | `[email protected]` | `[email protected]` | `[email protected]` | `[email protected]` |
For each PHP version, we have formulae with thread-safety support `(zts)` and debug symbols support `(debug)` and both `(debug-zts)` as well.
The formulae with debug symbols can be used when building or debugging PHP extensions and are not recommended for production usage.
The formulae with thread-safety support can be used with applications that require multi-threading support.
## OS Support
|Operating System|Architecture|
|--- |--- |
|Linux|`x86_64`|
|macOS Ventura|`x86_64`, `arm64`|
|macOS Sonoma|`x86_64`, `arm64`|
|macOS Sequoia|`x86_64`, `arm64`|
## Usage
### Prerequisites
- On macOS, install Xcode Command Line Utilities:
```zsh
xcode-select --install
```
- On Linux, install cURL and Git:
```bash
# Using APT
sudo apt-get install -y curl git
# Using Yum
sudo yum install -y curl git
```
- Install Homebrew:
```zsh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
```
- If previously installed, update homebrew and the formulae:
```zsh
brew update
```
- If you have packages from old `homebrew/php` tap, refer to [this guide](https://github.com/shivammathur/homebrew-php/wiki/Cleanup) for removing them.
### Add this tap
Fetch the formulae in this tap:
```zsh
brew tap shivammathur/php
```
### Install PHP
> See [PHP Support](#php-support) for available formulae.
- For example, to install `PHP 8.4`:
```zsh
brew install shivammathur/php/[email protected]
```
- After installing you have to link it:
```zsh
brew link --overwrite --force shivammathur/php/[email protected]
```
- Restart the terminal and test your PHP version:
```zsh
php -v
```
### Upgrade your PHP version
You can upgrade your PHP version to the latest patch release.
For example, to upgrade `PHP 8.4`:
```zsh
brew upgrade shivammathur/php/[email protected]
```
### Switch between PHP versions
- If you have multiple PHP versions installed, you can switch between them easily.
For example, to switch to `PHP 8.4`:
```zsh
brew link --overwrite --force shivammathur/php/[email protected]
```
- If you get a warning like below, then do as recommended:
```zsh
Warning: Already linked:
To relink:
brew unlink && brew link
```
```zsh
brew unlink [email protected]
brew link --overwrite --force shivammathur/php/[email protected]
```
### Restart your webserver
If you are using `Apache` or `Nginx` with `php-fpm`, restart your webserver after any change in your PHP.
- For Apache (`httpd`):
```zsh
brew services restart httpd
```
- For Nginx:
```zsh
brew services restart nginx
```
## Debugging
- Make sure you ran `brew update` before installing PHP.
- Run `brew doctor` and fix the warnings it reports.
- Make sure homebrew has correct permissions.
```zsh
sudo chown -R "$(id -un)":"$(id -gn)" $(brew --prefix)
```
- If PHP is not working after a macOS update. Reinstall PHP along with its dependencies.
For example to reinstall `PHP 8.4` and its dependencies:
```zsh
brew reinstall $(brew deps shivammathur/php/[email protected]) shivammathur/php/[email protected]
```
- Check if your issue is a Homebrew's [common issue](https://docs.brew.sh/Common-Issues).
- If you are still facing an issue, please create a discussion thread [here](https://github.com/shivammathur/homebrew-php/discussions).
## License
The code in this project is licensed under the [MIT license](http://choosealicense.com/licenses/mit/).
Please see the [license file](LICENSE) for more information.
This project has some [dependencies](#dependencies), and their license can be found [here](LICENSE_HOMEBREW).
## Contributions
Contributions are welcome!
Please see [Contributor's Guide](.github/CONTRIBUTING.md "shivammathur/homebrew-php contribution guide") before you start.
If you face any issues while using this tap or want to suggest a feature/improvement, create an discussion thread [here](https://github.com/shivammathur/homebrew-php/discussions "shivammathur/php discussions").
## Sponsors
In addition to GitHub Actions, we use [MacStadium](https://www.macstadium.com/opensource/members) for our CI infrastructure.
This project is generously supported by many other users and organisations via [GitHub Sponsors](https://github.com/sponsors/shivammathur).
## Related Projects
- [shivammathur/homebrew-extensions](https://github.com/shivammathur/homebrew-extensions "Tap for PHP extensions")
- [shivammathur/setup-php](https://github.com/shivammathur/setup-php "Setup PHP in GitHub Actions")
## Dependencies
- [Homebrew/brew](https://github.com/Homebrew/brew "Homebrew GitHub Repo")
- [Homebrew/homebrew-core](https://github.com/Homebrew/homebrew-core "Homebrew core tap")
- [Homebrew/actions](https://github.com/Homebrew/actions "Homebrew GitHub Actions")