在 macOS Catalina 10.15 搭建 PHP 開發環境

jxlwqq發表於2019-11-04
MacPHP開發環境

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.3 代替了系統自帶的 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.3

安裝 PHP7.3.* 來代替系統自帶的 PHP7.3（之後釋出的php7.4同理安裝即可）：

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 擴充套件

不推薦用 pecl 的方式安裝 PHP 擴充套件。以 php-redis 擴充套件為例，推薦下載原始碼包來進行安裝：

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.3/php.ini # 追加 extension=redis.so
brew services restart php # 重啟 php 服務
php -m |grep redis # 檢視是否安裝成功

詳細步驟可參考官方文件：phpredis install

相關文章