Skip to content

Mac 使用 brew 安装 Nginx、MySQL、Php 的 LNMP 开发环境

Homebrew

Homebrew 是 macOS 的包管理工具, 可以安装多款 unix 软件, 可以根据官网的命令来进行安装

🔗 https://brew.sh/

Mac 下安装和使用 Homebrew

如果你尚未安装, macOS 将会提醒你安装 Xcode 命令行工具, 安装完成后根据提示配置命令行目录

准备

新版的 Mac OS 内置了 Apache 和 PHP,可以通过以下命令查看 Apache 和 PHP 的版本号:

$ httpd -v
Server version: Apache/2.4.46 (Unix)
Server built:   Oct 29 2020 20:35:15
$ php --version
PHP 5.4.24 (cli) (built: Jan 19 2014 21:32:15)
Copyright (c) 1997-2013 The PHP Group
Zend Engine v2.4.0, Copyright (c) 1998-2013 Zend Technologies

因为我们要自己动手来安装 Nginx,如果 apache 启动则会出现端口占用的情况, 所以需要关闭系统自带的 apache(如果启动的话):

$ sudo apachectl stop  #关闭apache,如果事先没开启过,可以忽略报错信息

如果你的 apache 已经加入了 launchctl,使用下面的命令来关闭:

$ sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist

为什么选择关闭 apache?因为 mac os x 系统自带的 apache 是没有优雅的 remove/uninstall 的方式的… 默认目录位置是, 可以按需处理

$ /usr/sbin/apachectl
$ /usr/sbin/httpd
$ /etc/apache2/

默认 php 的位置

$ /usr/bin/php
$ /usr/bin/phpize
$ /usr/bin/php-config
$ /usr/sbin/php-fpm

Nginx

安装

$ brew install nginx
$ sudo brew services enable|start|restart|stop nginx

尽管我们不需要使用 sudo 来进行安装, 但是如果我们需要使用 80 端口来运行的话我们需要使用 sudo 来启动应用

配置

首先,我们必须给 Nginx 权限来访问我们的文件,以避免一个讨厌的 403 Forbidden 错误。为此,我们更改第一行,其中 {user} 是你的用户名:

# /usr/local/etc/nginx/nginx.conf
user {user} staff;

给予管理员权限

shell
# for intel
sudo chown root:wheel /usr/local/opt/nginx/bin/nginx
sudo chmod u+s /usr/local/opt/nginx/bin/nginx

# for arm
sudo chown root:wheel /opt/homebrew/opt/nginx/bin/nginx
sudo chmod u+s /opt/homebrew/opt/nginx/bin/nginx

这里无法启动一定要确认权限是否正确, 尤其是在升级之后

运行 nginx

sudo nginx # 打开 nginx(和 sudo brew services start nginx 一致)
nginx -s reload|reopen|stop|quit  #重新加载配置|重启|停止|退出 nginx
nginx -t   #测试配置是否有语法错误

用法详解

nginx [-?hvVtq] [-s signal] [-c filename] [-p prefix] [-g directives]

选项列表

-?,-h           : 打开帮助信息
-v              : 显示版本信息并退出
-V              : 显示版本和配置选项信息,然后退出
-t              : 检测配置文件是否有语法错误,然后退出
-q              : 在检测配置文件期间屏蔽非错误信息
-s signal       : 给一个 nginx 主进程发送信号:stop(停止), quit(退出), reopen(重启), reload(重新加载配置文件)
-p prefix       : 设置前缀路径(默认是:/usr/local/Cellar/nginx/1.2.6/)
-c filename     : 设置配置文件(默认是:/usr/local/etc/nginx/nginx.conf)
-g directives   : 设置配置文件外的全局指令

Mysql

$ brew install mysql@5.7
$ brew services start mysql@5.7

修改配置文件

$ vim /usr/local/opt/mysql/my.cnf

这里我们添加错误日志, 否则默认的错误日志均会记录到系统中

[mysqld]
log_error=/usr/local/var/log/mysqld.log

初始化 mysql

./bin/mysql_install_db

执行安全设置脚本,设置 root 账号密码

./bin/mysql_secure_installation

命令行连接 mysql

mysql -uroot -p

mysql 可以对外服务

vim ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist
# 将这一行
<string>--bind-address=127.0.0.1</string>
# 替换为
<string>--bind-address=0.0.0.0</string>

Php

安装

如果这里加上版本号, 则为指定版本,如果不加则是默认的版本, 非默认版本的属性是 keg-only , 意思就是可以支持多版本默认不会将命令行软链到 /usr/local

$ brew install php@7.3
$ sudo brew services start php@7.3

安装之后有两段话需要注意

php@7.3 is keg-only, which means it was not symlinked into /usr/local,
because this is an alternate version of another formula.

安装多版本 PHP

在 Mac 上官方 brew 支持的 php 版本根据 Php 的支持度会有变化, 某些版本当前已经不存在, 在这种状态下如果我们需要低版本的 php , 我们可以安装以下这个包, 如果不熟悉 brew tap, 查看顶部首页的链接

https://github.com/shivammathur/homebrew-php

这样即使低版本的php 我们一样可以安装使用了

shell
$ brew install php@5.6

命令行启动 / 版本更换

在 mac 上首先安装的版本是最新的版本, 这样如果想切换默认的 php 版本则需要使用如下命令

shell
$ brew link --force php@7.3

这种可以使用 pecl 进行安装 相关扩展, 比如 redis , swoole

$ pecl install redis

配置 Php-Fpm

/usr/local/etc/php/{version}/php.ini
/usr/local/etc/php/{version}/php-fpm.conf

配置 Nginx 支持 PHP-FPM

# /usr/local/etc/nginx/nginx.conf
# 添加默认首页 php
index  index.php index.html index.htm;
# 取消以下内容的注释,并做修改
location ~ \.php$ {
    fastcgi_intercept_errors on;
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include        fastcgi_params;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_buffers 16 16k;
    fastcgi_buffer_size 32k;
}

为了避免 出现 File not found 错误, 我们需要给定 php 正确的权限

# /usr/local/etc/php/7.3/php-fpm.d/www.conf
user = <user>
group = staff

最后, 重启 nginx 来激活这些改动, 如果我们忘记启动 php, 则会出现 502 Bad Gateway 错误

$ sudo brew services restart nginx
$ sudo brew services start php@7.3

结语

到目前为止,我们的 Nginx、MySQL、PHP-FPM 三大软件已经安装好了,针对不同的系统版本和软件版本,可能会遇到一些问题,欢迎留言探讨。

是否使用 sudo 启动区别

If sudo is passed, operate on /Library/LaunchDaemons (started at boot). Otherwise, operate on ~/Library/LaunchAgents (started at login)

更新记录

2023-01-16

  • 加入 php 多版本, 移除和当前版本不符合的描述