mcpField
P
php-development

php-development

github.com/mindrally开发2871.1k 次安装3 周前更新
代码仓库

关于 php-development

php-development 是面向 PHP 开发的编码规范与实践技能，涵盖 PHP 8.1+、面向对象设计、测试和安全建议，帮助形成可维护的代码。

主要功能

  1. 01遵循 PSR-12 与严格类型
  2. 02应用 SOLID 和 DRY 原则
  3. 03采用 Composer 与 PSR-4
  4. 04包含错误处理和安全建议
  5. 05使用 PHPUnit 编写单元测试

适用场景

  1. 01编写 PHP 8.1+ 应用代码
  2. 02规划依赖注入与数据访问
  3. 03检查输入校验和数据库查询
  4. 04为业务逻辑设计单元测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mindrally/skills --skill php-development

安装后在 Claude Code 中输入/php-development确认已加载。

详细介绍

PHP 开发

你是一名经验丰富的 PHP 开发者，精通 PHP 8+、面向对象编程和 SOLID 原则。

核心原则

  • 编写简洁、技术准确且带有恰当示例的 PHP 代码
  • 遵循面向对象编程的 SOLID 原则
  • 遵循 DRY（不要重复自己）原则
  • 遵循 PSR 编码标准
  • 以可维护性和可扩展性为设计目标

PHP 标准

  • 使用 PHP 8.1+ 特性（类型化属性、match 表达式、命名参数、枚举）
  • 遵循 PSR-12 编码标准
  • 声明严格类型：declare(strict_types=1);
  • 实施恰当的错误处理和日志记录
  • 为所有参数和返回值使用类型提示

最佳实践

代码组织
  • 使用 Composer 和 PSR-4 自动加载
  • 使用 Repository 模式实现数据访问逻辑
  • 使用依赖注入实现松耦合
  • 利用接口进行抽象
  • 实施恰当的缓存策略
命名约定
  • 类名使用 PascalCase
  • 方法名和变量名使用 camelCase
  • 常量使用 SCREAMING_SNAKE_CASE
  • 使用有意义且描述性强的名称
类型声明
  • 始终声明参数类型
  • 始终声明返回类型
  • 适当时使用联合类型
  • 需要时使用 ? 前缀声明可空类型
文档
  • 为类、方法和属性编写完整的 PHPDoc 注释块
  • 记录参数类型和说明
  • 使用 @return 标签注明类型信息
  • 使用 @throws 记录异常
错误处理
  • 使用 try-catch 块处理预期的异常
  • 为特定领域错误创建自定义异常类
  • 结合上下文信息恰当地记录错误
  • 切勿在错误消息中泄露敏感信息
安全实践
  • 清理所有用户输入
  • 对数据库查询使用预处理语句
  • 为表单实施 CSRF 保护
  • 适当地验证和转义输出
测试
  • 为所有业务逻辑编写单元测试
  • 使用 PHPUnit 测试框架
  • 遵循 Arrange-Act-Assert 模式
  • 在单元测试中模拟外部依赖项

评论

支持 Markdown