Server : Apache/2.4.62 (Unix) OpenSSL/1.0.2k-fips System : Linux server1.richineiserver.com 3.10.0-1160.119.1.el7.x86_64 #1 SMP Tue Jun 4 14:43:51 UTC 2024 x86_64 User : fdshops ( 1003) PHP Version : 8.2.21 Disable Function : NONE Directory :  /home/fdshops/public_html/vendor/knuckleswtf/scribe/src/Extracting/Strategies/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

<?php

namespace Knuckles\Scribe\Extracting\Strategies;

use Knuckles\Camel\Extraction\ExtractedEndpointData;
use Knuckles\Scribe\Tools\DocumentationConfig;

abstract class Strategy
{
    public ?ExtractedEndpointData $endpointData;

    public function __construct(protected DocumentationConfig $config)
    {
    }

    /**
     * Returns an instance of the documentation config
     *
     * @return DocumentationConfig
     */
    public function getConfig(): DocumentationConfig
    {
        return $this->config;
    }

    /**
     * @param ExtractedEndpointData $endpointData
     * @param array $settings Settings to be applied to this strategy while processing this route.
     *   In the past, this was "routeRules".
     *
     * @return array|null
     */
    abstract public function __invoke(ExtractedEndpointData $endpointData, array $settings = []): ?array;

    /**
     * @param array $only The routes which this strategy should be applied to. Can not be specified with $except.
     *   Specify route names ("users.index", "users.*"), or method and path ("GET *", "POST /safe/*").
     * @param array $except The routes which this strategy should be applied to. Can not be specified with $only.
     *   Specify route names ("users.index", "users.*"), or method and path ("GET *", "POST /safe/*").
     * @return array{string,array} Tuple of strategy class FQN and specified settings.
     */
    public static function wrapWithSettings(
        array $only = ['*'],
        array $except = [],
        ...$otherSettings
    ): array
    {
        if (!empty($only) && !empty($except)) {
            throw new \InvalidArgumentException(
                "You can not specify both \$only and \$except together in your ".static::class." settings"
            );
        }

        return [
            static::class,
            // This would be ...$otherSettings, but it's PHP 8.1+
            array_merge(['only' => $only, 'except' => $except], $otherSettings),
        ];
    }
}