Php Imports Analyzer Laravel Package

imanghafoori/php-imports-analyzer

CLI tool to scan Composer-based PHP projects for unnecessary or incorrect use/import statements. Helps clean up imports and enforce coding standards across apps and open-source packages. Install as dev dependency or globally; run check_imports from your project root.

Product Decisions This Supports

Automates detection of unused/incorrect use statements, eliminating manual code review effort and reducing technical debt
Enables CI/CD pipeline integration as a quality gate for consistent coding standards across releases
Clear "buy" decision: Building a dedicated import analyzer would require significant engineering effort for minimal ROI
Critical for open-source package maintenance where precise import hygiene directly impacts community trust and adoption

When to Consider This Package

Adopt when you need a lightweight, focused tool for import-specific validation without heavy static analysis tooling
Consider for open-source packages where precise use statement accuracy affects usability and maintainability
Look elsewhere if you already use PHPStan/Psalm (which include robust import analysis rules) or for small codebases where manual review is feasible
Avoid if your project heavily relies on dynamic class loading (e.g., class_exists($className)) without explicit configuration

How to Pitch It (Stakeholders)

This lightweight, MIT-licensed tool automates detection of unused and incorrect PHP use statements, reducing technical debt and maintenance costs. Executives gain measurable quality improvements with minimal investment—no runtime impact on production code and seamless CI/CD integration to enforce standards. Engineering teams benefit from zero-configuration setup, pre-commit hook support, and immediate feedback on import hygiene, freeing up review capacity for higher-value work.