一篇文章精通php多版本管理工具：phpbrew

2023-01-04
4分钟阅读时长
分类

phpbrew是一个工具，可以在$HOME目录中构建和安装多个PHP版本。

phpbrew的功能包括：

  1. 将配置选项简化为变体，不再担心路径问题。
  2. 使用不同的变体构建PHP，如PDO、mysql、sqlite、debug等。
  3. 编译Apache PHP模块，并按不同版本分开。
  4. 在个人目录中构建和安装PHP，无需root权限。
  5. 轻松切换版本，与bash/zsh shell集成。
  6. 自动功能检测。
  7. 轻松在当前环境中安装和启用PHP扩展。
  8. 在系统范围内安装多个PHP。
  9. 针对HomeBrew和MacPorts的路径检测优化。

img

要求

请查看 Requirement 在开始之前。你需要安装一些用于构建 PHP 的开发包。

安装

只需下载它：

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

然后，你可以将其安装到 bin 文件夹中：

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

确保在你的 $PATH 环境变量中有 /usr/local/bin。

设置

初始化一个用于你的 shell 环境的 bash 脚本：

phpbrew init

将以下行添加到你的 .bashrc 或 .zshrc 文件：

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

设置查找前缀

你可以设置你首选的用于查找库的默认前缀，可用选项有 macports、homebrew、debian、ubuntu 或自定义路径：

对于 Homebrew 用户：

phpbrew lookup-prefix homebrew

对于 Macports 用户：

phpbrew lookup-prefix macports

基本用法

列出已知版本：

$ phpbrew known
7.0: 7.0.3, 7.0.2, 7.0.1, 7.0.0 ...
5.6: 5.6.18, 5.6.17, 5.6.16, 5.6.15, 5.6.14, 5.6.13, 5.6.12, 5.6.11 ...
5.5: 5.5.32, 5.5.31, 5.5.30, 5.5.29, 5.5.28, 5.5.27, 5.5.26, 5.5.25 ...
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 ...

显示更多次要版本：

phpbrew known --more

更新发布信息：

phpbrew update

获取旧版本（低于5.4）

请注意，我们不保证可以成功构建官方不支持的PHP版本，请不要报告有关旧版本的问题，这些问题将不会修复。

phpbrew update --old

列出已知的旧版本（低于5.4）

phpbrew known --old

开始构建自己的PHP

使用默认变体构建和安装PHP：

phpbrew install 5.4.0 +default

这里建议使用默认变体集，其中包括最常用的变体。如果你需要进行最小安装，只需删除默认变体集。

你可以通过传递 -j 或 --jobs 选项启用并行编译，以下是一个示例：

phpbrew install -j $(nproc) 5.4.0 +default

带有测试：

phpbrew install --test 5.4.0

带有调试信息：

phpbrew -d install --test 5.4.0

安装旧版本（低于5.3）：

phpbrew install --old 5.2.13

安装下一个（不稳定）版本：

phpbrew install next as php-7.1.0

从GitHub标签安装：

phpbrew install github:php/php-src@PHP-7.0 as php-7.0.0

清理构建目录：

phpbrew clean php-5.4.0

变体

PHPBrew为你整理了配置选项，你可以简单地指定变体名称，phpbrew将检测包含路径和用于配置的构建选项。

PHPBrew提供了默认变体和一些虚拟变体。默认变体包括最常用的变体，而虚拟变体定义了一个变体集，你可以使用一个虚拟变体一次性启用多个变体。

要查看这些变体中包含了什么，只需运行variants子命令来列出这些变体：

$ phpbrew variants
Variants:
  all, apxs2, bcmath, bz2, calendar, cgi, cli, ctype, dba, debug, dom, embed,
  exif, fileinfo, filter, fpm, ftp, gcov, gd, gettext, hash, iconv, icu,
  imap, intl, ipc, ipv6, json, kerberos, mbregex, mbstring, mcrypt, mhash,
  mysql, openssl, pcntl, pcre, pdo, pgsql, phar, posix, readline, session,
  soap, sockets, sqlite, tidy, tokenizer, xml_all, xmlrpc, zip, zlib, gmp


Virtual variants:
  dbs:      sqlite, mysql, pgsql, pdo
  mb:       mbstring, mbregex
  neutral:
  default:  filter, dom, bcmath, ctype, mhash, fileinfo, pdo, posix, ipc,
            pcntl, bz2, zip, cli, json, mbstring, mbregex, calendar, sockets, readline,
            xml_all

使用变体构建PHP的示例：

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

要启用一个变体，只需在变体名称前加上前缀+，例如：

+mysql

要禁用一个变体，只需在变体名称前加上前缀-。

例如，如果我们希望使用默认选项和数据库支持（mysql、sqlite、postgresql）构建PHP，你可以简单地运行：

phpbrew install 5.4.5 +default+dbs

你还可以使用额外的变体构建PHP：

phpbrew install 5.3.10 +mysql+sqlite+cgi
phpbrew install 5.3.10 +mysql+debug+pgsql +apxs2
phpbrew install 5.3.10 +pdo +mysql +pgsql +apxs2=/usr/bin/apxs2

要构建带有pgsql（PostgreSQL）扩展的PHP：

phpbrew install 5.4.1 +pgsql+pdo

或在Mac OS X上使用postgresql基本目录构建pgsql扩展：

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

pgsql路径是pg_config的位置，你可以在/opt/local/lib/postgresql91/bin找到pg_config。如果要使用中性编译选项构建PHP，你可以指定中性虚拟变体，这意味着phpbrew不会添加任何额外的编译选项，包括--disable-all。但是，一些选项（例如--enable-libxml）仍然会自动添加以支持pear安装。你可以使用中性构建PHP：

phpbrew install 5.4.1 +neutral

有关更多详细信息，请查看 PHPBrew Cookbook 。

额外的配置选项

要传递额外的配置参数，可以这样做：

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

使用和切换

使用（临时切换版本）：

phpbrew use 5.4.22

切换PHP版本（切换默认版本）：

phpbrew switch 5.4.18

关闭：

phpbrew off

如果启用了Apache PHP模块，请记得注释或删除这些设置。

$ sudo vim /etc/httpd/conf/httpd.conf
# LoadModule php5_module        /usr/lib/httpd/modules/libphp5.3.21.so
# LoadModule php5_module        /usr/lib/httpd/modules/libphp5.3.20.so

列出已安装的PHP

phpbrew list

扩展安装程序

您还可以轻松地安装PHP扩展，无论是与PHP源代码一起提供的扩展，还是来自PECL。

如果在PHP源代码中找到扩展目录，PHPBrew将自动切换到PHP源目录并安装扩展。

如果在PHP源代码中未找到扩展目录，PHPBrew将从PECL http://pecl.php.net 获取扩展包。

PHPBrew还创建扩展配置以启用安装的扩展，因此您无需手动编写配置文件即可启用它。扩展配置目录在：

~/.phpbrew/php/php-{version}/var/db

安装扩展 - 最简单的方式

在安装任何PHP扩展之前，应设置当前运行的PHP版本：

phpbrew use php-5.5.6

然后运行ext install来安装扩展：

phpbrew ext install apcu
phpbrew ext install memcache

使用稳定性安装扩展

使用稳定性标签安装扩展：

phpbrew ext install xdebug stable
phpbrew ext install xdebug latest
phpbrew ext install xdebug beta

使用版本名称安装扩展：

phpbrew ext install xdebug 2.0.1

展示扩展配置选项

要查看是否有一些构建扩展的配置选项，可以使用 ext show 命令。请注意，show 命令仅适用于内置扩展：

phpbrew ext show apcu

使用自定义选项安装扩展

phpbrew ext install yaml -- --with-yaml=/opt/local

从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 流包装器下载文件。
  • curl
  • wget

可以使用你喜欢的下载工具替换默认的下载工具：

phpbrew ext install --downloader php_curl apcu

基于 curl 的 php 扩展下载工具支持 User-Agent 和代理设置，因此如果遇到一些网络问题，你可以这样做：

phpbrew ext install --download php_curl --http-proxy=... --http-proxy-auth=... apcu

启用扩展

你还可以通过 PECL 安装扩展并手动启用它：

pecl install mongo
phpbrew ext enable mongo

ext enable 命令允许你创建一个配置文件 {当前 php base}/var/db/{extension name}.ini 来启用该扩展。

配置当前 PHP 版本的 php.ini

只需运行：

phpbrew config

你可以将 EDITOR 环境变量指定为你喜欢的编辑器：

export EDITOR=vim

然后运行：

phpbrew config

升级 phpbrew

要升级 phpbrew，只需运行 self-update 命令，此命令允许你安装来自 GitHub 主分支的最新版本：

phpbrew self-update

已安装的 PHP(s)

已安装的 PHP 位于 ~/.phpbrew/php，例如，PHP 5.4.20 位于：

~/.phpbrew/php/5.4.20/bin/php

你应该将配置文件放在：

~/.phpbrew/php/5.4.20/etc/php.ini

扩展配置文件应放在：

~/.phpbrew/php/5.4.20/var/db
~/.phpbrew/php/5.4.20/var/db/xdebug.ini
~/.phpbrew/php/5.4.20/var/db/apc.ini
~/.phpbrew/php/5.4.20/var/db/memcache.ini
... etc

快速在目录之间切换的命令

切换到 PHP 构建目录：

phpbrew build-dir

切换到 PHP 分发目录：

phpbrew dist-dir

切换到 PHP etc 目录：

phpbrew etc-dir

切换到 PHP var 目录：

phpbrew var-dir

PHP FPM

phpbrew 还提供了一些有用的 FPM 管理子命令。要使用它们，请记住在构建自己的 PHP 时启用 +fpm 变体。

启动 php-fpm，只需键入：

phpbrew fpm start

停止 php-fpm，输入：

phpbrew fpm stop

显示 php-fpm 模块：

phpbrew fpm module

测试 php-fpm 配置：

phpbrew fpm test

编辑 php-fpm 配置：

phpbrew fpm config

已安装的 php-fpm 位于 ~/.phpbrew/php/php-*/sbin。

对应的 php-fpm.conf 位于 ~/.phpbrew/php/php-*/etc/php-fpm.conf.default，你可以将默认配置文件复制到所需的位置。例如，

cp -v ~/.phpbrew/php/php-*/etc/php-fpm.conf.default
    ~/.phpbrew/php/php-*/etc/php-fpm.conf

php-fpm --php-ini {php config file} --fpm-config {fpm config file}

启用版本信息提示

要在 shell 提示中添加 PHP 版本信息，可以使用 “PHPBREW_SET_PROMPT=1” 变量。

默认情况下是 “PHPBREW_SET_PROMPT=0”（禁用）。要启用它，可以将此行添加到你的 ~/.bashrc 文件，并将此行放在 source ~/.phpbrew/bashrc 之前。

export PHPBREW_SET_PROMPT=1

要在提示中嵌入版本信息，可以使用 phpbrew_current_php_version shell 函数，该函数在 .phpbrew/bashrc 中定义。并且你可以在你的 PS1 变量中设置版本信息，例如：

PS1=" \$(phpbrew_current_php_version) \$ "

已知问题

对于 PHP-5.3+ 版本，“在 OS X 上构建 intl 64 位失败” https://bugs.php.net/bug.php?id=48795

要使用 GD 扩展构建 PHP，你需要指定你的 libpng 目录和 libjpeg 目录，例如：

phpbrew install php-5.4.10 +default +mysql +intl +gettext +apxs2=/usr/bin/apxs2 \
  -- --with-libdir=lib/x86_64-linux-gnu \
  --with-gd=shared \
  --enable-gd-natf \
  --with-jpeg-dir=/usr \
  --with-png-dir=/usr

关注公众号获得更多精彩文章

公众号：程序员大兵

#标签

lbbniu

下一页 polaris-go 源码走读

相关

hugoio