macOS搭建PHP开发环境配置全流程

——写给那些深夜还没睡、电脑还没热的你

前言

一切从打开那台新电脑开始，就像爱情——最初总是满怀期待。
你为它配置系统，它为你打开世界。
于是我决定，记录这段旅程。技术，是孤独的告白。我们开始吧。

一、生成密钥：给未来留个入口

ssh-keygen -t rsa -b 4096 -C "eson"

二、安装 Homebrew：像命运一样的包管理器

Homebrew 官网

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

三、日常工具上新：城市的夜晚从装软件开始

• 谷歌浏览器

  brew install --cask google-chrome
  

• Clash：安静却可靠的代理

  brew install --cask clash-verge-rev
  

• PhpStorm：能看懂你写的每一行代码的IDE

  brew install --cask phpstorm
  

• iTerm2 + 美化

  brew install --cask iterm2
  

  • 安装 Oh My Zsh
  • 插件：zsh-users/zsh-syntax-highlighting、zsh-users/zsh-autosuggestions

• 搜狗输入法

• LocalSend：局域网的默契

  brew install --cask localsend
  

• Reqable：新一代 API 工具

  brew install --cask reqable
  

• HBuilderX：一种偏执的效率

  brew install --cask hbuilderx
  

• 微信开发者工具

  brew install --cask wechatwebdevtools
  

• Autojump：跳转的不是路径，是回忆

  brew install autojump
  

• FFmpeg：处理视频的利器

  brew install ffmpeg
  

四、进入正题：PHP 开发环境是个深夜剧场

安装组件

• 最新版 PHP

  brew install php
  

• PHP 7.4

  brew tap shivammathur/php
  brew install shivammathur/php/php@7.4
  

• Nginx

  brew install nginx
  

• Redis

  brew install redis
  

• MySQL

  brew install mysql
  

• Node.js 22

  brew install node@22
  

  • Yarn & PM2

  npm install --global yarn
  npm install --global pm2
  

环境变量配置（.zshrc）

# node
export PATH="/opt/homebrew/opt/node@22/bin:$PATH"

# php
export PATH="/opt/homebrew/opt/php@7.4/bin:$PATH"
export PATH="/opt/homebrew/opt/php@7.4/sbin:$PATH"
export PATH="/opt/homebrew/opt/php/bin:$PATH"
export PATH="/opt/homebrew/opt/php/sbin:$PATH"

alias php="/opt/homebrew/opt/php/bin/php"
alias php74="/opt/homebrew/opt/php@7.4/bin/php"

配置 PHP-FPM 的监听方式

编辑 /opt/homebrew/etc/php/[版本]/php-fpm.d/www.conf

; listen = 127.0.0.1:9000
listen = /var/tmp/php-fpm.sock

对 PHP 7.4：

; listen = 127.0.0.1:9000
listen = /var/tmp/php-fpm74.sock

配置 Nginx：让它听见 PHP 的低语

在 /opt/homebrew/etc/nginx 新增配置：

enable-php.conf

location ~ [^/]\.php(/|$) {
    try_files $uri =404;
    fastcgi_pass  unix:/var/tmp/php-fpm.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
}

enable-php74.conf

location ~ [^/]\.php(/|$) {
    fastcgi_pass  unix:/var/tmp/php-fpm74.sock;
    fastcgi_index index.php;
    include pathinfo.conf;
    include fastcgi.conf;
}

安装 PHP 扩展：像为情人添加细节

tip: 解决冲突文件夹问题

cd /opt/homebrew/Cellar/php@x.x/x.x.xx_x
mv pecl pecl-link

以安装 swoole, redis, xdebug 为例：

pecl install swoole
pecl install redis
pecl install xdebug

如果提示 phpize 不存在，先执行：

brew install autoconf

PHP 7.4 使用：

/opt/homebrew/opt/php@7.4/bin/pecl install swoole

结语：技术与爱情的共同点是——你总是想让它更完美

也许你只是为了跑一个项目，也许你准备构建一座属于自己的后端宇宙。
这份配置不会陪你一辈子，但至少今晚，它像一封没寄出的情书，写满了你对「理想环境」的想象。

技术总是冷的，但当你深夜调试、静默重启的那一刻，
你会知道，有些事，不是为了现在的结果，而是为了那一刻的专注——和浪漫。

“我曾经听人说过，当你准备好一切，代码就会回应你。”
— 一位深夜的程序员

如需进一步优化性能，建议日后考虑容器化（如 Docker），或使用 Laravel Valet 做更深层整合。

Thanks♪(･ω･)ﾉ 感谢你长得那么好看还来看我的博客！see you around ~