moodle/lib/classes/router/bridge.php
2024-08-06 16:01:07 +08:00

96 lines
3.1 KiB
PHP

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
declare(strict_types=1);
namespace core\router;
use core\di;
use Invoker\Invoker;
use Invoker\ParameterResolver\AssociativeArrayResolver;
use Invoker\ParameterResolver\Container\TypeHintContainerResolver;
use Invoker\ParameterResolver\DefaultValueResolver;
use Invoker\ParameterResolver\ResolverChain;
use Psr\Container\ContainerInterface;
use Slim\App;
use Slim\Factory\AppFactory;
use Slim\Interfaces\CallableResolverInterface;
use Slim\Interfaces\InvocationStrategyInterface;
// phpcs:disable moodle.NamingConventions.ValidFunctionName.LowercaseMethod
/**
* This factory creates a Slim application correctly configured with PHP-DI.
*
* To use this, replace `Slim\Factory\AppFactory::create()`
* with `DI\Bridge\Slim\Bridge::create()`.
*
* @package core
* @copyright 2024 Andrew Lyons <andrew@nicols.co.uk>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class bridge {
/**
* Create a new Slim application with PHP-DI.
*
* @param ContainerInterface|null $container
* @return App
*/
public static function create(?ContainerInterface $container = null): App {
$container = $container ?: di::get_container();
di::set(
CallableResolverInterface::class,
new callable_resolver(new \Invoker\CallableResolver($container)),
);
$app = AppFactory::createFromContainer($container);
di::set(App::class, $app);
$controllerinvoker = static::create_controller_invoker($container);
$app->getRouteCollector()->setDefaultInvocationStrategy($controllerinvoker);
return $app;
}
/**
* Create a controller invoker
*
* @param ContainerInterface $container
* @return InvocationStrategyInterface
*/
protected static function create_controller_invoker(ContainerInterface $container): InvocationStrategyInterface {
$resolvers = [
// Inject parameters by name first.
new AssociativeArrayResolver(),
// Then inject services by type-hints for those that weren't resolved.
new TypeHintContainerResolver($container),
// Then fall back on parameters default values for optional route parameters.
new DefaultValueResolver(),
];
$invoker = new Invoker(new ResolverChain($resolvers), $container);
return new controller_invoker(
container: $container,
invoker: $invoker,
);
}
}