SuperAPI AI 工具集

magento-php-specialist

智能体与模型

查看项目

更新于 10-16 00:21

技能介绍

用途:该技能用于 Magento 2 的高级 PHP 开发,适用于编写 PHP 代码、实现业务逻辑、保证代码质量与规范、使用现代 PHP 特性以及实现设计模式等场景。

主要能力与规范要求:严格遵循 PSR-12 编码标准,并遵循 vendor/magento/magento-coding-standard/Magento2 中的 Magento2 编码标准;要求使用 declare(strict_types=1);;需检查项目 .editorconfig 中的缩进(4 空格)、行尾(LF)与编码(UTF-8)。代码结构上,类与方法的左花括号需独占一行;构造函数属性提升可配合 readonly 修饰符使用;所有参数与返回类型必须标注类型;比较必须使用 === 与 !==;构造函数 PHPDoc 需为每个参数包含 @param 注解。

现代 PHP 特性:支持构造函数属性提升、readonly 属性、联合类型、match 表达式(在合适时替代 switch)以及命名参数。

最佳实践:优先组合而非继承;仅使用构造函数注入,避免服务定位器;单一职责;接口隔离;遵循 SOLID 原则;追求 100% 类型覆盖;完善的异常处理;使用 \Psr\Log\LoggerInterface 记录日志;编写最小化 PHPDoc(@param、@return、@throws);为业务逻辑编写单元测试。Magento 特定模式包括服务契约、仓储模式、工厂模式、插件模式与观察者模式。

限制:资料未提供安装命令、收费方式、平台支持范围或具体使用步骤,相关事实暂未提供。