Unknown configuration keys

[loranger]

For some reasons, phpactor 2025.12.21 (installed by zed editor) stopped working with my yml config file.

I now have an error on launch:

Phpactor configuration error: Unknown configuration keys: "indexer", "worse_reflection", "autoload", did you mean any of: "command", "$schema", "core.trust", "worse_reflection.stub_dir", "logging.level", "php.version"

~/Library/Application Support/Zed/extensions/work/php
❯ ./phpactor-2025.12.21.0/phpactor.phar status
Phpactor\MapResolver\UnknownKeys: Key(s) "indexer", "worse_reflection", "autoload" are not known, kn...
Version: 2025.12.21.0
Filesystems: simple
Working directory: /Users/loranger/Library/Application Support/Zed/extensions/work/php

Config files (missing is not bad):

  ✘ /Users/loranger/.config/phpactor/phpactor.json
  ✔ /Users/loranger/.config/phpactor/phpactor.yml

Diagnostics:

  ✔ XDebug is disabled. XDebug has a negative effect on performance.
  ✘ Composer not found - some functionality will not be available (e.g. class creation) and class location will fallback to scanning the filesystem if index not enabled - this can be slow. Make sure you've run `composer install` in your project!
  ✘ Git not detected. Some operations which would have been better scoped to your project repository will now include vendor paths.
  ✘ Path "/Users/loranger/Library/Application Support/Zed/extensions/work/php" is not trusted and configuration will not be loaded from it.

This config file has not change since july.

phpactor.yml

indexer:
  stub_paths:
    - "%application_root%/_ide_helper.php"
    - "%application_root%/_ide_helper_models.php"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Support/Facades"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Database/Eloquent"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Http"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Routing"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Foundation"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Contracts"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Config"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Cache"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Auth"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Events"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Bus"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Queue"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Filesystem"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Translation"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Validation"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Compilers"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Factory"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewServiceProvider"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewFinderInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewName"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewEnvironment"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineResolver"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/PhpEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/BladeEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineResolver"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/PhpEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/BladeEngine"
worse_reflection:
  stub_dir: "%application_root%/_ide_helper.php"
autoload:
  directories:
    - app
    - vendor

Can you help, please?

[mamazu]

Can you try this configuration? Where the paths are joined? It might have something to do with a change in parsing. Something like

autoload:
    directories: []

should be:

autoload.directories: []

So your updated config should probably look like this:

indexer.stub_paths:
    - "%application_root%/_ide_helper.php"
    - "%application_root%/_ide_helper_models.php"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Support/Facades"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Database/Eloquent"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Http"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Routing"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Foundation"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Contracts"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Config"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Cache"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Auth"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Events"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Bus"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Queue"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Filesystem"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Translation"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/Validation"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Compilers"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Factory"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewServiceProvider"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewFinderInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewName"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/ViewEnvironment"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineResolver"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/PhpEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/BladeEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineResolver"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/PhpEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerEngine"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerInterface"
    - "%application_root%/vendor/laravel/framework/src/Illuminate/View/Engines/BladeEngine"
worse_reflection.stub_dir: "%application_root%/_ide_helper.php"
autoload.directories:
    - app
    - vendor

[mamazu]

And it looks like the autoload.directories doesn't exist anymore.

[dantleech]

I'm surprised (or maybe forgetful) as I'm not aware that the format you have there could work as the keys should be as in:

https://phpactor.readthedocs.io/en/master/reference/configuration.html

I'd als suggest you use the JSON format which can be created via. phpactor config:init

[mamazu]

Yes let's deprecate the yaml format. :D

[loranger]

Thanks for the reformatting suggestion.
It works better using json and updated directive.

phpactor.json

{
"$schema": "/phpactor.schema.json",
"indexer.stub_paths": [
  "%project_root%/_ide_helper.php",
  "%project_root%/_ide_helper_models.php",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Support/Facades",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Database/Eloquent",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Http",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Routing",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Foundation",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Contracts",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Config",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Cache",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Auth",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Events",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Bus",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Queue",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Filesystem",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Translation",
  "%project_root%/vendor/laravel/framework/src/Illuminate/Validation",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Compilers",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Factory",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/ViewServiceProvider",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/ViewFinderInterface",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/ViewName",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/ViewInterface",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/ViewEnvironment",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineResolver",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineInterface",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/PhpEngine",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerEngine",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerInterface",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/BladeEngine",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineResolver",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/EngineInterface",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/PhpEngine",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerEngine",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/CompilerInterface",
  "%project_root%/vendor/laravel/framework/src/Illuminate/View/Engines/BladeEngine"
]
}