Posts Mac 上配置 MNMP 环境
Post
Cancel

Mac 上配置 MNMP 环境

前言

今天打算实践一下 Wordpress 主题开发,但由于电脑上没有 PHP 和 MySQL 的环境,于是折腾了一下,结果发现安装配置过程一堆的坑,虽然最终选择了 Docker 环境开发,但毕竟已经踩坑了,就记录一下。

本文讲述如何在 Mac OS 上配置 Ngnix + PHP + MySQL,以及最后如何成功安装 Wordpress。

过程

Nginx

1. 安装

1
brew install nginx

2. 开启

1
2
3
4
5
6
7
8
9
10
11
12
13
# 启动
brew services start nginx
# 停止
brew services stop nginx
# 重启
brew services restart nginx

# 开机启动
sudo cp /usr/local/opt/nginx/homebrew.mxcl.nginx.plist /Library/LaunchDaemons/
sudo launchctl load -w /Library/LaunchDaemons/homebrew.mxcl.nginx.plist

# 关闭开机启动
sudo launchctl unload -w ~/Library/LaunchAgents/homebrew.mxcl.nginx.plist

3. 访问

nginx 默认监听 8080 端口,可以这样看一下是否能够访问:

1
2
3
4
curl localhost:8080

## 看到这个返回表示 ok
<html><body><h1>It works!</h1></body></html>

4. 配置主机

为了方便管理,我们在 nginx 配置目录下的 servers  新增一个配置文件:

1
vim /usr/local/etc/nginx/servers/www.conf

并填充以下内容:

1
2
3
4
5
6
7
8
9
10
11
12
server {
    listen       80;
  	# 如果需要域名访问的话,注意需要修改 /etc/hosts 文件
    # server_name  4ark.dev;
  	# 项目根目录
    root /Users/4ark/www;

    location / {
        index index.php index.html;
        autoindex on;
    }
}

注意:最好每个项目都单独一个配置文件。

从上面的配置可以看到我们将项目放在用户下的 www  下,在这个目录新建一个 html 文件:

1
2
3
mkdir ~/www

vim ~/www/index.html

这时候重启一下 nginx 服务,访问刚刚配置的主机,就可以访问到上面这个 html 文件

1
2
3
brew services restart nginx

curl localhost

PHP

1. 安装

Mac 已经自带有 PHP,你可以通过以下命令查看本机是否存在 PHP:

1
brew list | grep php

如果没有,或者你想安装其他版本的话,那就先安装

1
2
3
4
5
# 可以先搜索以下是否有你想要的版本
brew search php

# 安装 php 7.3
brew search php@7.3

2. 配置

配置 php-fpm 权限

1
vim /usr/local/etc/php/7.3/php-fpm.d/www.conf

修改如下:

1
2
3
- user = _www
+ user = 4ark # 你的用户名
group = _www

如果正在运行 php-fpm,那就先关闭

1
sudo killall php-fpm

然后启动:

1
sudo php-fpm -D

这时候如果遇到以下报错:

1
2
3
ERROR: failed to open configuration file '/private/etc/php-fpm.conf': No such file or directory (2)
ERROR: failed to load configuration file '/private/etc/php-fpm.conf'
ERROR: FPM initialization failed

错误信息显示,不能打开配置文件,cd /private/etc,发现没有  php-fpm.conf  文件,但是有  php-fpm.conf.default  文件。这个文件是默认配置,我们可以复制一份,改名为  php-fpm.conf,然后再根据需要改动配置。

1
2
3
sudo cp /private/etc/php-fpm.conf.default /private/etc/php-fpm.conf

sudo cp /private/etc/php-fpm.d/www.conf.default /private/etc/php-fpm.d/www.conf

执行  php-fpm,再次报错:

1
2
3
ERROR: failed to open error_log (/usr/var/log/php-fpm.log): No such file or directory (2)
ERROR: failed to post process the configuration
ERROR: FPM initialization failed

错误信息显示,不能打开错误日志文件。cd /usr/var/log  发现根本没有这个目录,甚至连  var  目录都没有,加上为了避免权限问题,干脆配置到  /usr/local/var/log  目录。

1
2
3
4
vim /private/etc/php-fpm.conf

# 将 error_log 改为 /usr/local/var/log/php-fpm.log
error_log = /usr/local/var/log/php-fpm.log

执行  sudo php-fpm,再次报错:

1
2
ERROR: unable to bind listening socket for address '127.0.0.1:9000': Address already in use (48)
ERROR: FPM initialization failed

说是 9000 端口被占用了,但 lsof -i:9000  又看不见,于是只能换个端口:

1
2
3
4
vim /private/etc/php-fpm.d/www.conf

# 修改监听端口为 9999
listen = 9999

再执行 sudo php-fpm -D ,就能够正常启动了。

3. 配置 nginx

这时候我们修改 nginx 的主机配置,使它支持 PHP

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
server {
    listen       80;
    server_name  4ark.dev;
    root /Users/4ark/www;

    location / {
        index index.php index.html;
        autoindex on;
    }

+    location ~ \.php$ {
+        fastcgi_pass   127.0.0.1:9999;
+        fastcgi_index  index.php;
+        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
+        include        fastcgi_params;
+    }
}

然后重启 nginx 服务

1
brew services restart nginx

这时候在项目根目录新增一个 php 文件

1
2
3
4
5
6
vim ~/www/index.php

# 内容
<?php

echo 'hello world!';

测试一下

1
2
3
4
curl localhost

# 返回结果
hello world!

MySQL

通常来说 Mac OS 也是自带有 MySQL,你可以通过以下命令查看本机是否存在 MySQL

1
brew list --formula | grep mysql

如果没有安装的话,那就先安装

1
brew install mysql

安装完成以后,会发现并没有让我们设置密码,运行以下进入密码设置

1
mysql_secure_installation

设置完密码之后,就可以登录了

1
2
mysql -uroot -p
# 输入密码

Wordpress

环境终于配置好了,终于可以安装 Wordpress 啦,然而事情并没有这么简单,当我满心欢喜把 wordpress 下载到项目根目录下,就好像这样:

1
cp -r ~/download/wordpress ~/www/wordpress

然后我们创建一个数据库:

1
2
3
4
[root@host]# mysql -u root -p
Enter password:******  # 登录后进入终端

mysql> create DATABASE `wordpress-test`;

然后我们通过浏览器访问 localhost/wordpress ,就可以看到一个 Wordpress 的安装界面,输入数据库相关的信息后,本以为可以像往常一样成功进入下一步,结果我看到了这个错误:WordPress 建立数据库连接时出错

结果再尝试了几次,确保所有表单都已经填写正确,依然无法正常建立数据库连接,意识到事情可能并没有这么简单, 于是我在网上找到了一个解决方案,大概就是说无法使用 root 进行登录,需要新增一个用户:

1
grant all on wordpress-test.* to 'wp-test'@'localhost' identified by 'password'

然后使用这个用户进行登录,然后在我这里却行不通,依然显示同样的错误,于是我开启一下 debug ,看一下导致是什么问题

1
2
3
cp wp-config-sample.php wp-config.php

vim wp-config.php

做以下改动:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// 填写以下数据库信息

// ** MySQL 设置 - 具体信息来自您正在使用的主机 ** //
/** WordPress数据库的名称 */
define( 'DB_NAME', 'database_name_here' );

/** MySQL数据库用户名 */
define( 'DB_USER', 'username_here' );

/** MySQL数据库密码 */
define( 'DB_PASSWORD', 'password_here' );

/** MySQL主机 */
define( 'DB_HOST', 'localhost' );

// 开启 DEBUG

- define('WP_DEBUG', false);
+ define('WP_DEBUG', true);

再访问一下,可以看到以下错误:

1
No such file or directory 建立数据库连接时出错

其实原因是 PHP 配置中的 mysql.sock  与本机的 MySQL 中的路径不一致,可以通过这样查看:

1
2
3
4
5
vim ~/www/phpinfo.php

# 内容
<?php
phpinfo();

然后打开 localhost/phpinfo ,搜索 default_socket 。

然后再查看 MySQL 的 socket  路径:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
[root@host]# mysql -u root -p
Enter password:******  # 登录后进入终端

mysql> status;

# 输出
mysql  Ver 8.0.22 for osx10.16 on x86_64 (Homebrew)

Connection id:		114
Current database:
Current user:		root@localhost
SSL:			Not in use
Current pager:		less
Using outfile:		''
Using delimiter:	;
Server version:		8.0.22 Homebrew
Protocol version:	10
Connection:		Localhost via UNIX socket
Server characterset:	utf8mb4
Db     characterset:	utf8mb4
Client characterset:	utf8mb4
Conn.  characterset:	utf8mb4
UNIX socket:		/tmp/mysql.sock
Binary data as:		Hexadecimal
Uptime:			14 hours 59 min 44 sec

如果与 PHP 中的 mysql.sock  路径不一致,则需要修改:

1
2
3
4
5
6
7
sudo cp /private/etc/php.ini.default /private/etc/php.ini

vim /private/etc/php.ini

## 修改为以下
pdo_mysql.default_socket= /tmp/mysql.sock
mysqli.default_socket = /tmp/mysql.sock

然后重启一下 php-fpm

1
2
sudo killall php-fpm
sudo php-fpm -D

再看看 phpinfo ,应该就生效了。

然后再尝试登录一下 Wordpress,又发现了以下错误:

1
error: The server requested authentication method unknown to the client [duplicate]

解决方案如下:

1
2
3
4
5
[root@host]# mysql -u root -p
Enter password:******  # 登录后进入终端

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password
BY 'your_root_password';

应该就可以了。

参考链接

This post is licensed under CC BY 4.0 by the author.

十月总结

2020 年度总结

Loading comments from Disqus ...