Deprecate API InstrumentationInterface and ConfigurationResolver (#1896)

* Deprecate not supported `InstrumentationInterface`

See comment in `InstrumentationTrait::activate()`: "activate instrumentation with the API. not implemented yet."

* Deprecate `API` `ConfigurationResolver`

Superseded by `EnvComponentLoader` which incorporates better with file-based and code-based configuration.

Author: Nevay

src/API/Behavior/Internal/LogWriterFactory.php

@@ -18,6 +18,7 @@ class LogWriterFactory
 
     public function create(): LogWriterInterface
     {
+        /** @phan-suppress-next-line PhanDeprecatedClass */
         $dest = (new ConfigurationResolver())->getString(self::OTEL_PHP_LOG_DESTINATION);
         $logger = LoggerHolder::get();
 

src/API/Instrumentation/ConfigurationResolver.php

@@ -4,6 +4,11 @@
 
 namespace OpenTelemetry\API\Instrumentation;
 
+/**
+ * @deprecated environment variables should be accessed using {@link \OpenTelemetry\API\Configuration\ConfigEnv\EnvComponentLoader}s.
+ *
+ * @phan-suppress PhanDeprecatedInterface
+ */
 class ConfigurationResolver implements ConfigurationResolverInterface
 {
     #[\Override]

src/API/Instrumentation/ConfigurationResolverInterface.php

@@ -4,6 +4,9 @@
 
 namespace OpenTelemetry\API\Instrumentation;
 
+/**
+ * @deprecated
+ */
 interface ConfigurationResolverInterface
 {
     public function has(string $name): bool;

src/API/Instrumentation/InstrumentationInterface.php

@@ -12,6 +12,9 @@
 use OpenTelemetry\Context\Propagation\TextMapPropagatorInterface;
 use Psr\Log\LoggerInterface;
 
+/**
+ * @deprecated
+ */
 interface InstrumentationInterface
 {
     public function getName(): string;

src/API/Instrumentation/InstrumentationTrait.php

@@ -61,6 +61,8 @@ public function init(): bool
 $instrumentation->activate()
 
 to activate and use the instrumentation with the API/SDK.
+ *
+ * @deprecated
  **/
 
 trait InstrumentationTrait