AgentSkillsCN

PHP Best Practices

在 PHP 中践行最佳实践，遵循 PSR 标准并落实代码质量准则。

SKILL.md
--- frontmatter
name: PHP Best Practices
description: PHP best practices, PSR standards, and code quality guidelines.
metadata:
  labels: [php, psr, best-practices]
  triggers:
    files: ['**/*.php']
    keywords: [psr-12, camelCase, PascalCase, dry, solid]

PHP Best Practices

Priority: P1 (HIGH)

Structure

text
src/
├── {Domain}/             # e.g., Services, Repositories
└── Helpers/              # Pure functions/Traits

Implementation Guidelines

  • •PSR-12: Follow PSR-12 for coding style (indent, braces, space).
  • •Autoloading: Use PSR-4 via Composer.
  • •Namespacing: Map namespaces to directory structure.
  • •PascalCase: Use for all class names.
  • •camelCase: Use for methods and variables.
  • •SNAKE_CASE: Use for class constants.
  • •DRY Logic: Extract repetitive logic into traits/methods.
  • •SOLID: Use interfaces for decoupling and SRP adherence.

Anti-Patterns

  • •God Classes: No Monoliths: Avoid classes with multiple responsibilities.
  • •Magic Numbers: No Hardcoding: Use class constants for config values.
  • •Deep Nesting: No Nesting: Guard clauses over nested if/else.
  • •Direct Output: No Echo: Return data; let controller handle response.

References