README

🥇 macOS 下优雅管理多版本 PHP 的命令行工具

简介

Ace 是一款 macOS 平台下的 PHP 多版本切换工具，灵感来自优秀的 laravel/valet。

如果你本地安装了多个版本的 PHP，并希望在不同项目中使用不同版本，Ace 将是你不可或缺的工具。

只需在项目根目录下运行：

ace
# 或者
ace php

Ace 会自动为当前项目匹配最合适的 PHP 版本，无需手动切换。

快速命令参考

ace                 # 等同于 ace php
ace php             # 使用项目对应 PHP 版本运行
ace composer        # 使用匹配的 PHP 版本执行 composer
ace pecl            # 使用匹配的 PHP 版本执行 pecl
ace artisan         # 执行 Laravel 命令
ace clear           # 清除缓存
ace hello           # 打印 Hello Ace!

# 示例用法
ace -v                      # 查看当前使用的 PHP 版本
ace php -v                 # 同上
ace artisan migrate        # 执行 Laravel 数据迁移
ace composer install       # 安装依赖
ace pecl install redis     # 安装扩展

版本匹配逻辑

Ace 会按照以下优先级查找项目所需 PHP 版本：

当前目录中的 ace.json
当前目录中的 composer.json
系统环境变量中的默认 PHP 版本

例如：

// ace.json 示例
{
  "php": "^7.4.0"
}

支持语义化版本约束，详见 https://semver.org/lang/zh-CN/

安装方式

# 安装
composer global require mitoop/ace

# 升级（先移除旧版本）
composer global remove mitoop/ace
composer global require mitoop/ace

注意事项

支持的 PHP 版本为 >= 7.1
若版本约束为 ^7.1，且本地存在 php@7.1, php@7.2, php@7.3, php@7.4, php@8.0 等版本，Ace 会选择 最高的 php@7.x，即 php@7.4
若需固定版本，请在项目中创建 ace.json 并指定版本
首次运行会缓存所有已安装的 PHP 版本，加快后续执行速度。新增/移除 PHP 后请运行 ace clear 清除缓存
多版本 PHP 同时启用时，需注意 php-fpm 的监听端口冲突。建议使用不同端口，或通过 unix socket 方式运行
推荐使用 shivammathur/homebrew-php 安装旧版本 PHP
多版本 PHP 安装相同扩展（如 redis）时可能冲突。可在对应版本下先卸载再安装
Composer 高版本对 PHP 有最低要求，例如：
```
Composer 2.3.0 dropped support for PHP <7.2.5
```
可使用长期维护版：
```
composer self-update --2.2
```

灵感来源

✨ Inspired by the great laravel/valet

mitoop / ace

Maintainers

Details