First part in French, 2nd part in English

Edit 01/12/2013 : Le site a migré de php/mysql à Python/Jinja2 avec un hébergement gratuit sur AppEngine. En lisant ce dernier article je constate que Apache/MySQL est extrêmement compliqué et que c'est avec soulagement que l'on ne s'en sert plus. Si vous souhaitez installer MAMP juste pour utiliser phpMyAdmin, abandonnez l'idée. Un logiciel pour ouvrir une base de données MySQL (sans installer MAMP) est beaucoup plus adapté pour éditer/utiliser une base de données en local. Et SQLite est encore mieux si l'on a le courage de migrer ses données. Et si vous aimez le Python, abandonnez le php.

Si vous êtes sur Mac OS Lion et que vous cherchez à avoir MAMP, vous êtes au bon endroit, que ce soit parce que vous n'y connaissez rien et que vous voulez simplement avoir un petit site en php/mysql sur votre ordi ou soit parce que vous avez peur d'avoir tout bousillé votre précédente config en passant à Lion. C'est mon cas, j'ai du réinstaller MAMP puis modifier tout un tas de fichiers config d'apache car MAMP ne permettait pas de faire des symlinks vers ~/Sites et je ne voulais pas déplacer mes fichiers vers MAMP/htdocs. J'ai bien du passer 10 heures à me dépatouiller avec tout un tas de choses et donc je souhaite aider ceux qui ont été dans ma situation.

Bref voici comment faire : plan d'action avant d'entrer dans les détails.

• Oubliez MAMP. Ils avaient une version qui tournaient très bien sur 10.5/6, ils ont changé les choses en moins bien, tant pis pour eux. Il n'y a plus de widget, il faut maintenant déplacer ses fichiers dans leur répertoire htdoc, ... Et une fois que j'avais réussi à faire tout ça, MySQL ne marchait plus.
• Apache est déjà installé sur votre Mac normalement mais il manque peut être quelques modules. On va juste installer MySQL et phpMyAdmin et les quelques modules manquant à Apache pour faire propre.
• Avant de faire quoique ce soit, assurez vous d'avoir sauvegardé vos bases de données, si vous en aviez, dans un fichier .txt (demander l'export SQL)

Préliminaire

Installer Homebrew : /usr/bin/ruby -e "$(/usr/bin/curl -fksSL https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)". C'est un utilitaire similaire à MacPorts. Seulement j'ai suivi beaucoup de tutoriels pour résoudre mon problème qui demandaient d'installer des choses avec MacPorts et à chaque fois il y avait un problème et je ne pouvais pas terminer les installations.

Installation de MySQL

brew install mysql
unset TMPDIR
mysql_install_db --verbose --user=`whoami` --basedir="$(brew --prefix mysql)" --datadir=/usr/local/var/mysql --tmpdir=/tmp
sudo mkdir /var/mysql
sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock

Initialisation de MySQL avec création d'utilisateur "root" et mot de passe "root". Vous pouvez bien sûr changer mais bon, c'est courant de prendre ça.

mysql.server start
mysqladmin -u root password root
mysqladmin -u root  -h localhost
mysql.server start

Installation de Apache/php

Ceci est facultatif, c'est seulement si vous avez peur d'avoir touché à trop de fichiers de config et que plus rien ne fonctionne.

rm -f ~/.pearrc
rm -rf ~/.pear
brew unlink php
brew install autoconf
sudo chmod a+w /usr/local/share/emacs/
sudo chmod a+w /usr/local/share/emacs/site-lisp/
brew link autoconf
brew tap josegonzalez/homebrew-php
brew install php --with-mysql --with-apache
open ~/.bashrc

#Ajoutez ces deux lignes puis sauvegardez le fichier
alias pear="php /usr/lib/php/pear/pearcmd.php"
alias pecl="php /usr/lib/php/pear/peclcmd.php"

source ~/.bashrc
pear config-set auto_discover 1
pear update-channels
pear upgrade
sudo pecl install apc-beta mongo memcachepear install pear.phpunit.de/PHPUnit
sudo pear install PHP_CodeSniffer-beta
sudo pear install pear.phpunit.de/PHPUnit
brew link php

Modification de la config d'Apache

Ceci n'est pas facultatif.

Maintenant qu'on a installé pas mal de trucs il faut modifier les fichiers de config d'Apache pour qu'il lise nos sites dans ~/Sites, qu'il accepte php5 et d'autres petites choses.

sudo chmod a+w v /etc/apache2/httpd.conf
open /etc/apache2/httpd.conf

Un fichier s'ouvre. On va modifier plusieurs lignes. Je conseille de ne pas remplacer les lignes déjà existantes mais de les copier, de les commenter en écrivant à côté "changeThomas" (ou ce que vous voulez), puis de modifier la copie de la ligne non commentée. Comme ça quand vous reviendrez modifier le fichier dans 1 an vous pourrez savoir exactement qu'est ce qui était d'origine et qu'est ce que vous avez rajouté.

• Vers la ligne 111, juste après LoadModule rewrite_module libexec/apache2/mod_rewrite.so, vérifiez que vous avez la ligne LoadModule php5_module libexec/apache2/libphp5.so. Si elle n'y est pas, ajoutez là :

  # ajout changeThomas
  LoadModule php5_module libexec/apache2/libphp5.so

Cherchez la ligne DocumentRoot "/Library/WebServer/Documents et remplacez par :

# DocumentRoot "/Library/WebServer/Documents changeThomas
DocumentRoot "/Users/Thomas/Sites"

(ou n'importe quel autre endroit où vous stockez vos sites web, et remplacez Thomas par votre nom d'utilisateur ('whoami' dans le Terminal).
• Il y avait en fait 2 lignes comme ça (lignes 247 et 275 environ), modifiez les 2.
• ligne 297 : remplacez AllowOverride None par : AllowOverride All
• vers la ligne 674, il y a dans les options de php5 : DirectoryIndex index.html. Remplacez par DirectoryIndex index.html index.php

Même chose sur /etc/php.ini :

sudo chmod a+w /etc/php.ini
open  /etc/php.ini

• Vers la ligne 816, mettez enable_dl = On
• vers la ligne 881, upload_max_filesize = 100M
• post_max_size = 100M

Les dernières lignes vous permettront via phpMyAdmin de gérer des grosses bases de données (pour pouvoir en importer / exporter). 2Mo est assez ridicule.

Installation de phpMyAdmin

phpMyAdmin est un petit site web qui tournera en local qui vous permet de voir, modifier, ... vos bases de données MySQL.

brew install phpmyadmin
mkdir /usr/local/share/phpmyadmin/config
sudo chmod o+w /usr/local/share/phpmyadmin/config

Création de fichier : open /etc/apache2/other/mod_phpmyadmin.conf

# changeThomas: rien dans ce fichier avant
AliasMatch ^/phpmyadmin(?:/)?(/.*)?$ "/usr/local/share/phpmyadmin$1"


  Options -Indexes
  AllowOverride None
  Order allow,deny
  Allow from all

  LanguagePriority fr en es de ja ko pt-br ru
  ForceLanguagePriority Prefer Fallback

phpMyAdmin a besoin de libmcrypt (une librairie de php). Désolé pour cette partie fastidieuse, surtout qu'elle est quasi optionnelle puisque phpMyAdmin affiche des avertissements si l'on n'a pas cette librairie mais les choses devraient marcher quand même (vos sites en php et mysql).

Téléchargez Libmcrypt et dernière version de php

Créez un dossier nommé SourceCache sur le bureau, placez-y les zip que vous venez de télécharger et dézippez les.

Téléchargez aussi Xcode 4.1 tools sur l'App Store et installez les.

cd ~/Desktop/SourceCache
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --disable-dependency-tracking
cd libmcrypt-2.5.8
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --disable-dependency-tracking
make -j6
sudo make install
cd ../php-5.3.6/
cd ext/mcrypt/
/usr/bin/phpize
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --with-php-config=/Developer/SDKs/MacOSX10.7.sdk/usr/bin/php-config
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --with-php-config=/usr/bin/php-config
make -j6
sudo make install

Configuration de phpMyAdmin

phpMyAdmin a un seul petit truc embêtant : il nous demande notre mot de passe à chaque fois que l'on s'en sert et toutes les 10 minutes. Le mieux est je pense de désactiver le mot de passe surtout si vous êtes le seul à vous servir de votre ordinateur.

Ouvrez /usr/local/share/phpmyadmin/config.inc.php et vérifiez que vous avez ces lignes :

$cfg['Servers'][$i]['verbose'] = '';

$cfg['Servers'][$i]['host'] = 'localhost';

$cfg['Servers'][$i]['port'] = '';

$cfg['Servers'][$i]['socket'] = '';

$cfg['Servers'][$i]['connect_type'] = 'tcp';

$cfg['Servers'][$i]['extension'] = 'mysqli';

$cfg['Servers'][$i]['auth_type'] = 'config';

$cfg['Servers'][$i]['user'] = 'root';

$cfg['Servers'][$i]['password'] = '';

$cfg['Servers'][$i]['AllowNoPassword'] = true;

$cfg['Servers'][$i]['AllowNoPasswordRoot'] = true;

Utilisation

Ouf ça devrait être fini. Reste maintenant à lancer tout ça. Pour que vos sites soient accessibles en local, il faut 1) démarrer le serveur apache et 2) lancer mysql (facultatif si votre site ne se connecte pas à des bases de données)

Apache peut se démarrer soit par Préférences Système -> Partage -> cocher "partage web", soit par ligne de commande : sudo /usr/sbin/apachectl start (ou restart ou stop)

MySQL se lance juste avec mysqld &

Vous pouvez bien sûr demander à votre mac de lancer Apache et MySQL au démarrage de votre ordinateur, mais il sera forcément un poil plus lent à démarrer. Si oui, faites open /System/Library/LaunchDaemons/org.apache.httpd.plist et faites en sorte que vous avez ce fichier :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Disabled</key>
  <true/>
  <key>Label</key>
  <string>org.apache.httpd</string>
  <key>OnDemand</key>
  <false/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/sbin/httpd</string>
    <string>-D</string>
    <string>FOREGROUND</string>
    <string<-D>/string>
    <string<WEBSHARING_ON>/string>
  </array>
  <key>SHAuthorizationRight</key>
  <string>system.preferences</string>
</dict>
</plist>

Attention, mysqld plante parfois pour démarrer si le serveur n'a pas été éteint la dernière fois qu'on n'a pas éteint son ordi. On peut lancer le moniteur d'activité et quitter le processus "mysqld" pour le relancer via le terminal, ou faire ps | grep mysqld | grep -v 'grep' | cut -d" " -f3 | xargs kill {}; mysqld &. Je vous invite à vous faire un alias dans votre .bashrc !

Une fois tout ça fait, vous devriez pouvoir accéder à http://localhost/phpmyadmin/index.php et à vos sites web !

Si j'ai oublié de citer une étape, merci de me dire où ça bloque, j'essayerai de vous aider !

Edit 01/12/2013 : Think about it twice before installing MAMP. The website migrated from php/mysql to Python/Jinja2 with free hosting from Google AppEngine. Taking a step back from this blog post, I realize how difficult it is to work with Apache/MySQL. It is with a great relief that we moved out. If you just need phpMyAdmin to read local MySQL databases, use a dedicated free software, no need of MAMP. SQLite is even better if you have the time to slightly convert your data. And if you like Python and you have veryl ittle php code, give up on php.

If you are on Mac OS Lion and you try to get MAMP fully functional, you are at the right place, either because you don't know much and just want to have a local php/MySQL local website or because you messed up a lot of config files trying to migrate from 10.6 to 10.7. This is the reason of the existence of this tutorial. I couldn't get MAMP working properly, I didn't want to move my websites from ~/Sites to MAMP/htdoc and symlinks were failing. After reading hundreds of good and bad tutorials, here is a (hopefully) good way to get everything set up on your machine.

Summary of what we are going to do, before getting into the nitty gritty

• Forget about MAMP. It is not the core of php/mysql. It is a mere wrapper that turns them on/off. It was really convenient before 10.7, but now they have no widget, we have to move our websites to their htdoc directory, ...
• Apache is already installed on your Mac. Let's take advantage of it !
• We will just install few missing modules to Apache, MySQL and phpMyAdmin.
• Before doing anything, export your current databases as text files (SQL commands) and keep them in a safe place.

Preliminaries

Install Homebrew : /usr/bin/ruby -e "$(/usr/bin/curl -fksSL https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)". This is a utility similar to MacPorts. Many other tutorials to solve MAMP problems ask you to use MacPorts but it always broke somewhere for me and I always had a few dependencies missing.

Installation of MySQL

brew install mysql
unset TMPDIR
mysql_install_db --verbose --user=`whoami` --basedir="$(brew --prefix mysql)" --datadir=/usr/local/var/mysql --tmpdir=/tmp
sudo mkdir /var/mysql
sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock

Initialisation of MySQL with username "root" and password "root" (very common).

mysql.server start
mysqladmin -u root password root
mysqladmin -u root  -h localhost
mysql.server start

Installation of Apache/php

This is optional, do it only if nothing works fine and you changed apache config files without knowing what you were doing (don't be ashamed, anyone does that, there is no need to try to understand what's really happening when typing all these commands).

rm -f ~/.pearrc
rm -rf ~/.pear
brew unlink php
brew install autoconf
sudo chmod a+w /usr/local/share/emacs/
sudo chmod a+w /usr/local/share/emacs/site-lisp/
brew link autoconf
brew tap josegonzalez/homebrew-php
brew install php --with-mysql --with-apache
open ~/.bashrc

#Add those 2 lines then save the file
alias pear="php /usr/lib/php/pear/pearcmd.php"
alias pecl="php /usr/lib/php/pear/peclcmd.php"

source ~/.bashrc
pear config-set auto_discover 1
pear update-channels
pear upgrade
sudo pecl install apc-beta mongo memcachepear install pear.phpunit.de/PHPUnit
sudo pear install PHP_CodeSniffer-beta
sudo pear install pear.phpunit.de/PHPUnit
brew link php

Modification of Apache's config

This is not optional.

Now that lots of stuff are installed, we need to tell Apache that our home directory for websites is ~/Sites, tell him to accept php5 and few other things.

sudo chmod a+w v /etc/apache2/httpd.conf
open /etc/apache2/httpd.conf

This opens a file. I advise that every time you change a line in a config file, you make a copy of the original line that you are modifying and comment it out just above your modification.

• Around line 111, just after LoadModule rewrite_module libexec/apache2/mod_rewrite.so, check that LoadModule php5_module libexec/apache2/libphp5.so is there. If not, add it with no quotes.

  # add changeThomas
  LoadModule php5_module libexec/apache2/libphp5.so

Look up for line DocumentRoot "/Library/WebServer/Documents and remplace it by:

# DocumentRoot "/Library/WebServer/Documents changeThomas
DocumentRoot "/Users/Thomas/Sites"

(any place where you want your Sites home directory to be, no tilde ~, and change my name by yours !). This should be line number 247 give or take.
• There is another line like that, change it too. (line 275)
• line 297 : replace AllowOverride None by : AllowOverride All
• line 674, in the options of php5 : DirectoryIndex index.html. Replace by DirectoryIndex index.html index.php

Same thing with /etc/php.ini :

sudo chmod a+w /etc/php.ini
open /etc/php.ini

• Around line 816, put enable_dl = On
• around line 881, upload_max_filesize = 100M
• post_max_size = 100M

The 2 last changes will enable you to use phpMyAdmin with databases larger than 2 or 8 Mo.

Installation of phpMyAdmin

phpMyAdmin is like a little local website that helps you create, modify, ... your MySQL databases.

brew install phpmyadmin
mkdir /usr/local/share/phpmyadmin/config
sudo chmod o+w /usr/local/share/phpmyadmin/config

Create file :
open /etc/apache2/other/mod_phpmyadmin.conf

# changeThomas: empty file before
AliasMatch ^/phpmyadmin(?:/)?(/.*)?$ "/usr/local/share/phpmyadmin$1"


  Options -Indexes
  AllowOverride None
  Order allow,deny
  Allow from all

  LanguagePriority fr en es de ja ko pt-br ru
  ForceLanguagePriority Prefer Fallback

phpMyAdmin needs libmcrypt (a php library) to run. Sorry for this fastidious part, even though almost optional, if you really can't make this part work move on things are gonna be ok but you will have ugly warnings in phpMyAdmin.

DownloadLibmcrypt and the last version of php.

Make a directory called SourceCache on your desktop and put them the 2 zip files and unzip them there.

Install Xcode 4.1 tools from the App Store.

cd ~/Desktop/SourceCache
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --disable-dependency-tracking
cd libmcrypt-2.5.8
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --disable-dependency-tracking
make -j6
sudo make install
cd ../php-5.3.6/
cd ext/mcrypt/
/usr/bin/phpize
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --with-php-config=/Developer/SDKs/MacOSX10.7.sdk/usr/bin/php-config
MACOSX_DEPLOYMENT_TARGET=10.7 CFLAGS='-O3 -fno-common -arch i386 -arch x86_64' LDFLAGS='-O3 -arch i386 -arch x86_64' CXXFLAGS='-O3 -fno-common -arch i386 -arch x86_64' ./configure --with-php-config=/usr/bin/php-config
make -j6
sudo make install

Configure phpMyAdmin

phpMyAdmin has just one little drawback : it asks for your password everytime you turn it on and then every 10 minutes. If you are the only one using your computer the best is to deactivate this.

Open /usr/local/share/phpmyadmin/config.inc.php and be sure you have these lines:

$cfg['Servers'][$i]['verbose'] = '';
$cfg['Servers'][$i]['host'] = 'localhost';
$cfg['Servers'][$i]['port'] = '';
$cfg['Servers'][$i]['socket'] = '';
$cfg['Servers'][$i]['connect_type'] = 'tcp';
$cfg['Servers'][$i]['extension'] = 'mysqli';
$cfg['Servers'][$i]['auth_type'] = 'config';
$cfg['Servers'][$i]['user'] = 'root';
$cfg['Servers'][$i]['password'] = '';
$cfg['Servers'][$i]['AllowNoPassword'] = true;
$cfg['Servers'][$i]['AllowNoPasswordRoot'] = true;

Time to play

You should be (almost) all set. Let's run everything now. For your website to run locally, you need to 1) start the apache server and 2) run a mysql server (if your website needs).

Apache can be started via Preferences Pane -> Sharing -> tick "web sharing", or via command line : sudo /usr/sbin/apachectl start (or restart or stop)

MySQL can be run with mysqld &

You can of course ask your system to fire them at start up time but your computer will be slightly slower to boot. If you want, open /System/Library/LaunchDaemons/org.apache.httpd.plist and throw this config in:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Disabled</key>
  <true/>
  <key>Label</key>
  <string>org.apache.httpd</string>
  <key>OnDemand</key>
  <false/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/sbin/httpd</string>
    <string>-D</string>
    <string>FOREGROUND</string>
    <string<-D>/string>
    <string<WEBSHARING_ON>/string>
  </array>
  <key>SHAuthorizationRight</key>
  <string>system.preferences</string>
</dict>
</plist>

Watchout, mysqld fails to start when you didn't stop it before turning off your computer. You must open the activity monitor and quit it, or ps | grep mysqld | grep -v 'grep' | cut -d" " -f3 | xargs kill {}; mysqld & to kill and re-run it. Time to make an alias in your .bashrc !

Once this is all done, you should be able to access http://localhost/phpmyadmin/index.php and your websites !

If something is not working / I forgot a step, please don't hesitate to post a message here.

Autres articles

Troubleshooting with iOS. UI tips Cocoa tips
PHP/MySQL conseils/tips In French and English
Url propres avec .htaccess / Minimal urls using .htaccess Un peu d'aide sur .htaccess ça ne se refuse pas ! Who doesn't need a little help with .htaccess :)
	AppEngine : analyse et conseils techniques AppEngine, l'outil de la décennie !
	Installer et utiliser Latex de manière simple et minimale sur mac Avec squelette de fichiers
	Guide pour passer facilement son site web en mode sombre (dark mode) Retour sur expérience et explications, du CSS aux images
	10 jours au Costa Rica "Pura vida" et bénévolat
Au cœur d'une manif que fait la police ?
	le Shinkansen en route pour Tokyo
	Les chaises musicales ou comment transformer des étudiants en de véritables requins...
	Alcatraz un petit tour sur cette île mythique
Soirée Mon premier vendredi soir au Japon
Crise financière : vers une baisse des salaires ? la fin de l'Eldorado ? Les primes et salaires fous des traders vont toucher à une fin.
	Comment les journalistes nous feront voter pour Hollande Journalisme politique
	Seito san Anniversaire à la japonaise de mon collègue
	Soirée au café-théâtre Le Matana (Paris 5ème), un café à découvrir ?
	Une année sans hiver ni été Une start-up est née
	Comment faire tourner une ancienne version de Mac sur votre Mac, via une VM Pratique pour débugguer votre app sur d'anciens ordis.
	Roman Gary ou les cerfs volants Poursuivre le bleu
	La guerre contre le coronavirus Journal d'un rescapé ou d'un condamné ?
	Road trip au Danemark Une semaine sur la terre des vikings
	Hokkaido Encore un bon petit week end découverte, plus loin cette fois !