Skip to main content

IMAP module for PHP in Mac OS X Mountain Lion

So here it comes again. I have recently upgraded to Mountain Lion and for whatever reason, Apple decided to nuked all my previous PHP (among other things) configurations so I have to setup IMAP in PHP again. A simple Google search may point you to this post with detailed instruction for Lion however, some steps have been changed a bit...

Step 1: Install prerequisites

You may choose to download Xcode (FREE) from the App Store then go to menu Xcode > menu item Preferences > tab Downloads, select to install Command Line Tools OR you can go to Apple Developer to get it, you may need to login.

Step 2: Compile IMAP

Get the IMAP source code from University of Washington website. Please do me a favor and check that website for the latest version, it's good practice. If you that lazy, try to click the "y" to get direct link to 2007f version.

Extract the package and open the Terminal to the new directory before executing these command:

  1. make osx EXTRACFLAGS="-arch i386 -arch x86_64 -g -Os -pipe -no-cpp-precomp"
  2. sudo mkdir /usr/local/include/
  3. sudo cp c-client/*.h /usr/local/include/
  4. sudo mkdir /usr/local/lib/
  5. sudo cp c-client/*.c /usr/local/lib
  6. sudo cp c-client/c-client.a /usr/local/lib/libc-client.a

(1) may take a while because the machine need to compile quite a few files for IMAP. Warnings are okie (I got 3 warnings) but if you see some error, that's not good. Please use some Google-fu to figure it out before continuing.
(2) and (4) may tell you the directory has already exists, that's okie and expected.

Step 3: Compile IMAP module for PHP

Following the instruction from PHP: Git Access page to get the source code of PHP. Please note that you should get the same version as the installed PHP engine. By default, Mountain Lion uses PHP 5.3.13 (check this by executing "php -v" in your Terminal).

Basically, you will need to execute 2 commands:
  1. git clone php-src
  2. cd php-src
  3. git checkout PHP-5.3.13
(1) may take a long time depending on your internet connection because the repo is huge.
(2) will check out the branch for a specific PHP version, because my machine uses PHP 5.3.13, I choose the branch "PHP-5.3.13", switch it to match your system.

In order to compile the IMAP module, execute these commands:
  1. cd ext/imap/
  2. phpize
  3. ./configure --with-imap=/usr/local/imap-2007 --with-kerberos --with-imap-ssl
  4. make
  5. sudo cp modules/ /usr/lib/php/extensions/no-debug-non-zts-20090626/
I don't know why Daniel (the author of the original instruction post) got problem compiling IMAP module for PHP (he said PCRE is missing). Probably the PHP shipped with Mountain Lion got PCRE already so the above 5 commands is all I need. Ivan pointed out that Mountain Lion is not shipped with PCRE so you will need to install it yourself.

Now you only need to modify the php.ini file to include the new module. Use your favourite editor to open the file /etc/php.ini (sudo is required to save it FYI), and add this at the end of the file:

; added IMAP module at

Step 4: Enjoy

You are now good to go. Restart Apache as necessary using this: "sudo apachectl graceful".

That's it. Good luck!


  1. This comment has been removed by the author.

  2. Hi Dao,

    a few things I noticed:
    - You are copying stuff directly into /usr/local/include and /usr/local/lib. Since the UW IMAP stuff was obviously not very well namespaced, that's a Bad Idea™. Consider copying stuff into /usr/local/imap-2007f/include and /usr/local/imap-2007f/lib.
    - "--with-imap" option is listed with two equals signs in your tutorial, which breaks down horribly.
    - PCRE is not installed by default on Mountain Lion. You probably installed it previously, or perhaps it was installed for you through MacPorts, Fink or some other way. I didn't have it.
    - You could perhaps fetch just a tarball snapshot generated by GitHub instead of cloning the entire repository.

    Here's what I came up, in form of a bash script.
    Of course, everyone should check every line before running the script, and perhaps run it manually.

    Thanks for a great tutorial!

  3. Thank you Ivan, I have updated the blog post.

  4. I have a problem. I tried to upgrade php to the latest version and this imap file is missing so the installation fails: clang: error: no such file or directory: 'ext/imap/php_imap.o'

    I see there is a php_imap.lo but not a php_imap.o. The other files I see in the install log also have .o extensions but they are all there.

  5. You may have encounter some error while building php_imap.o, check the output to find out the real culprit then?

  6. After running this cmd : git checkout PHP-5.3.10 (as of my version)
    it says
    fatal: Not a git repository (or any of the parent directories): .git

    And running: cd ext/imap/
    it says: -bash: cd: ext/imap/: No such file or directory

    Any help?

  7. @Shashank Duhan: you have to run `git clone` first. If the `git clone` command failed, you may need to read the message.

  8. @Shashank Duhan: I saw the same behavior. Executing "git clone" created a "php-src" subdirectory within my current working directory. I found I had to cd into that "php-src" directory and then I could execute the subsequent "git checkout" command, you will also find ext/imap within the "php-src" directory. Seems like this would always be the case so perhaps the directions should be updated to include a "cd php-src" step, or at least a note mentioning to cd into the created directory, if the name isn't guaranteed to be "php-src".

  9. I have updated the commands to include change directory. Sorry for any confusion.


Post a Comment

Popular posts from this blog

Flutter: Fixing Firebase header not found with Notification Service Extension

If you follow the FCM tutorial Send an image in the notification payload and encountered this error message: 'FirebaseMessaging/FirebaseMessaging.h' file not found You are on the right place, I'm going to show you how to fix it. My app was working fine but one day it stopped compiling. Apparently Flutter 1.20 changed the way it uses CocoaPod so the service extension no longer has the proper library configured. After some tinkering, I came up with this pod config, it has to be added to ios/Podfile below the main Runner target. target 'FcmImage' do use_frameworks! use_modular_headers! require File.expand_path('../.symlinks/plugins/firebase_core/ios/firebase_sdk_version.rb', __FILE__) firebase_sdk_version = firebase_sdk_version! pod 'Firebase/Messaging', "~> #{firebase_sdk_version}" end FcmImage is my extension name, replace it with yours We can use a hardcoded version for Firebase/Messaging pod but doing so m

A faster Docker for Mac experience

Docker for Mac is freaking slow, this is known issue for years. I'm switching to docker-machine running within Parallels for now... Image from Install the tools I use brew to quickly install these: brew install docker-machine brew install docker-machine-parallels Create the virtual machine The --driver param and vm name is required. The others are all optional, the default values are quite low so I bumped the specs a bit. docker-machine create --driver=parallels \   --parallels-cpu-count=2 \   --parallels-disk-size=100000 \   --parallels-memory=4096 \   parallels Usage Set up the shell environment: eval $(docker-machine env parallels) Then use the cli as normal: docker ls docker-compose up -d To get the vm IP address: docker-machine ip parallels