Installation | FAQ | Additional important notes | (Alternative) Installation by “hand” |Included extensions | Uninstall | Source code | Thanks | Support | Latest releases
Intro
This package installs the (usually) latest PHP 7.2/7.1/7.0/5.6/5.5/5.4/5.3 on OS X 10.6 (aka Snow Leopard), OS X 10.7 (aka Lion) and OS X 10.8 (aka Mountain Lion) and OS X 10.9 (aka Mavericks) and OS X 10.10 (aka Yosemite) and OS X 10.11 (aka El Capitan) and macOS 10.12 (aka Sierra) and macOS 10.13 (aka High Sierra) in /usr/local/php5. It installs many useful extensions (see below) and ini-settings and is what we at Liip use for our development. It’s especially suited for Symfony 2 development. It also provides a decent php.ini with all settings configured according to “Best Practices”.
It doesn’t install Apache, MySQL or any other external programs. It uses the Apache installation, which comes with OS X and for installing MySQL you can for example useHomebrew. The package is based on entropy’s php package .
One Line Installation
All you need to do to install the whole thing is opening up a Shell and execute the following line:
PHP 7.2 (Next stable) – 10.10 and later
curl -s https://php-osx.liip.ch/install.sh | bash -s 7.2
PHP 7.1 (Current stable) – 10.10 and later
curl -s https://php-osx.liip.ch/install.sh | bash -s 7.1
PHP 7.0 (Old stable) – 10.10 and later
curl -s https://php-osx.liip.ch/install.sh | bash -s 7.0
PHP 5.6 (Old stable) – 10.8 and later
curl -s https://php-osx.liip.ch/install.sh | bash -s 5.6
PHP 5.5 (End of life) – All OS X versions
curl -s https://php-osx.liip.ch/install.sh | bash -s 5.5
PHP 5.4 (End of life) – All OS X versions
curl -s https://php-osx.liip.ch/install.sh | bash -s 5.4
PHP 5.3 (End of life) – All OS X versions
curl -s https://php-osx.liip.ch/install.sh | bash -s 5.3
It will ask you for your password. We install the packager in /usr/local/packer and PHP into /usr/local/php5 and for this, we need your password. We don’t do anything bad with it.
Frequently Asked Questions
Why does php -v on the command line still show my old version?
php-osx doesn’t overwrite the php binaries installed by Apple, but installs everything in /usr/local/php5. The new php binary is therefore in /usr/local/php5/bin/php.
You can also adjust your PATH do include that directory, eg. write into your ~/.profile file the following
export PATH=/usr/local/php5/bin:$PATH
Why is Europe/Zurich the default timezone? Where to change that?
Because we are based in Zurich (and Fribourg and Lausanne). Change the file in /usr/local/php5/php.d/99-liip-developer.ini to adjust that.
It doesn’t take my php.ini values
We introduced our own ini file to be able to easily overwrite the standard values with our recommended values. You can find it in /usr/local/php5/php.d/99-liip-developer.ini
As this is read last, it will overwrite values defined in other files. You can also just delete the file.
Why is the MySQL Socket configured to use /tmp/mysql.sock and how to change that?
If you download the native binary from mysql.com, that server uses /tmp/mysql.sock as its socket location (see this). Therefore we choose that value as default.
You can change that value in /usr/local/php5/php.d/99-liip-developer.ini
How to install pecl extensions?
sudo /usr/local/php5/bin/pecl install pecl_http
Where is the memcached daemon?
We started not including the memcached daemon anymore. But you can install it by hand with
sudo /usr/local/packager/packager.py install tools-memcached
How can I help?
This project is hosted on github here https://github.com/liip/build-entropy-php/. The website itself and install.sh is hosted on https://github.com/liip/php-osx/. It’s all Open Source, so feel free to fork it and send Pull Requests, if you want to change/fix something.
I have more questions. Where to put them?
You have basically three options:
- Open a ticket at https://github.com/liip/php-osx/issues
- Write a tweet, we monitor that and are reachable at @php_osx
- Write on Stack Overflow with the tags “php osx“. We do monitor that, as well
Additional important notes
32 bit only systems (no workie)
It only works on a 64-bit-capable system. This means not on very old hardware with Intel Core Duo and Intel Core Solo processors (see http://support.apple.com/kb/ht3696 for the overview). If anyone wants to make it work on those systems too, please tell us how (We tried, but didn’t came up with anything running in a decent amount of time)
php.ini
The php.ini is located in /usr/local/php5/lib/php.ini, additional config files are located in /usr/local/php5/php.d/. The php.ini is based on php.ini-development
Liip php.ini
The Liip php.ini for development is located in /usr/local/php5/php.d/99-liip-developer.ini.
Re-installs into new directory
All installed files go in a new directory with every update, you have to manually maintain/merge your changes from the old directory! (like pear installs)
apc, twig and xslcache
apc, twig and xslcache need to be enabled manually in /usr/local/php5/php.d/50-extension-$name.ini.
xdebug
xdebug settings needs to be configured (idekey etc) manually in /usr/local/php5/php.d/50-extension-xdebug.ini.
apache error with ulimit
If you are seeing “/usr/sbin/apachectl: line 82: ulimit: open files: cannot modify limit: Invalid argument” when loading apache, here is a fix
More history and all that
See this blog post for even more background info.
(Alternative) Installation by “hand”
If you don’t trust us, here’s the code of install.sh, which you can run by yourself (instead of the one-liner above):
curl -s -o /tmp/packager.tgz https://php-osx.liip.ch/packager/packager.tgz sudo tar -C /usr/local -xzf /tmp/packager.tgz sudo /usr/local/packager/packager.py install 5.4-frontenddev
If you already have installed the packager and just want to update the PHP package, you can do it with the following line.
sudo /usr/local/packager/packager.py install tools-frontenddev
Included extensions
bcmath bz2 calendar Core ctype curl date dom dtrace ereg exif fileinfo filter ftp gd gettext hash iconv imap intl json ldap libxml mbstring mcrypt memcache memcached mhash mongodb odbc mysql mysqli mysqlnd OAuth odbc openssl pcntl pcre PDO pdo_dblib pdo_mysql pdo_pgsql pdo_sqlite pgsql Phar posix Reflection session shmop SimpleXML soap sockets solr SPL SQLite sqlite3 standard sysvmsg sysvsem sysvshm tidy tokenizer wddx xdebug xhprof xml xmlreader xmlrpc xmlwriter xsl zip zlib Xdebug
available but disabled by default: apc, xslcache, twig, uploadprogress
See this output of phpinfo() for more info.
Uninstall
Change in /etc/apache2/httpd.conf
LoadModule php5_module /usr/local/php5/libphp5.so
to
LoadModule php5_module libexec/apache2/libphp5.so
also delete the file +php-osx.conf and +entropy-php.conf in /etc/apache2/other
and optionally remove /usr/local/php5-*
Reinstall
To reinstall an already installed package, it’s version has to be removed from the file /usr/local/packager/registry.log.
sudo $EDITOR /usr/local/packager/registry.log
To forget all installed packages simply remove the file:
sudo rm -rf /usr/local/packager/registry.log
Source Code
- build-entropy-php. Needed for generating the PHP binaries and all the needed libraries
- packager by local.ch. This downloads and install the package on your computer.
- php-osx. The scripts needed for doing the package and this webpage
Thanks
Thanks to Local.ch, which made all the groundwork for this. And thanks to Liip (and especially Patrick) for everything else.
Support
We can’t provide support for this, but Pull Requests are always welcome. And use the github issues page for filing bug reports.
Latest releases
PHP 7.2.2 for OS X 10.10-10.13 uploaded at 2018-02-01 PHP 7.1.13 for OS X 10.10-10.13 uploaded at 2018-02-01 PHP 7.0.27 for OS X 10.10-10.13 uploaded at 2018-02-01 PHP 5.6.33 for OS X 10.10-10.13 uploaded at 2018-02-01 PHP 5.6.33 for OS X 10.8 /10.9 uploaded at 2018-02-01 PHP 5.5.38 for OS X 10.10-10.13 uploaded at 2016-08-31 PHP 5.5.38 for OS X 10.8 /10.9 uploaded at 2016-08-31 PHP 5.5.38 for OS X 10.6 /10.7 uploaded at 2016-08-31 PHP 5.4.45 for OS X 10.10-10.13 uploaded at 2016-03-10 PHP 5.4.45 for OS X 10.8 /10.9 uploaded at 2016-03-10 PHP 5.4.45 for OS X 10.6 /10.7 uploaded at 2015-12-26 PHP 5.3.29 for OS X 10.10-10.13 uploaded at 2014-10-19 PHP 5.3.29 for OS X 10.8 /10.9 uploaded at 2014-08-18 PHP 5.3.29 for OS X 10.6 /10.7 uploaded at 2014-08-14