phpbrew构建和安装多个 PHP 版本
phpbrew 是一个工具,可以在 $HOME 目录中构建和安装多个 PHP 版本。
phpbrew 的功能包括
将配置选项简化为变体,不再担心路径问题。
使用不同的变体构建 PHP,如 PDO、mysql、sqlite、debug 等。
编译 Apache PHP 模块,并按不同版本分开。
在个人目录中构建和安装 PHP,无需 root 权限。
轻松切换版本,与 bash/zsh shell 集成。
自动功能检测。
轻松在当前环境中安装和启用 PHP 扩展。
在系统范围内安装多个 PHP。
针对 HomeBrew 和 MacPorts 的路径检测优化。
要求
请查看 Requirement[1] 在开始之前。你需要安装一些用于构建 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[2]。
额外的配置选项
要传递额外的配置参数,可以这样做:
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
参考资料
[1]Requirement: https://github.com/phpbrew/phpbrew/wiki/Requirement
[2]PHPBrew Cookbook: https://github.com/phpbrew/phpbrew/wiki
以上就是一文精通php多版本管理工具phpbrew使用教程的详细内容,更多关于php多版本管理工具phpbrew的资料请关注其它相关文章!