如何在Composer中指定PHP的特定扩展需求
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
如何在Composer中指定PHP的特定扩展需求 composer.json 里怎么声明必须启用的 PHP 扩展 很多开发者可能没注意到，Composer本身并不会主动去检查你的PHP环境里启用了哪些扩展。不过，它提供了一个非常直接的约束机制：在composer.json文件的require字段里，
如何在Composer中指定PHP的特定扩展需求
composer.json 里怎么声明必须启用的 PHP 扩展
很多开发者可能没注意到，Composer本身并不会主动去检查你的PHP环境里启用了哪些扩展。不过，它提供了一个非常直接的约束机制：在composer.json文件的require字段里，通过ext-xxx这样的条目来声明硬性依赖。这个声明可不是摆设，它会直接决定你的composer install或composer update命令能否顺利执行。
举个例子，如果你的项目必须用到cURL功能，那么composer.json里就必须明确写上：
{
"require": {
"ext-curl": "*"
}
}
这里的*代表“任意版本”——因为PHP扩展本身并不遵循语义化版本规则。Composer的校验逻辑很简单：它只会去检查php -m命令的输出列表里，是否存在这个扩展名。
有几点细节需要特别注意：
- 其他扩展如
ext-mbstring、ext-openssl、ext-pdo_mysql，声明方式完全一样。 - 扩展名大小写敏感：写成
ext-PDO会导致校验失败，正确的写法是ext-pdo。 - 对于Windows用户，虽然扩展文件可能带有
.dll后缀（比如php_curl.dll），但Composer只认扩展的核心名称部分，所以依然要写ext-curl。
为什么 composer install 不报错，但运行时却提示扩展缺失
这个问题堪称经典陷阱。其根源往往在于：你本地机器上，命令行（CLI）的PHP和Web服务器（比如Apache或Nginx）所用的PHP，根本不是同一个配置。结果就是，在命令行下php -m显示扩展已加载，Composer校验通过，但实际跑应用的Web环境却压根没启用这个扩展。
验证方法其实很直观：
- CLI环境：直接运行
php -m | grep curl。 - Web环境：创建一个
info.php文件，内容就是，然后在浏览器里访问它，搜索“curl”关键字。
如果两者结果不一致，那就证实了配置是分离的。Composer安装时检查的是CLI的PHP，而你的应用运行时用的是另一套。于是，即便composer install大功告成，代码里一旦执行到new CurlHandle()或者curl_init()，立刻就会抛出“Class not found”或“undefined function”这类令人头疼的错误。
如何让 Composer 在 CI/CD 中更早暴露扩展问题
持续集成（CI）环境，比如GitHub Actions，为了追求轻量和速度，默认使用的PHP镜像往往是“最小化”安装，很多常用扩展都不包含。光靠在composer.json里声明依赖是不够的，必须在CI的流程步骤中，加入显式的扩展安装命令。
以GitHub Actions为例，你需要在steps里添加类似这样的环节：
- name: Install PHP extensions
run: |
sudo apt-get update
sudo apt-get install -y php-curl php-mbstring php-xml php-zip
sudo phpenmod curl mbstring xml zip
这里有几个关键点需要把握：
- 在Debian/Ubuntu系统上，软件包名称通常是
php-xxx，而不是php7.4-xxx（除非你明确锁定了某个PHP小版本）。 - 如果你用的是Alpine Linux镜像，那包名前缀又变了，得用
apk add php7-curl这样的命令。 phpenmod是Debian系特有的工具，用于启用模块。如果在CentOS/RHEL系统上，你可能需要手动创建配置文件，例如echo "extension=curl.so" > /etc/php/8.1/cli/conf.d/20-curl.ini。- 切记不要跳过
phpenmod或手动配置ini文件这一步，否则很可能导致PHP CLI和PHP-FPM的扩展状态不同步，埋下新的隐患。
ext-xxx 写错或漏写会导致什么后果
后果很直接：当其他开发者克隆你的项目后，composer install可能会顺利执行，但项目一运行就立刻崩溃。更麻烦的是，错误堆栈通常不会直接告诉你“缺少某个扩展”，而是会报一些下游的类或函数调用失败，排查起来非常耗时。
来看几个典型的“翻车”案例：
- 漏写
ext-json：代码调用json_encode()时，会报“Call to undefined function”。很多人第一反应是PHP版本太低，完全想不到是扩展依赖没声明。 - 误写成
ext-gd2：这个扩展名根本不存在（正确的应该是ext-gd）。Composer会直接忽略这条无效的条目，既不报错也不校验，等于白写。 - 写了
ext-imagick但没装底层库：如果系统没有安装ImageMagick开发库，PHP的imagick扩展就无法编译加载。php -m里自然没有它，Composer检查会失败。但错误信息通常只是笼统地提示“The requested PHP extension ext-imagick is missing from your system”，新手可能无法立刻意识到是系统级依赖缺失。
说到底，扩展名的拼写必须和php -m输出的结果一字不差。多一个字符、少一个连字符，都会让这条声明失效。最稳妥的做法是：先在目标部署环境中执行一遍php -m，然后把准确的扩展名复制粘贴到composer.json里。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境，集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境，基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
Xcode 是苹果面向 Mac 提供的官方集成开发环境，将代码编辑、项目构建、SwiftUI 实时预览、设备模拟、自动化测试、断点调试、性能分析和应用分发整合在同一套工作流中，适合开发与维护 iPhone、iPad、Mac、Apple Wa
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
Visual Studio Code 是微软提供的免费代码编辑器，支持 macOS，并为 Intel 与 Apple 芯片 Mac 提供适配版本。软件集代码编辑、调试、Git 源代码管理、集成终端和扩展市场于一体。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
PixPix 是面向品牌、卖家和内容团队的在线 AI 图片视频创作平台，提供图视频 Agent、无限画布、图片生成、视频生成、自然语言编辑及商品套图、产品精修和带货视频等电商工具。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。
Android Studio 是 Google 面向 Android 应用开发提供的官方集成开发环境，以 IntelliJ IDEA 为基础，集成智能代码编辑、Gradle 构建、设备模拟、界面预览、调试测试及性能分析工具，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
Visual Studio Code 是微软推出的免费代码编辑器，Windows 版集成智能补全、代码导航、调试、终端和版本控制，并可通过扩展添加语言、格式化及远程开发能力。它启动较快、配置灵活，
REAPER 是 Cockos 推出的数字音频工作站，适用于录音、MIDI 编曲、音频编辑、混音、母带制作及声音设计。软件安装包小巧，支持多轨录制、灵活路由、自动化、第三方插件和脚本扩展，并提供完整功能的 60 天免费评估期。
Adobe Audition 是面向播客、影视后期、广播与音乐制作的专业音频工作站，提供波形编辑、多轨混音、频谱分析、录音、降噪修复和效果处理等功能。Windows 版通过 Adobe Creative Cloud 安装和管理，
Pro Tools 是 Avid 推出的专业数字音频工作站，提供多轨录音、音频剪辑、MIDI编曲、插件处理、自动化混音及影视声音制作能力。它适合音乐人、录音师、制作人和音频后期团队使用，并提供免费入门版、订阅方案及永久授权选择。