How did I solve «Undefined array key 2 in vendor/magento/framework/Reflection/TypeProcessor.php on line 947» on `/soap/default?services=storeStoreRepositoryV1`?

dmitrii_fediuk · February 2, 2026, 1:34pm

«Undefined array key 2 in vendor/magento/framework/Reflection/TypeProcessor.php on line 947» on `/soap/default?services=storeStoreRepositoryV1` in Magento 2.4.8-p3

opened 01:20PM - 02 Feb 26 UTC

``` { "mage2pro/core": "11.5.2", "Magento": "2.4.8-p3", "PHP": "8.2.…20", "URL": "https://www.keyclampstore.com/soap/default?services=storeStoreRepositoryV1", "Time": "2026-02-02 12:31:27", "Referer": "", "IP Address": "185.219.93.210", "Request Method": "POST", "User-Agent": false, "php://input": "<s:Envelope xmlns:s=\"http://www.w3.org/2003/05/soap-envelope\"><s:Body xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\"><storeStoreRepositoryV1GetListRequest xmlns=\"https://www.keyclampstore.com/soap/default?services=storeStoreRepositoryV1\"/>\n </s:Body></s:Envelope>" } EXCEPTION Warning: Undefined array key 2 in vendor/magento/framework/Reflection/TypeProcessor.php on line 947 ************************************ [] ************************************ 1 Magento\Framework\App\ErrorHandler::handler https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/App/ErrorHandler.php#L61 vendor/magento/framework/App/ErrorHandler.php:61 2 Magento\Framework\Reflection\TypeProcessor::getParamDocBlockTag https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Reflection/TypeProcessor.php#L947 vendor/magento/framework/Reflection/TypeProcessor.php:947 3 Magento\Framework\Reflection\TypeProcessor::getParamDescription https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Reflection/TypeProcessor.php#L705 vendor/magento/framework/Reflection/TypeProcessor.php:705 4 Magento\Webapi\Model\Config\ClassReflector::extractMethodData https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/Config/ClassReflector.php#L95 vendor/magento/module-webapi/Model/Config/ClassReflector.php:95 5 Magento\Webapi\Model\Config\ClassReflector::reflectClassMethods https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/Config/ClassReflector.php#L73 vendor/magento/module-webapi/Model/Config/ClassReflector.php:73 6 Magento\Webapi\Model\ServiceMetadata::initServicesMetadata https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/ServiceMetadata.php#L144 vendor/magento/module-webapi/Model/ServiceMetadata.php:144 7 Magento\Webapi\Model\ServiceMetadata::getServicesConfig https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/ServiceMetadata.php#L179 vendor/magento/module-webapi/Model/ServiceMetadata.php:179 8 Magento\Webapi\Model\ServiceMetadata::___callParent https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L58 vendor/magento/framework/Interception/Interceptor.php:58 9 Magento\Webapi\Model\ServiceMetadata::Magento\Framework\Interception\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L138 vendor/magento/framework/Interception/Interceptor.php:138 10 Magento\Webapi\Model\ServiceMetadata::___callPlugins https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L153 vendor/magento/framework/Interception/Interceptor.php:153 11 Magento\Webapi\Model\ServiceMetadata::getServicesConfig generated/code/Magento/Webapi/Model/ServiceMetadata/Interceptor.php:23 12 Magento\Webapi\Model\ServiceMetadata::getServiceMetadata https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/ServiceMetadata.php#L202 vendor/magento/module-webapi/Model/ServiceMetadata.php:202 13 Magento\Webapi\Model\Soap\Wsdl\Generator::getServiceMetadata https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/Soap/Wsdl/Generator.php#L367 vendor/magento/module-webapi/Model/Soap/Wsdl/Generator.php:367 14 Magento\Webapi\Model\AbstractSchemaGenerator::getAllowedServicesMetadata https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/AbstractSchemaGenerator.php#L172 vendor/magento/module-webapi/Model/AbstractSchemaGenerator.php:172 15 Magento\Webapi\Model\Soap\Wsdl\Generator::getAllowedServicesMetadata https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/Soap/Wsdl/Generator.php#L375 vendor/magento/module-webapi/Model/Soap/Wsdl/Generator.php:375 16 Magento\Webapi\Model\AbstractSchemaGenerator::generate https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/AbstractSchemaGenerator.php#L107 vendor/magento/module-webapi/Model/AbstractSchemaGenerator.php:107 17 Magento\Webapi\Model\Soap\Server::getWsdlLocalUri https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/Soap/Server.php#L136 vendor/magento/module-webapi/Model/Soap/Server.php:136 18 Magento\Webapi\Model\Soap\Server::handle https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Model/Soap/Server.php#L123 vendor/magento/module-webapi/Model/Soap/Server.php:123 19 Magento\Webapi\Model\Soap\Server\Proxy::handle generated/code/Magento/Webapi/Model/Soap/Server/Proxy.php:105 20 Magento\Webapi\Controller\Soap::dispatch https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/Webapi/Controller/Soap.php#L148 vendor/magento/module-webapi/Controller/Soap.php:148 21 Magento\Webapi\Controller\Soap::___callParent https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L58 vendor/magento/framework/Interception/Interceptor.php:58 22 Magento\Webapi\Controller\Soap::Magento\Framework\Interception\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L138 vendor/magento/framework/Interception/Interceptor.php:138 23 Sansec\Shield\Plugin\Shield::aroundDispatch vendor/sansec/magento2-module-shield/Plugin/Shield.php:63 24 Magento\Webapi\Controller\Soap::Magento\Framework\Interception\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L135 vendor/magento/framework/Interception/Interceptor.php:135 25 Magento\Webapi\Controller\Soap::___callPlugins https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L153 vendor/magento/framework/Interception/Interceptor.php:153 26 Magento\Webapi\Controller\Soap::dispatch generated/code/Magento/Webapi/Controller/Soap/Interceptor.php:23 27 Magento\Framework\App\Http::launch https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/App/Http.php#L116 vendor/magento/framework/App/Http.php:116 28 Magento\Framework\App\Http::___callParent https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L58 vendor/magento/framework/Interception/Interceptor.php:58 29 Magento\Framework\App\Http::Magento\Framework\Interception\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L138 vendor/magento/framework/Interception/Interceptor.php:138 30 Magento\ApplicationPerformanceMonitor\Plugin\ApplicationPerformanceMonitor::Magento\ApplicationPerformanceMonitor\Plugin\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/ApplicationPerformanceMonitor/Plugin/ApplicationPerformanceMonitor.php#L43 vendor/magento/module-application-performance-monitor/Plugin/ApplicationPerformanceMonitor.php:43 31 Magento\ApplicationPerformanceMonitor\Profiler\Profiler::doProfile https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/ApplicationPerformanceMonitor/Profiler/Profiler.php#L59 vendor/magento/module-application-performance-monitor/Profiler/Profiler.php:59 32 Magento\ApplicationPerformanceMonitor\Plugin\ApplicationPerformanceMonitor::aroundLaunch https://github.com/magento/magento2/tree/2.4.8-p3/app/code/Magento/ApplicationPerformanceMonitor/Plugin/ApplicationPerformanceMonitor.php#L41 vendor/magento/module-application-performance-monitor/Plugin/ApplicationPerformanceMonitor.php:41 33 Magento\Framework\App\Http::Magento\Framework\Interception\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L135 vendor/magento/framework/Interception/Interceptor.php:135 34 Df\Framework\Plugin\App\Http::aroundLaunch https://github.com/mage2pro/core/tree/11.5.2/Framework/Plugin/App/Http.php#L10 vendor/mage2pro/core/Framework/Plugin/App/Http.php:10 35 Magento\Framework\App\Http::Magento\Framework\Interception\{closure} https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L135 vendor/magento/framework/Interception/Interceptor.php:135 36 Magento\Framework\App\Http::___callPlugins https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/Interception/Interceptor.php#L153 vendor/magento/framework/Interception/Interceptor.php:153 37 Magento\Framework\App\Http::launch generated/code/Magento/Framework/App/Http/Interceptor.php:23 38 Magento\Framework\App\Bootstrap::run https://github.com/magento/magento2/tree/2.4.8-p3/lib/internal/Magento/Framework/App/Bootstrap.php#L264 vendor/magento/framework/App/Bootstrap.php:264 ``` Related to https://github.com/keyclampstore-com/m/issues/8

dmitrii_fediuk · February 2, 2026, 2:16pm

The call stack

1. Magento\Webapi\Model\Config\ClassReflector::extractMethodData()

github.com

magento/magento2/blob/2.4.8-p3/app/code/Magento/Webapi/Model/Config/ClassReflector.php#L79-L95


      
          /**
           * Retrieve method interface and documentation description.
           *
           * @param MethodReflection $method
           * @return array
           * @throws \InvalidArgumentException
           * @throws \ReflectionException
           */
          public function extractMethodData(MethodReflection $method)
          {
              $methodData = ['documentation' => $this->extractMethodDescription($method), 'interface' => []];
              /** @var \Laminas\Code\Reflection\ParameterReflection $parameter */
              foreach ($method->getParameters() as $parameter) {
                  $parameterData = [
                      'type' => $this->_typeProcessor->register($this->_typeProcessor->getParamType($parameter)),
                      'required' => !$parameter->isOptional(),
                      'documentation' => $this->_typeProcessor->getParamDescription($parameter),

2. Magento\Framework\Reflection\TypeProcessor::getParamDescription()

github.com

magento/magento2/blob/2.4.8-p3/lib/internal/Magento/Framework/Reflection/TypeProcessor.php#L697-L707


      
          /**
           * Gets method parameter description.
           *
           * @param ParameterReflection $param
           * @return string|null
           */
          public function getParamDescription(ParameterReflection $param)
          {
              $paramDocBlock = $this->getParamDocBlockTag($param);
              return $paramDocBlock->getDescription();
          }

3. Magento\Framework\Reflection\TypeProcessor::getParamDocBlockTag()

github.com

magento/magento2/blob/2.4.8-p3/lib/internal/Magento/Framework/Reflection/TypeProcessor.php#L936-L948


      
          /**
           * Gets method's param doc block.
           *
           * @param ParameterReflection $param
           * @return ParamTag
           */
          private function getParamDocBlockTag(ParameterReflection $param): ParamTag
          {
              $docBlock = $param->getDeclaringFunction()
                  ->getDocBlock();
              $paramsTag = $docBlock->getTags('param');
              return $paramsTag[$param->getPosition()];
          }

dmitrii_fediuk · February 2, 2026, 2:17pm

Magento\Framework\Reflection\TypeProcessor::getParamDocBlockTag() incorrectly assumes that every parameter of a Web API exposed method has a @param comment in PHPDoc

dmitrii_fediuk · February 2, 2026, 2:32pm

3 ways to solve the problem

1. The best way

Write a plugin to the nearest public method: Magento\Framework\Reflection\TypeProcessor::getParamDescription()

github.com

magento/magento2/blob/2.4.8-p3/lib/internal/Magento/Framework/Reflection/TypeProcessor.php#L697-L707


      
          /**
           * Gets method parameter description.
           *
           * @param ParameterReflection $param
           * @return string|null
           */
          public function getParamDescription(ParameterReflection $param)
          {
              $paramDocBlock = $this->getParamDocBlockTag($param);
              return $paramDocBlock->getDescription();
          }

2.

Patch the problem Magento\Framework\Reflection\TypeProcessor::getParamDocBlockTag() method by adding an isset() check to the problem line:

github.com

magento/magento2/blob/2.4.8-p3/lib/internal/Magento/Framework/Reflection/TypeProcessor.php#L947-L947


      
          return $paramsTag[$param->getPosition()];

So replace it with:

return isset($paramsTag[$param->getPosition()]) ? $paramsTag[$param->getPosition()] : '';

3.

Add a @param PHPDoc comment to every Web API exposed method.