I've just installed mysql5 myself, and since this is always a pain I've noted the process that I followed. This was done on Leopard, but I imagine the process is the same on Snow Leopard and Lion. It doesn't answer all the original questions, but at least it's something of a guide.
Installing Mysql
First, install mysql5 server with:
sudo port install mysql5-server
Just installing mysql5
doesn't install the server.
Pay attention to the console output, it includes instructions for setting up macports. You might want to copy and paste it to a text file. The following is based on it.
Instead of mysql5-server
, you could use a port such as mysql55-server
, mysql56-server
, mariadb-server
or percona-server
to get a more recent version of mysql, or a fork. If you do, pay attention to the console output, as the following instructions are based on mysql5-server
and will need to be adjusted to use the correct executables and paths.
If this is a new install, set up the database:
sudo -u _mysql mysql_install_db5
That outputs some generic instructions, which I don't think are entirely appropriate for macports. In my opinion the best way to load mysql5 as a daemon is to use macport's method:
sudo port load mysql5-server
As well as starting mysql5, this permanently loads it - it will run on boot up. To stop this later:
sudo port unload mysql5-server
If you don't want to run it as a daemon, you can run it at the command line:
sudo /opt/local/lib/mysql5/bin/mysqld_safe
Check that it's running by logging in at the command line:
mysql5 -u root -p
By default, the password is empty, so just press enter when prompted. To set a root password:
/opt/local/lib/mysql5/bin/mysqladmin -u root password 'correct horse battery staple'
Instructions for setting up both macports php and the native php installation follow.
Setup Macports PHP
Assuming you've already got macports php installed and running. You need to install php5-mysql
(or something like php54-mysql
depending on which version of php you're using):
sudo port install php5-mysql
This installs the mysql, mysqli and pdo drivers.
Now look in your /opt/local/etc/php5
directory, if you don't already have a php.ini
configuration file copy either php.ini-development
or php.ini-production
to php.ini
. Now edit php.ini
and search for the appropriate lines to add:
pdo_mysql.default_socket=/opt/local/var/run/mysql5/mysqld.sock
and:
mysql.default_socket = /opt/local/var/run/mysql5/mysqld.sock
and:
mysqli.default_socket = /opt/local/var/run/mysql5/mysqld.sock
If you don't want to configure these, you can set them explicitly in your php script when you connect.
If you're having trouble connecting you might want to look at the other nearby settings, and compare with php.ini-development
and php.ini-production
to see what's been changed.
Then use the script below, or something similar to test that you can connect with php.
Setup System PHP
OS X's php comes with mysql and mysqli support built in (but not pdo), so all you need to do is set the macport unix socket. The default location is /opt/local/var/run/mysql5/mysqld.sock
. Find the correct place in /etc/php.ini
(if you don't have it already, copy it from /etc/php.ini.default
) to add:
mysql.default_socket = /opt/local/var/run/mysql5/mysqld.sock
and:
mysqli.default_socket = /opt/local/var/run/mysql5/mysqld.sock
If you don't want to configure these, you can set them explicitly in your php script when you connect.
Test Script
Here's a php script to check that it can connect. Obviously, you won't normally use the root account in your php scripts so you might want to first create another mysql account for testing the connection. The PDO connection won't work for native php since that doesn't have PDO drivers.
<?php
$username = 'root';
$password = 'correct horse battery staple';
/* Try mysql: */
$connection = mysql_connect('localhost', $username, $password);
if ($connection === FALSE) {
echo "Error connecting using mysql.\n\n";
echo "Error ".mysql_errno().": ".mysql_error()."\n\n";
}
else {
echo "Connected using mysql.\n\n";
mysql_close($connection);
}
/* Try mysqli: */
$connection = mysqli_connect('localhost', $username, $password);
if ($connection->connect_error) {
echo "Error connecting using mysqli:\n\n";
echo "Error ".$connection->connect_errno.": ".$connection->connect_error."\n\n";
}
else {
echo "Connected using mysqli.\n\n";
$connection->close();
}
/* Try pdo:
* Won't work for the version of php supplied with OS X. */
try {
$pdo = new PDO('mysql:host=localhost', $username, $password);
echo "Connected using PDO.\n\n";
$pdo = null;
}
catch(PDOException $e) {
echo "Error connecting using PDO:\n\n";
echo "Error ".$e->getCode().": ".$e->getMessage()."\n\n";
}