萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

macOS 配置 PHP + MySQL 開發環境完整指南:Apache 啟用、MySQL 安裝、phpMyAdmin 部署

macOS 內建 Apache + PHP,僅需簡單配置即可啟用;MySQL 官方提供 DMG 安裝包,配合 phpMyAdmin 圖形管理,幾分鐘構建完整 LAMP 開發環境。本文記錄全流程步驟,含截圖引導、環境變量配置、密碼設置、常見坑點。

一、啟用內建 Apache + PHP

  1. 編輯 Apache 配置:sudo vim /etc/apache2/httpd.conf
  2. 取消註釋 PHP 模塊行:
    LoadModule php5_module libexec/apache2/libphp5.so (macOS 版本不同路徑可能為 php7_module/php_module)
  3. 系統偏好設置 → 共享 → 勾選「Web 共享」(macOS 10.15+ 已移除 GUI,改用命令行)
  4. 啟動 Apache:sudo apachectl start(或 restart/stop)
  5. 驗證:瀏覽器訪問 https://localhost/ 顯示 It works!

二、安裝 MySQL

  1. 下載 DMG:MySQL Community Server(選擇 macOS 版本對應包)
  2. 掛載 DMG,依次安裝三個包:
    • mysql-.pkg 核心服務
    • MySQLStartupItem.pkg 開機自啟
    • MySQL.prefPane 系統偏好面板管理
  3. 系統偏好設置 → MySQL → 點擊「Start MySQL Server」
  4. 設置 root 密碼:
    mysqladmin -u root password 'new_password'

三、配置 MySQL 命令別名(避免 PATH 污染)

# 編輯 ~/.bash_profile 或 ~/.zshrc
alias mysql='/usr/local/mysql/bin/mysql'
alias mysqladmin='/usr/local/mysql/bin/mysqladmin'
# 生效
source ~/.zshrc

四、部署 phpMyAdmin

  1. 下載:phpMyAdmin(建議最新穩定版)
  2. 解壓至 Web 根目錄:/Library/WebServer/Documents/phpmyadmin/
  3. 複製配置模板:
    cp config.sample.inc.php config.inc.php
  4. 編輯 config.inc.php 關鍵配置:
    $cfg['blowfish_secret'] = 'your_random_32chars_string'; // Cookie 加密密鑰
    $cfg['Servers'][$i]['host'] = '127.0.0.1'; // 強制 TCP 連接,避免 socket 權限問題
  5. 瀏覽器訪問 https://localhost/phpmyadmin/,用戶 root、剛設置的密碼登入。

五、常見坑點與解決

問題原因解決
localhost 顯示 403 ForbiddenDocumentRoot 權限或索引文件缺失chmod 755 /Library/WebServer/Documents、確保有 index.html
PHP 不解析,顯示源碼LoadModule 行未生效或模塊路徑錯誤檢查 httpd.conf 路徑、重啟 Apache、apachectl -M | grep php
MySQL 連接失敗 Can't connect to socketmysqld 用 socket 但 phpMyAdmin 用 TCP配置 host=127.0.0.1 或 socket=/tmp/mysql.sock
phpMyAdmin 提示 blowfish_secret 過短密鑰長度不足 32 字符生成 32+ 隨機字符串填入

六、現代替代方案(推薦新專案)

  • Docker:docker-compose up -d 一鍵啟動 PHP/MySQL/Redis/Nginx,版本鎖定、環境一致、零污染。
  • Valet / Laravel Herd:macOS 專用極輕量開發環境,自動配置域名、TLS、數據庫。
  • Homebrew:brew install php mysql nginx 統一包管理,易升級維護。

內建 Apache 方案適合「快速驗證、舊專案維護、不想折騰容器」的場景;長期開發強烈建議遷移至 Docker/Valet,獲得可復現、隔離、生產一致的環境。

copyright © 萬盛學電腦網 all rights reserved