Running the command Heroku local with PHP 8, nginx and php-fpm on macOS

Hi there!

I was trying to get the heroku local command running in my macOS Monterey but I stumbled in some issues. Then I'd like to share with you my process to get that working.

First things first, check if you have your require-dev section into your composer with that library:

    "require-dev": {
        "heroku/heroku-buildpack-php" : "*",

After that, add this tap to homebrew:

brew tap shivammathur/php

Right after, run these commands:

brew install shivammathur/php/php@8.0

brew link --overwrite --force shivammathur/php/php@8.0

Sometimes you need to restart your terminal to see php running and available to use. So if you run: php -v you're going to see current php version installed on macOS.

Now try to run heroku local and whether it works we don't need to change anything but if doesn't and you're seeing messages telling you something like these:

• php command not found
• php-fpm command not found

So I can help you, it happens because you need to add right folder with binaries from php8, what I did was:

echo 'export PATH="/usr/local/Cellar/php@8.0/8.0.14/sbin:$PATH"' >> ~/.zshrc

Restart you terminal after that command and now you can type for instance: php-fpm and it's there!

Now heroku local should work!