File Manager

X7ROOT File Manager

Current Path: /home/gfecatvj/sites/realesbar/vendor/knuckleswtf/scribe/src/Extracting

home / gfecatvj / sites / realesbar / vendor / knuckleswtf / scribe / src / Extracting /

📁 ..
📄 DatabaseTransactionHelpers.php(2.87 KB)
📄 Generator.php(14.87 KB)
📄 ParamHelpers.php(4.71 KB)
📄 RouteDocBlocker.php(2.87 KB)
📁 Strategies
📄 ValidationRuleDescriptionParser.php(1.62 KB)

Editing: RouteDocBlocker.php

<?php

namespace Knuckles\Scribe\Extracting;

use Illuminate\Routing\Route;
use Knuckles\Scribe\Tools\ConsoleOutputUtils as c;
use Knuckles\Scribe\Tools\Utils as u;
use Mpociot\Reflection\DocBlock;
use ReflectionClass;

/**
 * Class RouteDocBlocker
 * Utility class to help with retrieving doc blocks from route classes and methods.
 * Also caches them so repeated access is faster.
 */
class RouteDocBlocker
{
    protected static $docBlocks = [];

/**
     * @param Route $route
     *
     * @throws \ReflectionException
     * @throws \Exception
     *
     * @return array<string, DocBlock> Method and class docblocks
     */
    public static function getDocBlocksFromRoute(Route $route): array
    {
        [$className, $methodName] = u::getRouteClassAndMethodNames($route);
        $normalizedClassName = static::normalizeClassName($className);
        $docBlocks = self::getCachedDocBlock($route, $normalizedClassName, $methodName);

if ($docBlocks) {
            return $docBlocks;
        }

$class = new ReflectionClass($className);

if (! $class->hasMethod($methodName)) {
            throw new \Exception("Error while fetching docblock for route ". c::getRouteRepresentation($route).": Class $className does not contain method $methodName");
        }

$method = u::getReflectedRouteMethod([$className, $methodName]);

$docBlocks = [
            'method' => new DocBlock($method->getDocComment() ?: ''),
            'class' => new DocBlock($class->getDocComment() ?: ''),
        ];
        self::cacheDocBlocks($route, $normalizedClassName, $methodName, $docBlocks);

return $docBlocks;
    }

/**
     * @param string|object $classNameOrInstance
     *
     * @return string
     */
    protected static function normalizeClassName($classNameOrInstance): string
    {
        if (is_object($classNameOrInstance)) {
            // Route handlers are not destroyed until the script ends so this should be perfectly safe.
            $classNameOrInstance = get_class($classNameOrInstance) . '::' . spl_object_id($classNameOrInstance);
        }

return $classNameOrInstance;
    }

protected static function getCachedDocBlock(Route $route, string $className, string $methodName)
    {
        $routeId = self::getRouteCacheId($route, $className, $methodName);

return self::$docBlocks[$routeId] ?? null;
    }

protected static function cacheDocBlocks(Route $route, string $className, string $methodName, array $docBlocks)
    {
        $routeId = self::getRouteCacheId($route, $className, $methodName);
        self::$docBlocks[$routeId] = $docBlocks;
    }

private static function getRouteCacheId(Route $route, string $className, string $methodName): string
    {
        return $route->uri()
            . ':'
            . implode(array_diff($route->methods(), ['HEAD']))
            . $className
            . $methodName;
    }
}

X7ROOT File Manager

Editing: RouteDocBlocker.php

Upload File

Create Folder