至于CPX，对标 npx 的 PHP 包执行器

在 PHP 环境中，Composer 是我们安装依赖的标准工具。但在日常开发与 CI 流程里我们往往会遇到以下痛点：

• 全局安装的工具与项目本地依赖冲突，导致“依赖死锁”。
• 需要频繁切换不同版本的工具，却不想每个项目都重复安装。怎么说呢，
• 一次性脚本或 Gist 需要快速运行。但又不想手动处理 autoload 与环境。
• 在 CI 或非交互式环境下命令行工具无法正常工作。怎么说呢，

CPX正是为解决这些问题而生。它让你可以像使用 npx 一样。在任何地方直接执行 Composer 包中的命令，而无需将包永久安装到项目或全局。说起来，

一、运行尚未安装的包

只需传入包名、可输入命令还有参数。即可立即跑起来，

cpx friendsofphp/php-cs-fixer php-cs-fixer fix ./src
cpx friendsofphp/php-cs-fixer:^ php-cs-fixer fix ./src
cpx ../my-package --version # 本地开发时直接指向源码目录

如果包只有一个可执行文件，甚至可以省略命令；若包含多个，可自动提示你选择。这样，你就不必担心 “找不到命令” 或 “冲突版本” 的报错。

二、默认优先使用本地可执行文件

对于已经在项目里存在的工具。CPX 会先尝试使用本地版本，以保持一致性和避免升级导致的不兼容。从例如来看，

cpx pint # 先查找 vendor/bin/pint
cpx phpunit --filter=Foo # 先查找 vendor/bin/phpunit
cpx laravel/pint:^ # 当满足版本约束时才回退到隔离副本

若想强制使用隔离副本。可加上 --skip-local。

三、别名自定义 & 管理命令

.x 曾提供固定快捷方式，但现在完全交给使用者自行定义：

cpx alias phpstan/phpstan phpstan # 简化后缀
cpx alias laravel/pint # 默认生成 pint 别名

• cpx aliases: 列出所有别名。
• cpx unalias : 删除别名。说起来，
• cpx installed: 查看已通过 CPX 运行过的包。
• cpx clean : 清理最近未使用的隔离副本。

四、快速运行 PHP 文件、Gist 与 REPL

CPEX 提供两种方便模式：exec 用于单文件脚本或代码片段； tinker 用于交互式 REPL。

# 执行单文件脚本
cpx exec script.php
# 在当前进程中立即打印 PHP 版本
cpx exec -r 'echo PHP_VERSION;'
# 从 GitHub Gist 下载并运行脚本
cpx exec https://gist.github.com/user/id
# 启动 Laravel 或 Symfony 项目的 Tinker 控制台
cpx tinker

CPEX 会自动检测当前目录是否有 Composer 自动加载器，并根据需要引入缺失类；说起来，在 Laravel 项目中，它会完整启动应用；在 Symfony 项目中则暴露 kernel 与 $container。不过，加上 --no-boot。可跳过启动过程，节省时间。所有使用者代码都在独立进程里跑。不会与 CPEX 自带依赖冲突，而且退出码会原封不动返回。

示例这方面，按需引入 Carbon 并输出时间：

Laravel tinker 示例：

• CPEX 会把控制权移交给项目自身的 /artisan tinker。并转发如 .
• 其他框架则弹出 PsySH shell.

五、感知代理环境 & 输出格式化

CPEX 能识别非交互式终端，例如重定向 stdin、传入 -n/--no-interaction ,或 AI 代理调用。这时子进程不会获得 TTY，所有交互提示均自动采用默认值，同时管理命令返回简洁 JSON 格式，让 CI 脚本更易解析：

{
"success": true。"errors":,"summary": {
"packages":
}
}

CPEX 本身的进度渲染被抑制，只输出底层工具产生的数据流；任何失败也以 JSON 报告，方便机器解析。加上 -j/--json ,可在交互终端得到一样输出。若要覆盖已有别名，需要加上 -f/--force .

六、安装与升级说明

• CPEX 需要 PHP ≥ 8.x。
• Avoid global Composer installations that pollute your system path unless you truly want a globally available CLI.
• Add Composer's global bin directory to your PATH.
• `composer global require cpx/cpx`就可以完成全局安装；随后即可随处调用 `cpx` 命令。
*Tip:* If you already use .x in your workflow,refer to .x‑to‑CXP upgrade guide and visit cpx.dev for a polished landing page.

七、进一步阅读与社区资源:

• Main repository and docs:
• User guide and examples on cpx.dev.
• Taylor Otwell’s Laracon US keynote demo of CPX .
Note: The original article “对标 npx 的 CPX PHP 的 Composer 包执行器” contains additional footnotes which are now integrated into this comprehensive overview.

---

1. Global installs can lock your project to incompatible versions of libraries like PHPUnit or Laravel Mix. CPX sidesteps this by installing each package in isolation per command execution. 
2. When executing a script or Gist。you often need autoloading and environment variables from your project context. CPX automatically loads composer autoloader and injects framework bootstrapping if present. 
3. CI pipelines or AI agents typically run non-interactively. CPX detects this mode and returns JSON summaries so that automated tools can parse success/failure without manual inspection. 

---