PHP Import Helper

VS Code extension for PHP imports and namespaces. It resolves classes from the workspace, adds and expands imports, sorts and folds use blocks, removes unused imports, generates namespaces from Composer autoload config, and reports import diagnostics.

Features

• Import one class from the cursor or diagnostic quick fix.
• Import all uniquely resolved classes in the active PHP file.
• Expand a short class name to a fully qualified class name.
• Sort imports by natural order, length, or alphabetically.
• Fold top-level import blocks, including grouped, function, and const imports.
• Remove unused class imports while preserving PHPDoc-only usages, aliases, traits, and namespace-prefix usages.
• Generate namespaces from the nearest composer.json PSR-4/PSR-0 mapping.
• Highlight unimported classes and unused imports with quick fixes.
• Cache namespace indexes on activation and update them through PHP file watchers.

Commands

Settings

{
    "phpImportHelper.index.exclude": [
        "**/.git/**",
        "**/node_modules/**",
        "**/vendor/**",
        "**/var/cache/**",
        "**/runtime/**",
        "**/storage/framework/**",
        "**/bootstrap/cache/**"
    ],
    "phpImportHelper.resolve.exclude": [
        "**/.git/**",
        "**/node_modules/**",
        "**/var/cache/**",
        "**/runtime/**",
        "**/storage/framework/**",
        "**/bootstrap/cache/**"
    ],
    "phpImportHelper.autoSort": true,
    "phpImportHelper.autoFoldUses": false,
    "phpImportHelper.sortOnSave": false,
    "phpImportHelper.sortMode": "natural",
    "phpImportHelper.leadingSeparator": true,
    "phpImportHelper.removeOnSave": false,
    "phpImportHelper.removeDuplicateImports": false,
    "phpImportHelper.autoImportOnSave": false,
    "phpImportHelper.autoAliasConflicts": false,
    "phpImportHelper.autoAliasPrefixes": ["Base", "Core"],
    "phpImportHelper.ignoreList": [],
    "phpImportHelper.highlightNotImported": true,
    "phpImportHelper.highlightNotUsed": true,
    "phpImportHelper.diagnostics.debounceMs": 300,
    "phpImportHelper.performance.trace": false
}

phpImportHelper.index.exclude controls the background index. The default excludes vendor to keep indexing fast. When a class is missing from the index, phpImportHelper.resolve.exclude controls a targeted filename search in the active workspace folder. Its default keeps vendor searchable. The persisted index is available immediately on startup when present; background reconciliation and PHP parsing run outside the extension host.

phpImportHelper.autoAliasConflicts is experimental. When enabled, Import All Classes and auto-import-on-save generate aliases for explicitly qualified classes whose short names are already occupied. Namespace segments are tried first, followed by phpImportHelper.autoAliasPrefixes and a numeric suffix.

Development

npm run lint
npm run check-types
npm run package
npm run test:unit
npm run test:integration