liquidrazor/class-locator

Minimal deterministic class discovery and validation library for PHP 8.3+.

Maintainers

Package info

github.com/LiquidRazor/ClassLocator

Documentation

pkg:composer/liquidrazor/class-locator

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.1.0 2026-03-27 00:05 UTC

Requires

MIT 3b801317dbdc8d8fb9701345d90908f903816766

phpcomposervalidationPSR-4class-discoveryclass-locator

This package is auto-updated.

Last update: 2026-03-27 00:09:49 UTC

README

A minimal PHP 8.3+ library for deterministic class discovery and validation.

What it does

  • Uses liquidrazor/file-locator to discover PHP files
  • Maps file paths → FQCN using PSR-4 rules
  • Validates that your codebase matches its declared structure

That’s it.

Philosophy

  • Filesystem is truth
  • Deterministic mapping over guesswork
  • Validation is explicit, not implicit
  • No magic, no hidden loading
  • Built for real-world broken projects

Dependency Model

ClassLocator is built on top of:

  • liquidrazor/file-locator

It does NOT define roots.
It consumes whatever FileLocator provides.

Namespace Resolution

ClassLocator does NOT detect namespaces for discovery.

Instead:

  1. Namespace roots are loaded from composer.json (PSR-4)
  2. File paths are mapped deterministically to expected FQCN
  3. Namespace parsing is used ONLY for validation (depending on mode)

Filesystem + Composer define expectation.
Files must comply.

Modes

ENFORCING (default)

  • Requires valid Composer PSR-4 mappings
  • Validates all files
  • Throws on critical violations
  • Fails fast on broken structure

STRICT

  • Validates all files
  • Collects violations
  • Does not throw

LENIENT

  • Best-effort discovery
  • Skips invalid entries
  • Minimal validation

Validation

Validation compares:

expected (path + composer)
vs
actual (file namespace + symbol)

Detects:

  • Namespace mismatch
  • Class/interface/trait/enum mismatch
  • Files outside PSR-4 scope
  • Duplicate FQCN
  • Missing or invalid Composer mappings

Usage

$fileLocator = new FileLocator(...);

$classLocator = new ClassLocator($fileLocator);

$result = $classLocator->locate();

Public API

ClassLocator

new ClassLocator(FileLocator $fileLocator, Mode $mode = Mode::ENFORCING)
LocateResult locate()

Mode (enum)

Mode::ENFORCING
Mode::STRICT
Mode::LENIENT

LocateResult

array getClasses()
array getViolations()
bool hasViolations()

ClassInfo

string getFqcn()
string getPath()

Violation

string getMessage()
string getPath()

What it does NOT do

  • No DI
  • No service registration
  • No autoload manipulation
  • No file execution
  • No framework coupling

Summary

Give it a FileLocator.

It gives you classes.

If your project is lying, it tells you.