Skip to content

Installation on macOS

The installation process does not differ to the general installation but on several macOS systems you may use different config values as described below.


Follow the general installation guide and then use the macOS specific settings below.

Most macOS Apache services does not work with the default Unix socket defined in your php.ini (as it could be of the wrong loaded PHP profile), so you have to define an additional Unix socket inside your dsn configuration of the database component:


'dsn' => 'mysql:host=localhost;dbname=luyaweb;unix_socket=/Applications/MAMP/tmp/mysql/mysql.sock',


'dsn' => 'mysql:host=localhost;dbname=luyaweb;unix_socket=/Applications/XAMPP/xamppfiles/var/mysql/mysql.sock',

Misc issues

Create or use the existing .bash_profile or .profile file in your home folder (cd ~) with following content

export PATH=/Applications/MAMP/bin/php/php5.6.2/bin:$PATH

After editing this file needs be reloaded by running the following command in your terminal:

source ~/.bash_profile

If you've ZSH installed, add the above "export" line to the end of the .zshrc file in your home directory (~/.zshrc).

Change the PHP version to your current active PHP version. To verify and test this informations use:

which php
php -i

Visit the installation problems and questions site if you get any problems with the LUYA setup.