PHPBrew 使用指南

欢迎转载，但请在开头或结尾注明原文出处【blog.chaosjohn.com】

前言

咋一看，这个名字取得，肯定是跟 Homebrew 学的。既然 Homebrew 的定位是 macOS 上的 包管理器，那 PHPBrew 肯定也跟 包管理器 沾点边。没错，它可以用来 构建 和 安装 多个版本的 php 到用户主目录($HOME)下。

项目主页

抄一下 PHPBrew 的特性:

  • 编译配置选项简化为variant，不用再过于担心搜寻路径
  • 通过不同的variant(比如PDO, mysql, sqlite, debug等等)进行构建php
  • 编译 apache 和 nginx 模块，并且按不同版本区分
  • 构建和安装到用户主目录下，免去root权限
  • 版本间易于切换，且与bash/zsh集成
  • 自动特性检测
  • 易于安装和启用 php扩展 到当前环境
  • 支持安装多个版本的 php 到系统环境中
  • 为 Homebrew 和 MacPorts 优化路径检测

环境需求

  • 平台支持
    • Mac OS 10.5+
    • Ubuntu
    • Debian
    • RHEL / CentOS
  • 依赖需求
    • PHP5.3+
    • bz2
    • curl
    • gcc, binutils, autoconf, libxml, zlib, readline

各平台上的依赖安装请参考官方文档，这里笔者仅附上 Mac OS + Homebrew 和 Ubuntu 20.04的安装命令

  • Mac OS
$ xcode-select --install
$ brew install autoconf pkg-config
  • Ubuntu 20.04
$ sudo apt update
$ sudo apt install build-essential libbz2-dev libreadline-dev libsqlite3-dev libssl-dev libxml2-dev php7.4-cli php7.4-bz2 pkg-config

安装

下载

$ curl -L -O https://github.com/phpbrew/phpbrew/releases/latest/download/phpbrew.phar
$ chmod +x phpbrew.phar

安装到配置在 $PATH 环境变量里的bin目录，比如官方文档里的 /usr/local/bin（笔者用的是 $HOME/bin）

sudo mv phpbrew.phar /usr/local/bin/phpbrew

设置

初始化shell环境

$ phpbrew init

init 指令将会创建 $HOME/.phpbrew 目录

将下面一行加入 .bashrc 或者 .zshrc

[[ -e ~/.phpbrew/bashrc ]] && source ~/.phpbrew/bashrc

设置搜寻路径前缀

设置默认的搜寻路径前缀，用于搜寻依赖库，可选项有 macports, homebrew, debian, ubuntu 或者 自定义路径

  • Homebrew用户
$ phpbrew lookup-prefix homebrew
  • MacPorts用户
$ phpbrew lookup-prefix macports

基本用法

列举已知的版本

$ phpbrew known
===> Fetching release list...
Downloading https://www.php.net/releases/index.php?json=1&version=8&max=100 via php stream
Downloading https://www.php.net/releases/index.php?json=1&version=7&max=100 via php stream
8.0: 8.0.0 ...
7.4: 7.4.13, 7.4.12, 7.4.11, 7.4.10, 7.4.9, 7.4.8, 7.4.7, 7.4.6 ...
7.3: 7.3.25, 7.3.24, 7.3.23, 7.3.22, 7.3.21, 7.3.20, 7.3.19, 7.3.18 ...
7.2: 7.2.34, 7.2.33, 7.2.32, 7.2.31, 7.2.30, 7.2.29, 7.2.28, 7.2.27 ...
7.1: 7.1.33, 7.1.32, 7.1.31, 7.1.30, 7.1.29, 7.1.28, 7.1.27, 7.1.26 ...
7.0: 7.0.33, 7.0.32, 7.0.31, 7.0.30, 7.0.29, 7.0.28, 7.0.27 ...

想看到更多小版本

$ phpbrew known --more
Read local release list (last update: 2020-12-01 03:46:52 UTC).
You can run `phpbrew update` or `phpbrew known --update` to get a newer release list.
8.0: 8.0.0
7.4: 7.4.13, 7.4.12, 7.4.11, 7.4.10, 7.4.9, 7.4.8, 7.4.7, 7.4.6, 7.4.5, 7.4.4, 7.4.3,
     7.4.2, 7.4.1, 7.4.0
7.3: 7.3.25, 7.3.24, 7.3.23, 7.3.22, 7.3.21, 7.3.20, 7.3.19, 7.3.18, 7.3.17, 7.3.16,
     7.3.15, 7.3.14, 7.3.13, 7.3.12, 7.3.11, 7.3.10, 7.3.9, 7.3.8, 7.3.7, 7.3.6,
     7.3.5, 7.3.4, 7.3.3, 7.3.2, 7.3.1, 7.3.0
7.2: 7.2.34, 7.2.33, 7.2.32, 7.2.31, 7.2.30, 7.2.29, 7.2.28, 7.2.27, 7.2.26, 7.2.25,
     7.2.24, 7.2.23, 7.2.22, 7.2.21, 7.2.20, 7.2.19, 7.2.18, 7.2.17, 7.2.16, 7.2.15,
     7.2.14, 7.2.13, 7.2.12, 7.2.11, 7.2.10, 7.2.9, 7.2.8, 7.2.7, 7.2.6, 7.2.5,
     7.2.4, 7.2.3, 7.2.2
7.1: 7.1.33, 7.1.32, 7.1.31, 7.1.30, 7.1.29, 7.1.28, 7.1.27, 7.1.26, 7.1.25, 7.1.24,
     7.1.23, 7.1.22, 7.1.21, 7.1.20, 7.1.19, 7.1.18, 7.1.17, 7.1.16, 7.1.15, 7.1.14
7.0: 7.0.33, 7.0.32, 7.0.31, 7.0.30, 7.0.29, 7.0.28, 7.0.27

更新最新版本发行列表

$ phpbrew update
===> Fetching release list...
Downloading https://www.php.net/releases/index.php?json=1&version=8&max=100 via php stream
Downloading https://www.php.net/releases/index.php?json=1&version=7&max=100 via php stream
8.0: 1 releases
7.4: 14 releases
7.3: 26 releases
7.2: 33 releases
7.1: 20 releases
7.0: 7 releases
===> Done

获取小于7.0的老版本（官方文档已滞后，还仅仅只把 小于5.4 作为老版本）

注意：不保证能成功构建这些不被PHPBrew官方支持的版本

$ phpbrew update --old

列举小于7.0的老版本

$ phpbrew known --old
===> Fetching release list...
Downloading https://www.php.net/releases/index.php?json=1&version=8&max=100 via curl extension
Downloading https://www.php.net/releases/index.php?json=1&version=7&max=100 via curl extension
Downloading https://www.php.net/releases/index.php?json=1&version=5&max=1000 via curl extension
8.0: 8.0.0 ...
7.4: 7.4.13, 7.4.12, 7.4.11, 7.4.10, 7.4.9, 7.4.8, 7.4.7, 7.4.6 ...
7.3: 7.3.25, 7.3.24, 7.3.23, 7.3.22, 7.3.21, 7.3.20, 7.3.19, 7.3.18 ...
7.2: 7.2.34, 7.2.33, 7.2.32, 7.2.31, 7.2.30, 7.2.29, 7.2.28, 7.2.27 ...
7.1: 7.1.33, 7.1.32, 7.1.31, 7.1.30, 7.1.29, 7.1.28, 7.1.27, 7.1.26 ...
7.0: 7.0.33, 7.0.32, 7.0.31, 7.0.30, 7.0.29, 7.0.28, 7.0.27 ...
5.6: 5.6.40, 5.6.39, 5.6.38, 5.6.37, 5.6.36, 5.6.35, 5.6.34, 5.6.33 ...
5.5: 5.5.38, 5.5.37, 5.5.36, 5.5.35, 5.5.34, 5.5.33, 5.5.32, 5.5.31 ...
5.4: 5.4.45, 5.4.44, 5.4.43, 5.4.42, 5.4.41, 5.4.40, 5.4.39, 5.4.38 ...
5.3: 5.3.29, 5.3.28, 5.3.27, 5.3.26, 5.3.25, 5.3.24, 5.3.23, 5.3.22 ...
5.2: 5.2.17, 5.2.16, 5.2.15, 5.2.14, 5.2.13, 5.2.12, 5.2.11, 5.2.10 ...
5.1: 5.1.6, 5.1.5, 5.1.4, 5.1.3, 5.1.2, 5.1.1, 5.1.0 ...
5.0: 5.0.5, 5.0.4, 5.0.3, 5.0.2, 5.0.1, 5.0.0 ...
PHPBrew needs PHP 5.3 or above to run. build/switch to versions below 5.3 at your own risk.

开始构建你自己的PHP

用默认variant简单构建并安装PHP：

$ phpbrew install 7.4.13 +default

这里我们推荐使用 default 设置，它涵盖了大部分广泛使用的variant；如果你需要一个 最小化 安装，那就移除 default，替换成别的variant（经笔者摸索，最小化 为 +opcache -xml）。

通过传递参数 -j 或者 --jobs 进行并行编译：

$ phpbrew install -j $(nproc) 7.4.13 +default

包含测试：

$ phpbrew install --test 7.4.13 +default

包含调试信息：

$ phpbrew -d install --test 7.4.13 +default

安装小于5.3的老版本（笔者实测5.0版本的链接均已不可访问）

$ phpbrew install --old 5.2.17

安装 next 不稳定版：

$ phpbrew install next

从GitHub仓库的某tag安装

$ phpbrew install github:php/php-src@PHP-7.0

用 as 给构建安装的PHP取别名，以笔者在前面描述的 最小化 安装举例

$ phpbrew install 7.4.13 +opcache -xml as 7.4.13-minimal

清理构建目录

$ phpbrew clean 7.4.13-minimal
===> Running make clean: /usr/bin/make -C '/Users/chaos/.phpbrew/build/7.4.13-minimal' --quiet 'clean'
Distribution is cleaned up. Woof!

Variants

PHPBrew 帮你安排构建参数，你可以简单地指定variant，PHPBrew会自动检测 include 路径并且构建编译选项。

PHPBrew 提供了默认的和虚拟的variant。默认的包含了大部分广泛使用的variants；虚拟的则定义了一组variant，即使用一个虚拟variant可以同时选用多个variant。

查看PHPBrew提供了哪些variant：

$ phpbrew variants
Variants:
  all, apxs2, bcmath, bz2, calendar, cgi, cli, ctype, curl, dba, debug, dom,
  dtrace, editline, embed, exif, fileinfo, filter, fpm, ftp, gcov, gd,
  gettext, gmp, hash, iconv, imap, inifile, inline, intl, ipc, ipv6, json,
  kerberos, ldap, libgcc, mbregex, mbstring, mcrypt, mhash, mysql, opcache,
  openssl, pcntl, pcre, pdo, pear, pgsql, phar, phpdbg, posix, readline,
  session, soap, sockets, sodium, sqlite, static, tidy, tokenizer, wddx,
  xml, xmlrpc, zip, zlib, zts


Virtual variants:
  dbs: sqlite, mysql, pgsql, pdo
  mb: mbstring, mbregex
  neutral:
  small: bz2, cli, dom, filter, ipc, json, mbregex, mbstring, pcre, phar,
  posix, readline, xml, curl, openssl
  default: bcmath, bz2, calendar, cli, ctype, dom, fileinfo, filter, ipc,
  json, mbregex, mbstring, mhash, pcntl, pcre, pdo, pear, phar, posix,
  readline, sockets, tokenizer, xml, curl, openssl, zip
  everything: dba, ipv6, dom, calendar, wddx, static, inifile, inline, cli,
  ftp, filter, gcov, zts, json, hash, exif, mbstring, mbregex, libgcc,
  pdo, posix, embed, sockets, debug, phpdbg, zip, bcmath, fileinfo, ctype,
  cgi, soap, pcntl, phar, session, tokenizer, opcache, imap, ldap, tidy,
  kerberos, xmlrpc, fpm, dtrace, pcre, mhash, mcrypt, zlib, curl, readline,
  editline, gd, intl, sodium, openssl, mysql, sqlite, pgsql, xml, gettext,
  iconv, bz2, ipc, gmp, pear


Using variants to build PHP:

  phpbrew install php-5.3.10 +default
  phpbrew install php-5.3.10 +mysql +pdo
  phpbrew install php-5.3.10 +mysql +pdo +apxs2
  phpbrew install php-5.3.10 +mysql +pdo +apxs2=/usr/bin/apxs2

可以看到虚拟variant有：dbs, mb, neutral, small, default, everything

（表明上来看 neutral 是最精简的，它不添加任何编译选项，但实际安装过程中还是会启用 xml 和 opcache，而这二者中只有后者无任何第三方依赖。所以真正意义上的 最小化 为 +opcache -xml 或者 +neutral -xml）

  • 需要启用一个variant，直接在variant前加一个 + 号
  • 需要禁用一个variant，直接在variant前加一个 - 号
  • + 和 - 号可以多个随意组合

指定依赖路径，比如构建pgsql扩展时

$ phpbrew install 7.4.13 +pdo +pgsql=/opt/local/lib/postgresql91/bin

在 /opt/local/lib/postgresql91/bin 路径下的 pg_config 是构建时需要的

传递额外的configure选项

$ phpbrew install 7.4.13 +mysql +sqlite -- \
    --enable-ftp --apxs2=/opt/local/apache2/bin/apxs

使用与切换

使用（临时切换版本）

$ phpbrew use 7.4.13
$ phpbrew use 7.4.13-minimal

切换默认版本

$ phpbrew switch 7.4.13-minimal

从PHPBrew的版本切换到系统安装的版本

$ phpbrew off

列举安装的所有php版本

$ phpbrew list

扩展安装器

PHPBrew 还能方便的帮助你安装 PHP扩展（无论是PHP源码内自带的亦或是来自于 PECL 的）

如果是PHP源码内自带的，PHPBrew会自动切换到源码目录进而安装扩展；否则会去 PECL http://pecl.php.net去获取扩展源码包

PHPBrew同时会为安装上的扩展创建配置，省去你手写启用扩展的配置文件。配置文件夹位于: $HOME/.phpbrew/php/{php-version}/var/db

安装扩展 - 最简单的方式

在你安装任何扩展之前，你应该切换到需要安装扩展的php版本：

$ phpbrew use 7.4.13-minimal

然后运行 ext install 来安装自己需要的扩展

$ phpbrew ext install redis
$ phpbrew ext install xdebug
$ phpbrew ext install acpu
$ phpbrew ext install memcache

安装扩展 - 指定稳定性版本

  • 指定 稳定性标签，可选项有 stable / latest / beta，不指定即默认为 stable，例如：$ phpbrew ext install xdebug latest
  • 指定 扩展版本号，例如：$ phpbrew ext install xdebug 3.0.0

查看扩展的配置选项

要查看构建扩展是否有额外的配置选项，使用 ext show

$ phpbrew ext show redis
                Name: redis
    Source Directory: /Users/chaos/.phpbrew/build/7.4.13/ext/redis
              Config: /Users/chaos/.phpbrew/build/7.4.13/ext/redis/config.m4
            INI File: /Users/chaos/.phpbrew/php/7.4.13/var/db/redis.ini
           Extension: Pecl
                Zend: no
              Loaded: yes

   Configure Options:

        --enable-redis-igbinary[=no]     enable igbinary serializer support?

        --enable-redis-lzf[=no]          enable lzf compression support?

        --enable-redis-zstd[=no]         enable zstd compression support?

为构建扩展添加额外配置选项

$ phpbrew ext install redis -- --enable-redis-lzf=yes

从Github安装扩展

特殊的前缀 github: 则告诉PHPBrew要去 php-memcached-dev/phpmemcached 的 php7 分支拉取代码进行构建

$ phpbrew ext install github:php-memcached-dev/php-memcached php7 -- --disable-memcached-sasl

指定下载器进行安装扩展

目前，PHPBrew有4个下载器实现：

  • php_curl 内置的 php curl扩展，为默认下载器
  • php_stream 内置的 php steam封装
  • curl
  • wget

指定 curl 作为下载器：

$ phpbrew ext install --downloader curl redis

如果选用的下载器支持 User-Agent 和 Proxy 配置：

$ phpbrew ext install --downloader php_curl --http-proxy=... --http-proxy-auth=... apcu

启用扩展

笔者亲测，通过 ext install 安装的扩展，安装完即为启用状态。

另外也可以通过 PECL 安装扩展并且手动启用：

$ pecl install mongo
$ phpbrew ext enable mongo

ext enable 指令帮你创建配置文件 {current php base}/var/db/{extension name}.ini 用以启用扩展

为当前php版本配置 php.ini 

$ export EDITOR=vim # 该行为可选项，指定你常用的编辑器
$ phpbrew config

更新 PHPBrew

运行 self-update 指令将会从Github的master分支下载最新版本的二进制文件替换自身（即本文开头的存放位置/usr/local/bin/phpbrew）

相关的目录

已安装的php位于 $HOME/.phpbrew/php，以 7.4.13-minimal 举例，为 $HOME/.phpbrew/php/7.4.13-minimal/bin/php

配置文件为 $HOME/.phpbrew/php/7.4.13-minimal/etc/php.ini

扩展的配置文件位于 $HOME/.phpbrew/php/7.4.13-minimal/var/db目录下：

$HOME/.phpbrew/php/7.4.13-minimal/var/db/memcache.ini
$HOME/.phpbrew/php/7.4.13-minimal/var/db/xdebug.ini
$HOME/.phpbrew/php/7.4.13-minimal/var/db/redis.ini

在各目录之间切换的快捷命令

~官方文档里这部分涉及的指令，比如 build-dir / dist-dir / etc-dir / var-dir 已亲测全部阵亡~

PHP fpm

PHPBrew同时也为 php-fpm 提供了管理指令（前提是在构建的时候得加上 +fpm variant）

启动/停止/重启 php-fpm：

$ phpbrew fpm start
$ phpbrew fpm stop 
$ phpbrew fpm restart

显示 php-fpm 模块：

$ phpbrew fpm module
[PHP Modules]
bz2
cgi-fcgi
Core
ctype
curl
...

[Zend Modules]
Xdebug

测试 php-fpm 配置是否正确：

$ phpbrew fpm test
[01-Dec-2020 18:28:04] NOTICE: configuration file /Users/chaos/.phpbrew/php/7.4.13/etc/php-fpm.conf test is successful

编辑 php-fpm 配置：

$ export EDITOR=vim # 该行为可选项，指定你常用的编辑器
$ phpbrew fpm config

已安装的 php-fpm 位于 $HOME/.phpbrew/php/{php-version}/sbin 下

相应的 php-fpm.conf 位于 $HOME/.phpbrew/php/{php-version}/etc/php-fpm.conf.default, 你可以将默认配置文件拷贝到需要的位置进行使用，比如

$ cp -v ~/.phpbrew/php/{php-version}/etc/php-fpm.conf.default ~/.phpbrew/php/{php-version}/etc/php-fpm.conf

$ php-fpm --php-ini ~/.phpbrew/php/{php-version}/etc/php.ini --fpm-config ~/.phpbrew/php/{php-version}/etc/php-fpm.conf

安装扩展应用

~通过 app get 指令来安装例如 composer 和 phpunit 这样的 app，笔者亲测该指令也已阵亡~

结尾

以上便是笔者结合 PHPBrew 官方文档给大家梳理的使用指南，写该文时每条指令笔者都亲自测试过，所以发现了官方文档里有很多地方都 已过时 或 已更新。对于前者，笔者用横线给划掉了；对于后者，笔者直接进行了修正。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 218,451评论 6赞 506
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 93,172评论 3赞 394
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 164,782评论 0赞 354
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,709评论 1赞 294
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,733评论 6赞 392
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,578评论 1赞 305
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,320评论 3赞 418
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 39,241评论 0赞 276
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,686评论 1赞 314
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,878评论 3赞 336
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,992评论 1赞 348
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,715评论 5赞 346
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 41,336评论 3赞 330
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,912评论 0赞 22
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,040评论 1赞 270
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 48,173评论 3赞 370
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,947评论 2赞 355