Signing commits in PhpStorm on OS X

First of all, you should generate a new GPG key (if you don't have any), add it to your Github profile and tell your local Git installation to use it. This is nicely covered in the Github help. (Installing GPG on Mac is as easy as brew install gpg2 gpg-agent.)

Good. Now tell Git to sign all commits automatically:

$ git config commit.gpgsign true

This works within the current working directory. If you want Git to sign all commits, just add --global in there. Continue by configuring GPG - add these two lines to ~/.gnupg/gpg.conf:

no-tty
use-agent

They tell GPG not to enforce running from within a terminal session so that it can be run from other programs like PhpStorm, and to use gpg-agent so that you don't have to type your passphrase for every commit you make.

This should be it. But it's not. Yet. There's this one more thing. Now GPG doesn't have to run from terminal, but it's missing a GUI. For Mac, there is pinentry-mac. Install it (brew install pinentry-mac) and tell gpg-agent to use it in ~/.gnupg/gpg-agent.conf:

pinentry-program /usr/local/bin/pinentry-mac

Now you're done. You should be able to commit from PhpStorm without getting any errors and failures, and if you push to Github, your commits should have a nice green Verified marking :)