在 macOS Catalina 10.15 搭建 PHP 开发环境

2019 年 10 月 8 日,苹果公司正式发布了新一代 macOS,版本为 Catalina (11.15)。

macOS Catalina 预装了 Ruby(2.6.3)、PHP(7.3.9)、Perl(5.18.4)、Python(2.7.16) 等常用的脚本语言,以及 Apache(2.4.41) Web 服务器。

需要注意的是,在新版本中,zsh 已取代 bash 成为新版操作系统中的默认 shell。需要个性化配置 zsh 的同学,可以参考少数派的这篇文章:让你的 Mac 提前用上 macOS Catalina 的 Shell——Oh My Zsh 配置指南。本文不再复述。

以下是我的 MNMP(macOS-nginx-MySQL-PHP)的安装过程。

本教程用使用了三处代替:

  • 使用 iTerm2 代替了系统自带的命令行终端
  • 使用 nginx 代替了系统自带的 Apache
  • 使用 自行安装的 PHP7.4 代替了系统自带的 PHP7.3.9

安装 iTerm2

推荐 iTerm2,iTerm2 功能强大,可以替代系统默认的命令行终端。下载解压后,将 iTerm2 直接拖入"应用程序"目录。

安装 PhpStorm

推荐 JetBrains PhpStorm 作为集成开发工具。

安装 Xcode

Xcode 是苹果出品的包含一系列工具及库的开发套件。通过 AppStore 安装最新版本的 Xcode(9.0)。我们一般不会用 Xcode 来开发后端项目。但这一步也是必须的,因为 Xcode 会附带安装一些如 Git 等必要的软件。

安装 Command Line Tools for Xcode

这一步会帮你安装许多常见的基于 Unix 的工具。Xcode 命令行工具作为 Xcode 的一部分,包含了 GCC 编译器。在命令行中执行以下命令即可安装:

xcode-select --install # 安装 Xcode Command Line Tools

当 Xcode 和 Xcode Command Line Tools 安装完成后,你需要启动 Xcode,并点击同意接受许可协议,然后关闭 Xcode 就可以了。这一步骤也是必须的,否则 Xcode 包含的一系列开发工具都将不可用。

安装 Homebrew

Homebrew 作为 macOS 不可或缺的套件管理器,用来安装、升级以及卸载常用的软件。在命令行中执行以下命令即可安装:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" # 使用系统自带的 ruby 安装 Homebrew

安装后可以修改 Homebrew 源,国外源一直不是很给力,这里我们将 Homebrew 的 git 远程仓库改为中国科学技术大学开源软件镜像

cd "$(brew --repo)"
git remote set-url origin https://mirrors.ustc.edu.cn/brew.git # 替换brew.git:

cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git # 替换homebrew-core.git:

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc # 替换Homebrew Bottles源:

source ~/.zshrc

安装 PHP 7.4

安装 PHP7.4.* 来代替系统自带的 PHP7.3:

brew install php

启动 php 服务:

brew services start php

替换系统自带的 php-fpm:

echo 'export PATH="/usr/local/opt/php/sbin:$PATH"' >> ~/.zshrc
source ~/.zshrc

查看版本信息:

php -v
php-fpm -v

安装 MySQL

推荐 MySQL 8.0 作为数据库服务器:

brew install mysql

当然,你也可以选择安装 PostgreSQL 或者 MariaDB。

安装完成后,启动 MySQL:

brew services start mysql

进入 MySQL 服务器:

mysql -u root -p

设置 root 密码、安全等级等参数:

mysql_secure_installation

按照步骤提示一步一步来即可。

安装 Redis

安装 redis 服务器:

brew install redis

安装完成后,启动 Redis:

brew services start redis

使用 redis 客户端:

redis-cli

安装 nginx

这里我们选择 nginx 代替系统自带的 Apache,作为我们的 Web 服务器:

brew install nginx

启动 nginx 服务:

brew services start nginx

查看已安装的 brew services:

brew services list

配置 nginx.conf 文件

通过以下命令可以查看 nginx.conf 文件的位置:

nginx -h

输出:

nginx version: nginx/1.17.3
Usage: nginx [-?hvVtTq] [-s signal] [-c filename] [-p prefix] [-g directives]
Options:
-?,-h : this help
-v : show version and exit
-V : show version and configure options then exit
-t : test configuration and exit
-T : test configuration, dump it and exit
-q : suppress non-error messages during configuration testing
-s signal : send signal to a master process: stop, quit, reopen, reload
-p prefix : set prefix path (default: /usr/local/Cellar/nginx/1.17.3_1/)
-c filename : set configuration file (default: /usr/local/etc/nginx/nginx.conf)
-g directives : set global directives out of configuration file

打开配置文件:

vi /usr/local/etc/nginx/nginx.conf

在文件末尾可以看到:

include servers/*;

它将同目录下的servers目录里的文件都包含了进来,由此,我们可以在servers文件里创建开发项目的配置信息:

cd /usr/local/etc/nginx/servers/
vi test.conf

将以下配置信息,写入 test.conf文件中:

server {
    listen 8099;
    server_name localhost;
    root /home/www/php-project;
    rewrite . /index.php;
    location / {
    index index.php index.html index.htm;
    autoindex on;
    }
    #proxy the php scripts to php-fpm
    location ~ \.php$ {
        include /usr/local/etc/nginx/fastcgi.conf;
        fastcgi_intercept_errors on;
        fastcgi_pass 127.0.0.1:9000;
    }
}

在上述的/home/www/php-project的目录下,我们创建一个 index.php 文件:

vim /home/www/php-project/index.php

写入内容:

<?php
    phpinfo();

重启 nginx:

brew services restart nginx

打开浏览器,访问http://localhost:8099,即可访问到关于 PHP 配置的信息。

安装 Composer

Composer 是 PHP 用来管理依赖(dependency)关系的工具。你可以在自己的项目中声明所依赖的外部工具库(libraries),Composer 会帮你安装这些依赖的库文件。

安装并替换镜像:

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ # 改为阿里云的国内源

安装 PHP 扩展

以 php-redis 扩展为例,有下载源码包来进行安装或者 pecl install 安装:

wget https://pecl.php.net/get/redis-5.1.0.tgz # 下载源码包
tar -zxvf redis-5.1.0.tgz # 解压
cd redis-5.1.0 # 进入目录
phpize # 生成编译配置
./configure # 编译配置检测
make # 编译
make install # 安装

扩展安装完成后,我们还需最后一步,修改php.ini文件,并重启 PHP 服务:

vi /usr/local/etc/php/7.4/php.ini # 追加 extension=redis.so
brew services restart php # 重启 php 服务
php -m |grep redis # 查看是否安装成功

或者使用 pecl 安装:

pecl install redis

详细步骤可参考官方文档:phpredis install

本作品采用《CC 协议》,转载必须注明作者和本文链接
本帖由系统于 2年前 自动加精
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
讨论数量: 15

:sob: 听我同事们说卡巴斯基,我也就不当勇士了

4年前 评论

@XiaohuiLam 实际使用下来还可以,我是16款。

4年前 评论
wangchunbo

mac安装mysql,建议直接官网下载,不要使用brew,会有很多问题。
不要低估新手的搞事能力。
可以看看我这个记录的坑。。。
http://www.shxdledu.cn/post/mac%E5%AE%89%E...

4年前 评论
wangchunbo

nginx设置虚拟主机,mysql,redis设置密码,php切换版本。
如果楼主有的话就补上呗,让更多人看到。
我就不参合了。

4年前 评论

不错,我是黑果,TPx250-10.14.6,HPzbook-10.15.1。其实自带环境感觉不能灵活切换,还是推荐homestead,很方便。值得一研究。

4年前 评论
wangchunbo

@RichardChen 卧槽,我从你这个昵称里可以猜出你是谁。你现在发展如何

4年前 评论

laradock 不香吗?

4年前 评论
jxlwqq (楼主) 4年前

最好用docker, 方便管理

4年前 评论
cjy825 4年前

更改了 brew 源, brew doctor 就出现 warning , 提示 默认源 已经找不到了, 你可以通过下面命令恢复, 最后一个是 Unbrewed header files were found in /usr/local/include . IF ...... 但是没影响使用,更新了PHP版本也没快,很慢啊 :sob:

4年前 评论

@qinplain source ~/.bash_profile、~/.bashrc

4年前 评论

有帮助的到我,谢谢

3年前 评论

大神好,打出php -m|grep redis 命令后,爆出出现Warning: PHP Startup: Unable to load dynamic library ‘redis.so’ (tried: /usr/local/lib/php/pecl/20190902/redis.so (dlopen(/usr/local/lib/php/pecl/20190902/redis.so, 9): no suitable image found.

1年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!