Download the PHP package baraja-core/path-resolvers without Composer

🗂️ Path Resolvers

A group of intelligent DI services that provide disk paths to important locations such as tempDir, wwwDir, vendorDir, logDir and other system constants for your applications. Dependency management can be easily solved from one place.

🎯 Key Features

• Automatic path detection - Uses Composer's ClassLoader reflection to automatically detect the vendor directory
• Zero configuration - Works out of the box with Nette Framework via DIC extension
• CLI and Web support - Properly detects paths in both CLI and web server environments
• PHAR archive support - Special handling for applications bundled in PHAR archives
• Cross-platform compatibility - Normalizes directory separators for Windows and Unix systems
• Performance optimized - Static caching prevents redundant path resolution
• Customizable - Override any path via constructor injection or DI configuration
• Type-safe - Fully typed with PHP 8.0+ support and PHPStan level 8 compatibility

🏗️ Architecture

The package follows a hierarchical resolver pattern where each resolver can depend on others:

🧩 Components

VendorResolver

The core resolver that detects the Composer vendor directory. It uses multiple detection strategies:

1. Primary method: Reflects on Composer\Autoload\ClassLoader to find its file location
2. CLI fallback: For PHAR or system-installed PHP, uses debug backtrace to locate vendor
3. Error handling: Throws RuntimeException if vendor cannot be detected

RootDirResolver

Resolves the project root directory by getting the parent directory of vendor. Supports custom path appending.

WwwDirResolver

Resolves the public web directory. Uses intelligent detection:

1. If custom wwwDir is provided via constructor, uses that
2. If called from index.php, returns its directory
3. Falls back to {root}/www

TempDirResolver

Resolves the temporary directory. Supports custom paths and directory names.

LogDirResolver

Resolves the log directory. Supports custom paths and directory names.

📦 Installation

It's best to use Composer for installation, and you can also find the package on Packagist and GitHub.

To install, simply use the command:

You can use the package manually by creating an instance of the internal classes, or register a DIC extension to link the services directly to the Nette Framework.

Requirements

• PHP 8.0 or higher
• Nette DI 3.0+ (for DIC integration)
• Composer autoloader

🚀 Basic Usage

With Nette Framework (Recommended)

Register the extension in your config.neon:

All resolvers are automatically registered as services and can be injected:

Standalone Usage (Without Nette)

You can use the resolvers without the DI extension:

⚙️ Configuration

Custom Paths via DI

Override default paths in your Nette configuration:

Constructor Parameters

💡 Use Cases

Storing Cache Files

Writing Log Files

Serving Static Files

Project Configuration

🔧 Technical Details

Path Normalization

All resolvers normalize directory separators using DIRECTORY_SEPARATOR for cross-platform compatibility:

• Windows: C:\project\temp\cache
• Unix/Linux: /var/www/project/temp/cache

Caching

The VendorResolver uses static caching to prevent redundant filesystem operations:

CLI Detection

For CLI environments running from PHAR archives or system-installed PHP, the vendor resolver uses debug backtrace as a fallback detection method.

👤 Author

Jan Barášek https://baraja.cz

📄 License

baraja-core/path-resolvers is licensed under the MIT license. See the LICENSE file for more details.