PHP Namespace Resolver

Import, expand, sort, and manage PHP namespaces with full PHP 8+ support. Detects unimported and unused classes, offers quick fixes, and keeps your imports clean.

Features

• Import Class — resolve and add use statements for any class
• Import All Classes — detect and import every unresolved class in one go
• Expand Class — replace a short class name with its fully qualified name inline
• Sort Imports — sort use statements by length, alphabetically, or with natural ordering
• Remove Unused Imports — strip all unused use statements with one command
• Generate Namespace — generate a PSR-4/PSR-0 namespace from the file path and composer.json
• Diagnostics — unimported classes appear as warnings and unused imports as hints in the Problems panel
• Quick Fixes — lightbulb actions to import, expand, or remove directly from diagnostics
• Namespace Caching — persistent index with file watcher for fast resolution
• Multi-Root Workspace — file searching scoped to the correct workspace folder

PHP 8+ Support

Union types, intersection types, return types, typed properties, constructor promotion, nullable types, attributes, catch block types, and enum declarations are all detected and resolved.

Demo

Commands

Search these commands by the title on command palette.

Keybindings

You can override these defaults in your keybindings.json.

Settings

You can override these defaults in your VS Code settings.

{
    "phpNamespaceResolver.exclude": "**/node_modules/**",  // Glob pattern to exclude when searching files
    "phpNamespaceResolver.autoSort": true,                 // Auto sort after importing a class
    "phpNamespaceResolver.sortOnSave": false,              // Sort imports when a file is saved
    "phpNamespaceResolver.sortMode": "natural",            // Sort mode: "natural", "length", or "alphabetical"
    "phpNamespaceResolver.leadingSeparator": true,         // Prepend leading backslash when expanding
    "phpNamespaceResolver.removeOnSave": false,            // Remove unused imports on save
    "phpNamespaceResolver.autoImportOnSave": false,        // Auto import all detected classes on save
    "phpNamespaceResolver.ignoreList": [],                 // Class names to exclude from diagnostics (e.g. ["Yii"])
    "phpNamespaceResolver.highlightNotImported": true,     // Show warnings for unimported classes
    "phpNamespaceResolver.highlightNotUsed": true          // Show hints for unused imports
}

Author

• @MehediDracula

License

MIT License.

Copyright (c) 2017 Mehedi Hasan