Add PHP language support

[j178]

Closes #1724

[codecov]

Codecov Report

❌ Patch coverage is 94.85981% with 11 lines in your changes missing coverage. Please review.
✅ Project coverage is 93.31%. Comparing base (6a61867) to head (d891d68).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
crates/prek/src/languages/php.rs	94.81%	11 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2314      +/-   ##
==========================================
+ Coverage   93.30%   93.31%   +0.01%     
==========================================
  Files         127      128       +1     
  Lines       28132    28346     +214     
==========================================
+ Hits        26249    26452     +203     
- Misses       1883     1894      +11     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[prek-ci-bot]

📦 Cargo Bloat Comparison

Binary size change: +0.36% (27.7 MiB → 27.8 MiB)

Expand for cargo-bloat output

Head Branch Results

 File  .text     Size             Crate Name
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_encrypt_avx512
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_decrypt_avx512
 0.3%   0.7%  98.8KiB              prek <prek::config::Language>::run::{closure#0}::{closure#0}
 0.3%   0.7%  98.8KiB              prek <prek::config::Language>::run::{closure#0}::{closure#0}
 0.3%   0.7%  94.7KiB              prek <prek::config::Language>::install::{closure#0}
 0.2%   0.5%  65.2KiB              prek <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.4%  48.5KiB              prek <<prek::config::Config as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.2%   0.4%  48.0KiB              prek prek::run::{closure#0}
 0.2%   0.3%  42.7KiB              prek prek::cli::run::run::run::{closure#0}
 0.1%   0.3%  35.3KiB               std core::ptr::drop_glue::<<prek::config::Language>::install::{closure#0}>
 0.1%   0.2%  32.7KiB              prek prek::archive::unpack::<fs_err::tokio::file::File, &std::path::PathBuf>::{closure#0}
 0.1%   0.2%  31.3KiB              prek <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  29.3KiB     granit_parser <granit_parser::scanner::Scanner<granit_parser::input::str::StrInput>>::fetch_more_tokens
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.8KiB              prek <<prek::config::RemoteHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble
 0.1%   0.2%  25.3KiB              prek prek::cli::try_repo::try_repo::{closure#0}
 0.1%   0.2%  24.9KiB               xml <xml::reader::parser::PullParser>::dispatch_token
 0.1%   0.2%  24.6KiB              prek <<prek::config::LocalHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
40.4%  86.0%  11.2MiB                   And 24557 smaller methods. Use -n N to show more.
47.0% 100.0%  13.0MiB                   .text section size, the file size is 27.8MiB

Base Branch Results

 File  .text     Size             Crate Name
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_encrypt_avx512
 1.2%   2.5% 332.0KiB        aws_lc_sys aws_lc_0_41_0_aes_gcm_decrypt_avx512
 0.3%   0.7%  95.6KiB              prek <prek::config::Language>::run::{closure#0}::{closure#0}
 0.3%   0.7%  95.2KiB              prek <prek::config::Language>::run::{closure#0}::{closure#0}
 0.3%   0.6%  86.0KiB              prek <prek::config::Language>::install::{closure#0}
 0.2%   0.5%  66.9KiB              prek <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.2%   0.4%  48.5KiB              prek <<prek::config::Config as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.2%   0.4%  48.0KiB              prek prek::run::{closure#0}
 0.1%   0.3%  42.2KiB              prek prek::cli::run::run::run::{closure#0}
 0.1%   0.3%  34.3KiB               std core::ptr::drop_glue::<<prek::config::Language>::install::{closure#0}>
 0.1%   0.2%  32.4KiB              prek prek::archive::unpack::<fs_err::tokio::file::File, &std::path::PathBuf>::{closure#0}
 0.1%   0.2%  32.3KiB              prek <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  29.3KiB     granit_parser <granit_parser::scanner::Scanner<granit_parser::input::str::StrInput>>::fetch_more_tokens
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.8KiB              prek <<prek::config::RemoteHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_41_0_edwards25519_scalarmuldouble
 0.1%   0.2%  25.3KiB              prek prek::cli::try_repo::try_repo::{closure#0}
 0.1%   0.2%  24.9KiB               xml <xml::reader::parser::PullParser>::dispatch_token
 0.1%   0.2%  24.6KiB              prek <<prek::config::LocalHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
40.4%  86.1%  11.2MiB                   And 24480 smaller methods. Use -n N to show more.
46.9% 100.0%  13.0MiB                   .text section size, the file size is 27.7MiB

[prek-ci-bot]

⚡️ Hyperfine Benchmarks

Summary: 1 regressions, 1 improvements above the 10% threshold.

Environment

• OS: Linux 6.17.0-1018-azure
• CPU: 4 cores
• prek version: prek 0.4.9+6 (e7f44be 2026-07-12)
• Rust version: rustc 1.97.0 (2d8144b78 2026-07-07)
• Hyperfine version: hyperfine 1.20.0

CLI Commands

Benchmarking basic commands in the main repo:

prek --version

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base --version	2.6 ± 0.1	2.4	2.8	1.06 ± 0.11
prek-head --version	2.4 ± 0.2	2.3	4.1	1.00

prek list

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base list	10.8 ± 0.6	10.3	15.4	1.06 ± 0.06
prek-head list	10.2 ± 0.2	9.9	11.2	1.00

prek validate-config .pre-commit-config.yaml

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base validate-config .pre-commit-config.yaml	3.9 ± 0.2	3.6	4.7	1.11 ± 0.05
prek-head validate-config .pre-commit-config.yaml	3.5 ± 0.1	3.3	3.7	1.00

prek sample-config

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base sample-config	2.9 ± 0.0	2.8	3.0	1.05 ± 0.05
prek-head sample-config	2.7 ± 0.1	2.6	3.5	1.00

Cold vs Warm Runs

Comparing first run (cold) vs subsequent runs (warm cache):

prek run --all-files (cold - no cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	77.6 ± 1.5	75.8	79.7	1.00
prek-head run --all-files	79.7 ± 2.8	76.3	84.7	1.03 ± 0.04

prek run --all-files (warm - with cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	79.9 ± 3.3	75.6	87.4	1.00
prek-head run --all-files	80.0 ± 3.1	76.1	88.7	1.00 ± 0.06

Full Hook Suite

Running the builtin hook suite on the benchmark workspace:

prek run --all-files (full builtin hook suite)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	79.5 ± 2.3	74.8	84.9	1.00
prek-head run --all-files	80.2 ± 2.8	74.9	86.4	1.01 ± 0.05

Individual Hook Performance

Benchmarking each hook individually on the test repo:

prek run trailing-whitespace --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run trailing-whitespace --all-files	23.6 ± 4.1	21.3	43.2	1.08 ± 0.19
prek-head run trailing-whitespace --all-files	21.8 ± 0.5	21.1	23.0	1.00

prek run end-of-file-fixer --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run end-of-file-fixer --all-files	29.7 ± 2.9	25.3	35.3	1.03 ± 0.13
prek-head run end-of-file-fixer --all-files	28.8 ± 2.5	25.2	33.9	1.00

prek run check-json --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-json --all-files	9.5 ± 0.3	9.0	10.2	1.05 ± 0.05
prek-head run check-json --all-files	9.1 ± 0.3	8.6	9.7	1.00

prek run check-yaml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-yaml --all-files	9.0 ± 0.2	8.5	9.4	1.01 ± 0.04
prek-head run check-yaml --all-files	8.9 ± 0.3	8.4	9.8	1.00

prek run check-toml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-toml --all-files	9.1 ± 0.3	8.7	9.7	1.02 ± 0.05
prek-head run check-toml --all-files	9.0 ± 0.4	8.5	10.2	1.00

prek run check-xml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-xml --all-files	9.0 ± 0.3	8.6	9.9	1.03 ± 0.05
prek-head run check-xml --all-files	8.7 ± 0.3	8.1	9.4	1.00

prek run detect-private-key --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run detect-private-key --all-files	15.1 ± 1.1	13.5	17.5	1.04 ± 0.11
prek-head run detect-private-key --all-files	14.6 ± 1.1	12.7	17.1	1.00

prek run fix-byte-order-marker --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run fix-byte-order-marker --all-files	20.0 ± 1.0	18.5	22.3	1.02 ± 0.06
prek-head run fix-byte-order-marker --all-files	19.6 ± 0.8	18.5	21.9	1.00

Installation Performance

Benchmarking hook installation (fast path hooks skip Python setup):

prek install-hooks (cold - no cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base install-hooks	5.8 ± 0.1	5.6	5.9	1.02 ± 0.03
prek-head install-hooks	5.6 ± 0.0	5.6	5.7	1.00

prek install-hooks (warm - with cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base install-hooks	5.8 ± 0.1	5.7	6.0	1.05 ± 0.04
prek-head install-hooks	5.5 ± 0.2	5.3	5.7	1.00

File Filtering/Scoping Performance

Testing different file selection modes:

prek run (staged files only)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run	44.0 ± 1.6	41.5	47.9	1.05 ± 0.05
prek-head run	42.1 ± 1.1	40.6	44.2	1.00

prek run --files '*.json' (specific file type)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --files '*.json'	11.4 ± 5.8	9.2	35.4	1.00
prek-head run --files '*.json'	20.0 ± 23.6	8.9	94.1	1.75 ± 2.25

⚠️ Warning: Performance regression for prek run --files '*.json' (specific file type): 75.2300% slower

Workspace Discovery & Initialization

Benchmarking hook discovery and initialization overhead:

prek run --dry-run --all-files (measures init overhead)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --dry-run --all-files	8.6 ± 0.2	8.3	8.9	1.04 ± 0.03
prek-head run --dry-run --all-files	8.3 ± 0.2	8.0	8.6	1.00

Meta Hooks Performance

Benchmarking meta hooks separately:

prek run check-hooks-apply --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-hooks-apply --all-files	13.7 ± 0.8	12.2	14.4	1.12 ± 0.07
prek-head run check-hooks-apply --all-files	12.3 ± 0.2	11.9	12.7	1.00

✅ Performance improvement for prek run check-hooks-apply --all-files: 10.5200% faster

prek run check-useless-excludes --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-useless-excludes --all-files	12.5 ± 0.3	12.2	13.0	1.00
prek-head run check-useless-excludes --all-files	12.7 ± 0.3	12.2	13.1	1.02 ± 0.03

prek run identity --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run identity --all-files	12.1 ± 0.1	11.8	12.3	1.02 ± 0.03
prek-head run identity --all-files	11.8 ± 0.3	11.4	12.1	1.00

[Copilot]

Pull request overview

This PR adds first-class PHP language support to prek, enabling PHP hooks to run with a system-installed php and optionally install remote hook repos / additional dependencies via Composer. It also updates CI, schema, and documentation to recognize and validate the new php language backend.

Changes:

• Add a new php language backend that runs hooks with system php and installs dependencies (including remote hook repos) using Composer in an isolated env.
• Extend configuration/schema/docs/CLI language lists to include php.
• Add PHP-focused integration tests and update CI to install PHP+Composer when PHP tests are selected.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
scripts/generate-ci-matrix.py	Adds php to the CI language test selection matrix.
prek.schema.json	Extends schema to support php in relevant config sections.
docs/reference/configuration.md	Documents php as a common language value.
docs/reference/cli.md	Lists php among supported languages in CLI docs.
docs/languages.md	Adds detailed PHP backend behavior documentation.
crates/prek/tests/languages/php.rs	Adds integration tests for local hooks, remote installs, additional deps, and language_version rejection.
crates/prek/tests/languages/main.rs	Wires the new PHP test module into the languages test suite.
crates/prek/src/languages/version.rs	Ensures PHP participates in language version request parsing behavior.
crates/prek/src/languages/php.rs	Implements the PHP backend (system php + Composer-based dependency handling).
crates/prek/src/languages/mod.rs	Registers the PHP backend and includes it in capability/match logic.
crates/prek/src/config.rs	Adds Php to the Language enum (serde/clap/strum).
.github/workflows/ci.yml	Installs PHP and Composer conditionally for PHP test runs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated no new comments.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d891d68075

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".