Unter Mac OS X entwickeln macht Spaß. Und das eigenen System einzurichten geht erstaunlich schnell, da Mac OS X bereits mit einem Apache 2.2 Webserver, PHP 5 und auch mit einem SVN Server ausgeliefert wird. Wie diese unkompliziert eingerichtet werden können soll hier gezeigt werden.

Apache Webserver unter Mac OS X starten

Den Apache Webserver zu starten geht erstaunlich einfach. Dazu kann entweder unter Systemeinstellungen > Freigaben die so genannte Webfreigabe aktiviert werden. Ich empfehle, den Apache Server auf diesem Wege zu starten. Natürlich kann man im Terminal kann auch folgenden Befehl eingegeben, doch fehlt dann der entsprechende visuelle Status unter Systemeinstellungen.

sudo httpd -k start

Das so genannte htdocs Verzeichnis (das Verzeichnis, dass von außen über den Apache 2 Server angesprochen wird) findet sich standardmäßig unter /Library/Webserver/Documents.

PHP 5 unter Mac OS X einrichten

Wer mit PHP 5 entwickeln möchte, der muss das entsprechende Apache Modul zunächst aktivieren. Dazu muss die httpd.conf Datei editiert werden. Sie findet sich unter /etc/apache2. Um auf die Systemverzeichnisse wie beispielsweise etc oder usr über den Finder zuzugreifen wählt man im Menu des Finders Gehe zu > Gehe zu Ordner. Alternativ kann natürlich auch über das Terminal und cd Befehlen zu den entsprechenden Verzeichnissen navigiert werden.

In der httpd.conf Datei muss die Zeile 116

LoadModule php5_module        libexec/apache2/libphp5.so

entkommentiert werden. Wer möchte kann in Zeile 215 einstellen, dass .htaccess Dateien Parameter ändern können. Das ist für die reibungslose Funktion von mod_rewrite notwendig.

<Directory /Library/WebServer/Documents>
  AllowOverride All
</Directory>

In Zeile 230 muss hinzugefügt werden, dass auch index.php Dateien als Directory Indexes erkannt werden:

<IfModule dir_module>
  DirectoryIndex index.html index.php
</IfModule>

Zu guter letzt muss der Webserver neu gestartet werden. Dies kann über die Systemeinstellungen (siehe oben) oder mit folgendem Befehl geschehen:

sudo httpd -k restart

Um zu testen, ob PHP läuft kann eine index.php und folgendem Inhalt im htdocs Verzeichnis abgelegt werden. Mit http://localhost/index.php im Browser sollte eine Übersicht über das installierte PHP Modul erscheinen.

<?php phpinfo(); ?>

Um Default-Eigenschaften zu überschreiben (error reporting, max upload etc.) muss eine php.ini Datei unter /etc/ angelegt werden. Meine php.ini enthält das Folgende:

max_execution_time = 60
memory_limit = 256M
display_errors = On
post_max_size = 32M
upload_max_filesize = 32M
date.timezone = Europe/Berlin

MySQL unter Mac OS X einrichten

Einen MySQL-Server unter Mac OS X einzurichten geht denkbar einfach. Hierfür gibt es fertige Installer, die über http://dev.mysql.com/downloads/mysql/ bezogen werden können. Zusätzlich kommt das MySQL Package mit einem Startup-Item. Wird es installiert, so startet MySQL bei jeden Systemstart automatisch. Installiert wird mysql unter /usr/local/mysql. Um MySQL manuell zu starten genügt folgender Befehl:

sudo mysqld_safe

Um einen unkomplizierten Umgang mit MySQL zu gewährleisten empfehle ich, das /usr/local/mysql/bin Verzeichnis zur $PATH hinzuzufügen. Tut man dies nicht, wird der mysql Befehl im Terminal nicht gefunden. Diese drei Schritte helfen:

1. Eine neue Datei /etc/paths.d/mysql erzeugen:

sudo touch /etc/paths.d/mysql

2. Die Datei bearbeiten und das MySQL bin Verzeichnis erstellen:

sudo vim /etc/paths.d/mysql

3. Den  MySQL-bin Pfad einfügen und speichern.

/usr/local/mysql/bin

Wer mit vim noch nicht gearbeitet hat: i drücken um in die Datei zu schreiben, den Pfad eingeben, ESC drücken und dann :wq eingeben und mit Enter bestätigen. Nach einem Neustart sind alle im /usr/local/mysql/bin Verzeichnis befindenden Programme auffindbar.

Achtung: Anfangs besitzt der MySQL root Account kein Passwort! Zur einfachen Verwaltung empfehle ich phpmyadmin – ein WebGUI.

Einen SVN Server unter Mac OS X einrichten

SVN wird bereits mit Mac OS X ausgeliefert. Damit der SVN Server auch von außen ansprechbar ist muss in erster Linie der Apache Webserver konfiguriert werden. Ich verwalte meine SVN Repositories im Ordner /usr/local/svn/. Um die Repositories von außen ansprechbar zu machen muss eine Datei namens svn.conf im Ordner /etc/apache2/other angelegt werden. Sie besitzt folgenden Inhalt:

LoadModule dav_svn_module /usr/libexec/apache2/mod_dav_svn.so
<Location /svn>
  DAV svn
  SVNParentPath /usr/local/svn
</Location>

Nachdem Apache neu gestartet wurde sind die Repositories in /usr/local/svn/ unter http://localhost/svn ansprechbar. Beim Anlegen eines neuen Repositories namens foo mit

sudo svnadmin create /usr/local/svn/foo

Muss darauf geachtet werden, dass Apache und das SVN Modul auch darauf zugreifen können. Dazu ändern wir zuvor den Besitzer der Dateien in www um:

sudo chown -R www:www /usr/local/svn

Damit ist SVN bereits fertig eingerichtet. Ich empfehle die Absicherung des SVN Verzeichnisses. Dazu muss zunächst eine htpasswd Datei erzeugt werden:

htpasswd -cm /etc/apache2/svn.auth benutzername

Die svn.conf Datei muss um folgendes erweitert werden:

LoadModule dav_svn_module /usr/libexec/apache2/mod_dav_svn.so
<Location /svn>
  DAV svn
  SVNParentPath /usr/local/svn
  AuthType Basic
  AuthName "Subversion Login"
  AuthUserFile /etc/apache2/svn.auth
  Require valid-user
</Location>

Die Repositories sind jetzt unter http://localhost/svn erreichbar. Zur einfachen Verwaltung empfehle ich WebSVN – ein WebGUI.

Update: Sollte der Apache Server mit der obigen svn Konfiguration nicht mehr starten, muss darauf geachtet werden, dass die Apache Module mod_dav.so und mod_dav_fs.so auch geladen werden. Danke an Alexander für diesen Tip.

Es kann schon einiges an Kopfzerbrechen verursachen, wenn beispielsweise ein WordPress-Update nur noch kryptische Zeichen statt Umlaute darstellt. Meist liegt das Problem am in der Datenbank verwendetem Zeichensatz. Daten, die beispielsweise in einem latin1 Zeichensatz formatiert sind und in einer utf8-Tabelle abgespeichert werden, werden dadurch beim Auslesen meist unbrauchbar.

Das PHP-Skript hier hilft bei der Umwandlung des Inhalts der Datenbanktabellen in die utf8 Zeichenkodierung. Das Skript wandelt zunächst alle Tabellendaten in Binärdaten um, ändert dann die Tabellencodierung und wandelt schließlich die Tabellendaten wieder in das ursprüngliche Format um. Dadurch werden zum Beispiel Umlaute in ihre utf8-Entsprechungen verwandelt.

Das ist zu tun

1. Zunächst alle Tabellen im Originalformat belassen
2. Eine SICHERHEITSKOPIE DER DATENBANK ANLEGEN
3. Das Skript in einem Texteditor öffnen und die Datenbankparameter anpassen
4. Das Skript auf den Webspace hochladen und im Browser öffnen
5. Das Skript vom Webspace löschen

Wie funktioniert das Skript? Kann ich das auch ohne Skript machen?

Der Trick ist ganz einfach: Wandel ich den Zeichenkodierung einer Tabellenspalte mit folgendem mysql-Befehl in Binärdaten um …

ALTER TABLE Tabellenname CONVERT TO CHARACTER SET binary

… änder dann mit diesem Befehl hier die Zeichenkodierung der Tabelle auf utf8 …

ALTER TABLE Tabellenname CONVERT TO CHARACTER SET utf8

… muss ich im nächsten Schritt die Tabellenspalte wieder auf den ursprünglichen Typ zurücksetzen:

ALTER TABLE Tabellenname MODIFY Spaltentyp Spaltenoptionen

(Wobei Spaltentyp der ursprüngliche Spaltentyp wie Text, Varchar, Enum etc. ist und die Spaltenoptionen die Optionen wie zB. NOT NULL oder DEFAULT sind.)

Das Skript

<?php

$DB_HOST = 'localhost'; // Enter your Database Host
$DB_USER = 'username'; // Enter your Database Username
$DB_PASSWORD = 'password'; // Enter your Database Password
$DB_DATABASE = 'database'; // Enter your Database Name

$tables = array();
$tables_with_fields = array();

$link_id = mysql_connect($DB_HOST, $DB_USER, $DB_PASSWORD) or die('Error establishing a database connection');
echo 'Connected' ."\n";
mysql_select_db($DB_DATABASE, $link_id);
echo 'Selected database' ."\n";

// Gathering information about tables and all the text/string fields that can be affected
// during the conversion to UTF-8.
echo 'Getting tables:' ."\n";
$resource = mysql_query("SHOW TABLES", $link_id);
while ( $result = mysql_fetch_row($resource) ) {
	$tables[] = $result[0];
	echo ' - ' . $result[0] ."\n";
}

if ( !empty($tables) ) {
    echo 'Starting process' ."\n";
    foreach ( (array) $tables as $table ) {
        echo 'Working on table "' . $table . '"';
        $resource = mysql_query("EXPLAIN $table", $link_id);
        while ( $result = mysql_fetch_assoc($resource) ) {
            if ( preg_match('/(char)|(text)|(enum)|(set)/', $result['Type']) )
                $tables_with_fields[$table][$result['Field']] = $result['Type'] . " " . ( "YES" == $result['Null'] ? "" : "NOT " ) . "NULL " .  ( !is_null($result['Default']) ? "DEFAULT '". $result['Default'] ."'" : "" );
                echo '.';
        }
        echo "\n";
    }

    // Change all text/string fields of the tables to their corresponding binary text/string representations.
    echo 'Altering tables to binary character set';
    foreach ( (array) $tables as $table ) {
        mysql_query("ALTER TABLE $table CONVERT TO CHARACTER SET binary", $link_id);
        echo '.';
    }
    echo "\n";

    // Change database and tables to UTF-8 Character set.
    echo 'Altering tables to utf8 character set';
    mysql_query("ALTER DATABASE " . $DB_DATABASE . " CHARACTER SET utf8", $link_id);
    foreach ( (array) $tables as $table ) {
        mysql_query("ALTER TABLE $table CONVERT TO CHARACTER SET utf8", $link_id);
        echo '.';
    }
    echo "\n";

    // Return all binary text/string fields previously changed to their original representations.
    echo 'Altering binary text/string fields to original representation';
    foreach ( (array) $tables_with_fields as $table => $fields ) {
        foreach ( (array) $fields as $field_type => $field_options ) {
            mysql_query("ALTER TABLE $table MODIFY $field_type $field_options", $link_id);
        }
        echo '.';
    }
    echo "\n";

    // Optimize tables and finally close the mysql link.
    echo 'Optimizing tables' . "\n";
    foreach ( (array) $tables as $table )
        mysql_query("OPTIMIZE TABLE $table", $link_id);
    mysql_close($link_id);
    echo 'DONE';
} else {
    die('There are no tables?');
}
?>

Das Skript basiert auf dem mitlerweile nicht mehr weiter entwickeltem WordPress UTF-8 Database Converter und lässt sich in der obigen Form hier herunterladen.

Ein kurzer Beitrag welcher beschreibt, wie man unter Windows das Passwort des Benutzers root zurücksetzen, bzw. neu setzen kann, wenn man es vergessen hat.

Um das vergessene Passwort des root Benutzers bei MySQL neu zu setzen sind 3 Schritte notwendig:

• MySQL-Daemon beenden
• Init-Datei mit neuem Passwort anlegen
• MySQL-Daemon mit Init-Datei starten – Passwort wird auf “Init-Passwort” gesetzt

Die notwendigen Schritte werden gefolgt beschrieben bei Verwendung von Windows 7.

Den MySQL-Daemon beenden

Ein laufender MySQL-Daemon muss zuerst beendet werden, damit wir das Passwort ändern können. Hier werden zwei Varianten beschrieben, wobei Variante 1 klar zu empfehlen ist.

Variante 1: MySQL-Daemon über die Computerverwaltung beenden

Rufen Sie die Computerverwaltung über die folgende Schritte auf.

In der Computerverwaltung wählen Sie links im Baum den Bereich Dienste (1), rechts MySQL (2) und beenden den Dienst zuletzt über das Stop-Icon (3).

Variante 2: MySQL-Daemon über den Task-Manager beenden/ killen

(Diesen Schritt brauchen Sie nur durchführen, wenn Sie über die Computerverwaltung MySQL nicht beenden konnten).

Starten Sie den Task-Manger durch einen Rechtsklick auf die Taskleiste und einen Klick auf Task-Manager starten. Klicken Sie im Task-Manager auf den Button Prozesse aller Benutzer anzeigen, um auch die Systemprozesse und somit MySQL gelistet zu bekommen.

Auch Systemprozesse anzeigen

Klicken Sie auf Abbildname (1) um alle Prozesse alphabetisch zu sortieren. Selektieren Sie nun in der Liste den Eintrag mysqld.exe (2). Diesen Prozess können Sie nun durch Prozess beenden (3) beenden. Bestätigen Sie die Aktion in dem Sie bei der Sicherheitsabfrage erneut auf Prozess beenden (4) klicken.

Killen von MySQL über den Task-Manager

Init-Datei anlegen

Die Init-Datei enthält Anweisungen, welche beim Starten von MySQL direkt ausgeführt werden. Wir hinterlegen in ein solchen Datei nun eine Direktive, um das Passwort des Users root zu ändern.

Legen Sie auf dem Desktop eine Datei mit dem Namen mysql-init.txt an. Öffen Sie Datei und kopieren Sie folgende SQL-Anweisung hinein

SET PASSWORD FOR 'root'@'localhost' = PASSWORD('geheim');

Natürlich können Sie statt geheim jedes erdenkliche Passwort verwenden.

MySQL-Daemon mit init-Datei starten

Nun starten wir den MySQL-Daemon mit der init-Datei, welcher wir zuvor erstellt haben.

Öffnen Sie eine Eingabeaufforderung (Startmenü -> CMD -> ENTER). Geben Sie nun folgende Anweisung ein:

<Pfad mysqld.exe> --init-file=C:\Users\<Ihr Windowsbenutzer>\Desktop\my-init.txt --console

So sieht der Aufruf z.B. aus wenn MySQL in einem Unterordner namens Zend installiert ist:

mysqld mit --init-file aufgerufen

Das Passwort wurde nun auf Ihren Wert, welchen Sie im Schritt Init-Datei anlegen festgelegt haben, gesetzt. Beenden Sie nun die Eingabeaufforderung durch STRG + C. Starten Sie nun anschließend wieder mysql über die Diensteverwaltung (siehe oben), in dem Sie das Start-Icon benutzen.

Anschließend können Sie wie gewohnt MySQL nutzen – jetzt aber mit Ihrem neuen Passwort.