macOS 10.10 Yosemite 搭建 Apache + PHP + MySQL 5.6.22 + phpMyAdmin 開發環境全紀錄

前言

習慣 Windows 下一鍵安裝包（AppServ、phpStudy）的開發者，初次在 Mac 上手動配置 PHP 環境難免生疏。好在 macOS 自帶 Apache 與 PHP，僅需啟用並微調；MySQL 5.6.22 則需手動安裝配置。本文詳細記錄全過程，含踩坑與解決方案。

一、Apache 配置

macOS 10.10 已內建 Apache，常用命令：

# 啟動
$ sudo apachectl start
# 停止
$ sudo apachectl stop
# 重啟
$ sudo apachectl restart
# 查看版本
$ httpd -v

瀏覽器訪問 https://localhost 出現 "It works!" 即成功。預設文檔根目錄為 /Library/WebServer/Documents/。

修改網站根目錄至用戶目錄

1. 在用戶目錄建立 Sites 資料夾（如 /Users/yanzi/Sites）。
2. 編輯 /etc/apache2/users/yanzi.conf：

<Directory "/Users/yanzi/Sites/">
    AllowOverride All
    Options Indexes MultiViews FollowSymLinks
    Require all granted
</Directory>

設置權限：sudo chmod 644 /etc/apache2/users/yanzi.conf

3. 編輯 /etc/apache2/httpd.conf，取消註釋：

LoadModule authz_core_module libexec/apache2/mod_authz_core.so
LoadModule authz_host_module libexec/apache2/mod_authz_host.so
LoadModule userdir_module libexec/apache2/mod_userdir.so

並取消註釋 Include /private/etc/apache2/extra/httpd-userdir.conf。

4. 編輯 /etc/apache2/extra/httpd-userdir.conf，取消註釋 Include /private/etc/apache2/users/*.conf。

重啟 Apache：sudo apachectl restart。瀏覽器訪問 https://localhost/~yanzi/ 即可看到用戶目錄下的站點（無需加 /Sites）。

二、PHP 配置

編輯 /etc/apache2/httpd.conf，取消註釋：

LoadModule php5_module libexec/apache2/libphp5.so

重啟 Apache。在 ~/Sites/index.php 撰寫 <?php phpinfo(); ?>，瀏覽器訪問 https://localhost/~yanzi/ 即可看到 PHP 信息頁。

三、安裝 MySQL 5.6.22

1. 官網下載 mysql-5.6.22-osx10.9-x86_64.dmg。安裝時勿勾選 StartUp Item，改用系統偏好設置面板手動啟動，後續再配置開機自啟。
2. 將 /usr/local/mysql/bin 加入 PATH：

$ vim ~/.bash_profile
export PATH="/usr/local/mysql/bin:$PATH"
$ source ~/.bash_profile

設置 root 密碼：mysqladmin -u root password 'your_password'

3. 修復 Socket 路徑問題：MySQL 預設 socket 在 /tmp/mysql.sock，系統卻找 /var/mysql/mysql.sock。

$ sudo mkdir -p /var/mysql
$ sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock

4. 配置開機自啟（LaunchDaemon）：

$ sudo vim /Library/LaunchDaemons/com.mysql.mysql.plist

內容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>KeepAlive</key><true/>
    <key>Label</key><string>com.mysql.mysqld</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/mysql/bin/mysqld_safe</string>
        <string>--user=mysql</string>
    </array>
</dict>
</plist>

設置權限並載入：

$ sudo chown root:wheel /Library/LaunchDaemons/com.mysql.mysql.plist
$ sudo chmod 644 /Library/LaunchDaemons/com.mysql.mysql.plist
$ sudo launchctl load -w /Library/LaunchDaemons/com.mysql.mysql.plist

四、安裝 phpMyAdmin

1. 下載 phpMyAdmin-4.4.2-all-languages.zip，解壓重命名為 phpmyadmin，放入 ~/Sites/。
2. 進入目錄建立可寫配置目錄：

$ mkdir config
$ chmod o+w config

3. 瀏覽器訪問 https://localhost/~yanzi/phpmyadmin/setup/，點擊「新建服務器」，輸入 MySQL root 密碼，點擊「應用」生成 config.inc.php。
4. 將 config.inc.php 複製到 phpMyAdmin 根目錄，刪除 config 目錄。
5. 訪問 https://localhost/~yanzi/phpmyadmin/ 即可登錄。

五、讀寫權限與用戶組（生產環境建議）

$ sudo chmod -R a+w ~/Sites/testsite
$ sudo chown -R _www ~/Sites/testsite

使 Apache 進程（_www 用戶）擁有讀寫權限。

參考資源

• Coolest Guides On The Planet
• CSDN 參考文獻
• 虛擬主機配置：Virtual Hosts Guide
• MySQL 卸載：Uninstall MySQL on Mac