HoangNguyen0403 / php-best-practices

PHP best practices, PSR standards, and code quality guidelines.

0 views
0 installs

Skill Content

---
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

- [Clean Code Patterns](references/implementation.md)