Download the PHP package pekral/php-skeleton without Composer

PHP Skeleton

Modern PHP package skeleton with strict quality rules and best practices baked in. Supports PHP 8.4 and 8.5.

Start your next PHP package with confidence. This skeleton comes pre-configured with industry-standard tools for static analysis, testing, and code quality — and includes an interactive installer that configures everything for you.

Features

Installation

The interactive installer will guide you through the configuration process.

Interactive Installer

When you run composer create-project, an interactive installer automatically starts and helps you configure your new package.

What the Installer Does

1. Collects Project Information

   • Package name (vendor/package format)
   • Root PSR-4 namespace (auto-suggested from package name)
   • Test namespace (auto-suggested as {Namespace}Test)
   • Display name (auto-suggested from package name)
   • GitHub repository URL (auto-suggested from package name)

2. Optional: Project Specification

   • Paste multi-line project specification text
   • Creates SPEC.md file (automatically added to .gitignore)
   • End input with two empty lines or skip with Enter

3. Performs Automatic Configuration

   • Updates composer.json with your package details
   • Replaces namespaces across all PHP files
   • Clears README.md and CHANGELOG.md for your content
   • Updates LICENSE with your information
   • Cleans up phpstan.neon (removes build-package path)
   • Cleans up rector.php (removes build-package path)
   • Moves all dependencies to require-dev (except PHP)
   • Removes skeleton-specific scripts and autoload entries

4. Creates Example Files

   • src/{ClassName}.php — Example class with greet() method
   • tests/Unit/{ClassName}Test.php — Pest test for the example class

5. Runs Quality Pipeline

   • Installs dependencies with composer update
   • Runs composer fix to apply code style fixes
   • Runs composer check to verify all quality checks pass
6. Optional Features
   • GitHub Actions — Keep or remove CI/CD workflows
   • Cursor Rules — Install AI coding assistant rules via pekral/cursor-rules
   • Git Repository — Initialize with custom branch name
   • Push to Remote — Force push initial commit to GitHub (converts HTTPS to SSH URL)

Installer Flow Example

Cancellation & Cleanup

If you press Ctrl+C during installation, the installer will:

• Display a cancellation message
• Automatically delete the partially created project directory
• Exit cleanly

Available Commands

Run All Quality Checks

This runs the complete quality pipeline:

• Composer normalize
• PHP CodeSniffer
• Laravel Pint
• Rector
• PHPStan
• Security audit
• Tests with 100% coverage

Apply All Fixes

Automatically fixes code style and applies refactoring:

• Composer normalize
• Rector refactoring
• Laravel Pint formatting
• PHP CodeSniffer fixes

Individual Commands

Project Structure

After installation, your project will have:

Configuration

PHPStan

Static analysis runs at maximum level with additional rules:

• Deprecation rules
• Mockery extension

Testing

Tests use Pest v4 with strict coverage requirements:

Code Style

Laravel Pint enforces PSR-12 with additional rules for clean, consistent code.

Rector

Automated refactoring uses rules from pekral/rector-rules package.

GitHub Actions

The skeleton includes comprehensive CI/CD workflows:

All workflows run on PHP 8.4 and 8.5 (matrix).

Requirements

• PHP 8.4 or 8.5 (both versions are supported and tested in CI)
• Composer 2.x

Contributing

Contributions are welcome! Please read our Contributing Guide before submitting a Pull Request.

License

This package is open-sourced software licensed under the MIT license.

Author

Petr Král

• GitHub: @pekral
• Email: [email protected]
• X (Twitter): https://x.com/kral_petr_88

_{Built with care for the PHP community}