CrudController::setupCrudController() - Code Metrics - Inspection of "wip" - Laravel-Backpack/CRUD - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — datatable-single-component ( 863f17...49cc78 )

by Pedro
created 2025-05-02 11:06 UTC
CrudController::setupCrudController() A

↳ Parent: CrudController
Complexity

Conditions	1
Paths	1
Size

Total Lines	11
Code Lines	7
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	1
eloc	7
nc	1
nop	0
dl	0
loc	11
rs	10
c	0
b	0
f	0
<?php

namespace Backpack\CRUD\app\Http\Controllers;

use Backpack\CRUD\app\Http\Controllers\Contracts\CrudControllerContract;
use Backpack\CRUD\app\Library\Attributes\DeprecatedIgnoreOnRuntime;
use Backpack\CRUD\app\Library\CrudPanel\CrudPanel;
use Backpack\CRUD\app\Library\CrudPanel\Hooks\Facades\LifecycleHook;
use Backpack\CRUD\CrudManager;
use Illuminate\Foundation\Bus\DispatchesJobs;
use Illuminate\Foundation\Validation\ValidatesRequests;
use Illuminate\Routing\Controller;
use Illuminate\Support\Str;

/**
 * Class CrudController.
 *
 * @property-read CrudPanel $crud
 * @property array $data
 */
class CrudController extends Controller implements CrudControllerContract
{
    use DispatchesJobs, ValidatesRequests;

    public $data = [];

    public $initialized = false;

    public function __construct()
    {
        // ---------------------------
        // Create the CrudPanel object
        // ---------------------------
        // Used by developers inside their ProductCrudControllers as
        // $this->crud or using the CRUD facade.
        //
        // It's done inside a middleware closure in order to have
        // the complete request inside the CrudPanel object.
        $this->middleware(function ($request, $next) {
            if (! CrudManager::hasCrudController(get_class($this))) {
            if (! CrudManager::/** @scrutinizer ignore-call */ hasCrudController(get_class($this))) {
                $this->initializeCrud($request);

                return $next($request);
            }

            $this->setupCrudController();

            $this->initialized = true;

            CrudManager::crud($this)->setRequest($request);
                         crud($this)->setRequest($request);

            return $next($request);
        });
    }

    public function initializeCrud($request, $crudPanel = null, $operation = null): void
    {
        $crudPanel ??= CrudManager::crud($this);
        \Log::debug('Initializing CrudPanel', [
            'controller' => get_class($this),
            'operation' => $operation,
        ]);
        if ($crudPanel->isInitialized()) {
            \Log::debug('CrudPanel is already initialized. Skipping initialization.', [
                'controller' => get_class($this),
                'operation' => $operation,
            ]);
            $crudPanel->setRequest($request);
            $crudPanel->setCrudController(get_class($this));
            CrudManager::setControllerCrud(get_class($this), $crudPanel);
                         setControllerCrud(get_class($this), $crudPanel);
        }

        $crudPanel->initialized = true;
        $crudPanel->setRequest($request);
        $crudPanel->setCrudController(get_class($this));

        $this->setupCrudController();

        CrudManager::setControllerCrud(get_class($this), $crudPanel);
    }

    private function setupCrudController()
    {
        LifecycleHook::trigger('crud:before_setup_defaults', [$this]);
        $this->setupDefaults();
        LifecycleHook::trigger('crud:after_setup_defaults', [$this]);

        LifecycleHook::trigger('crud:before_setup', [$this]);
        $this->setup();
        LifecycleHook::trigger('crud:after_setup', [$this]);

        $this->setupConfigurationForCurrentOperation();
    }

    /**
     * Allow developers to set their configuration options for a CrudPanel.
     */
    public function setup()
    {
    }

    /**
     * Load routes for all operations.
     * Allow developers to load extra routes by creating a method that looks like setupOperationNameRoutes.
     *
     * @param  string  $segment  Name of the current entity (singular).
     * @param  string  $routeName  Route name prefix (ends with .).
     * @param  string  $controller  Name of the current controller.
     */
    #[DeprecatedIgnoreOnRuntime('we dont call this method anymore unless you had it overwritten in your CrudController')]
    public function setupRoutes($segment, $routeName, $controller)
    {
        preg_match_all('/(?<=^|;)setup([^;]+?)Routes(;|$)/', implode(';', get_class_methods($this)), $matches);

        if (count($matches[1])) {
            foreach ($matches[1] as $methodName) {
                $this->{'setup'.$methodName.'Routes'}($segment, $routeName, $controller);
            }
        }
    }

    /**
     * Load defaults for all operations.
     * Allow developers to insert default settings by creating a method
     * that looks like setupOperationNameDefaults.
     */
    protected function setupDefaults()
    {
        preg_match_all('/(?<=^|;)setup([^;]+?)Defaults(;|$)/', implode(';', get_class_methods($this)), $matches);
        if (count($matches[1])) {
            foreach ($matches[1] as $methodName) {
                $this->{'setup'.$methodName.'Defaults'}();
            }
        }
    }

    /**
     * Load configurations for the current operation.
     *
     * Allow developers to insert default settings by creating a method
     * that looks like setupOperationNameOperation (aka setupXxxOperation).
     */
    protected function setupConfigurationForCurrentOperation(?string $operation = null)
    {
        $operationName = $operation ?? $this->crud->getCurrentOperation();
        if (! $operationName) {
            return;
        }
        $setupClassName = 'setup'.Str::studly($operationName).'Operation';

        /*
         * FIRST, run all Operation Closures for this operation.
         *
         * It's preferred for this to run closures first, because
         * (1) setup() is usually higher in a controller than any other method, so it's more intuitive,
         * since the first thing you write is the first thing that is being run;
         * (2) operations use operation closures themselves, inside their setupXxxDefaults(), and
         * you'd like the defaults to be applied before anything you write. That way, anything you
         * write is done after the default, so you can remove default settings, etc;
         */
        LifecycleHook::trigger($operationName.':before_setup', [$this]);

        $this->crud->applyConfigurationFromSettings($operationName);
        /*
         * THEN, run the corresponding setupXxxOperation if it exists.
         */
        if (method_exists($this, $setupClassName)) {
            $this->{$setupClassName}();
        }

        LifecycleHook::trigger($operationName.':after_setup', [$this]);
    }

    public function __get($name)
    {
        if ($name === 'crud') {
            return CrudManager::getControllerCrud(get_class($this));
            return CrudManager::/** @scrutinizer ignore-call */ getControllerCrud(get_class($this));
        }

        return $this->{$name};
    }
}

Laravel-Backpack / CRUD

Scrutinizer GitHub App not installed

Push — datatable-single-component ( 863f17...49cc78 )

CrudController::setupCrudController() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
