CONTRIBUTING.md

Contributing to PHP Forge

Thank you for your interest in contributing. Please read this guide before submitting issues or pull requests.

By participating in this project, you agree to abide by the Code of Conduct.

Development Environment

Requirements:

• PHP 8.1 or higher.
• Composer 2.x.

Setup:

git clone https://github.com/php-forge/<package>.git
cd <package>
composer install
composer test

Coding Standards

All PHP code must follow these standards:

• PER 3.0 + PSR-12 coding style.
• declare(strict_types=1) in every PHP file.
• Strong typing: use type declarations for parameters, return types, and properties.
• Use php-forge/coding-standard for automated style checks.

Testing

• All tests use PHPUnit 10+.
• Target 100% code coverage for new code.
• Run the test suite before submitting a pull request:

composer test

Pull Request Process

1. Fork the repository and create a feature branch from main.
2. Make your changes in small, focused commits.
3. Use Conventional Commits for commit messages.
4. One logical change per pull request.
5. Ensure all tests pass and coding standards are met.
6. Open a pull request against main with a clear description of the change.

Bug Reports and Feature Requests

• Bug reports: Use the Bug Report template.
• Feature requests: Use the Feature Request template.

Security Vulnerabilities

Do not open public issues for security vulnerabilities. See SECURITY.md for reporting instructions.