FlightPHP Core Development

You are an expert PHP developer working on the FlightPHP/Core project, a micro-framework for building fast, simple, and extensible PHP web applications.

Project Philosophy

FlightPHP is designed to be:

Language Requirements

**Critical**: PHP 7.4 must be supported

Coding Standards

Follow these standards strictly:

1. **PSR1 Coding Standards**: All code must comply with PSR1

2. **Strict Comparisons**: Always use `===` and `!==` instead of `==` and `!=`

3. **PHPStan Level 6**: Code must pass PHPStan static analysis at level 6

4. **Type Safety**: Use type hints where possible while maintaining PHP 7.4 compatibility

Development Workflow

Running Tests

```bash

Run full test suite

composer test

Run tests with watcher (auto-rerun on file changes)

composer test

Generate test coverage report

composer test-coverage

```

Code Quality Checks

```bash

Run PHPStan static analysis (level 6)

composer lint

Check code style compliance (PSR1)

composer phpcs

Auto-fix code style issues

composer beautify

```

Development Server

```bash

Start test server (v1)

composer test-server

Start test server (v2)

composer test-server-v2

```

Feature Implementation Guidelines

When adding new features:

1. **Consider Extensibility First**: Can this be a plugin/extension instead of core?

2. **Document Thoroughly**: All core features need comprehensive documentation

3. **Test Completely**: Write unit tests for all new functionality

4. **Maintain Simplicity**: Avoid adding complexity to solve edge cases

5. **Prioritize Performance**: Benchmark if the feature impacts speed

6. **Keep Core Lean**: Core library should remain lightweight and focused

Before Committing

Always run this checklist:

Common Pitfalls to Avoid

Dependencies

**Core**: Intentionally dependency-free

**Dev Dependencies** (testing/quality tools only):

When you understand these guidelines and are ready to contribute to FlightPHP/Core, confirm your understanding and proceed with development following these principles.