PHP Coding Standards Fixer Action
A GitHub Action that runs PHP-CS-Fixer to automatically fix PHP code style issues in your CI/CD pipeline.
What is PHP Coding Standards Fixer Action?
php-cs-fixer-ga is a GitHub Action that runs PHP-CS-Fixer to automatically fix PHP code style issues in CI/CD pipelines. It integrates PHP-CS-Fixer into GitHub workflows, allowing developers to enforce consistent coding standards automatically on every push or pull request. The action simplifies setup with Docker-based execution and supports custom configurations.
PHP developers and teams using GitHub for version control who want to automate code style enforcement in their CI/CD pipelines.
It provides a zero-configuration way to run PHP-CS-Fixer in GitHub Actions, with built-in support for caching, changed-file optimization, and custom arguments. Developers choose it for its simplicity and seamless integration with existing GitHub workflows.
Overview
GithubAction for PHP-CS-Fixer
Use Cases
Best For
- Automatically fixing PHP code style violations in CI/CD pipelines
- Enforcing consistent coding standards across PHP projects
- Integrating PHP-CS-Fixer with GitHub Actions workflows
- Running code style checks only on changed files to save time
- Setting up automated linting for PHP repositories on GitHub
- Using Docker-based PHP-CS-Fixer execution in CI environments
Not Ideal For
- Projects using CI/CD platforms other than GitHub Actions, such as GitLab CI or Jenkins
- Teams that prefer running PHP-CS-Fixer locally via Composer scripts without Docker overhead
- Environments with security policies restricting Docker container execution
- Small or solo projects where manual code style checks suffice and CI setup is unnecessary
Pros & Cons
Pros
Runs as a Docker container, ensuring identical PHP-CS-Fixer execution across all GitHub Actions workflows, eliminating environment discrepancies.
Provides copy/paste YAML examples for common use cases, allowing quick setup with minimal configuration overhead.
Integrates with GitHub Actions cache to store .php-cs-fixer.cache, speeding up subsequent runs as demonstrated in the README.
Configurable to run only on changed files using --path-mode=intersection, saving CI time for large codebases.
Cons
Requires an existing .php-cs-fixer.dist.php file, adding initial setup steps before the action can be used effectively.
Running as a Docker container introduces additional resource usage and slower startup compared to native PHP execution.
Implementing changed files optimization requires integrating with third-party actions and custom shell scripts, increasing configuration complexity.
Frequently Asked Questions
Related Projects
wemake-python-styleguideThe strictest and most opinionated python linter ever!
Show and auto-fix linting errors for many programming languages✨ GitHub Action for detecting and auto-fixing lint errors
Lint Pull Request commits with commitlintLints Pull Request commits with commitlint
Run dotenv-linter - Lints your .env files like a charm, with optional reviewdog output on the PR:relaxed: Linting dotenv files like a charm!
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.