Symfony ルーティング コンポーネントを使用して PHP アプリケーションでルーティングを設定する

Symfony ルーティング コンポーネントとは何ですか?

Symfony ルーティング コンポーネントは、いくつかのフレームワークから適応された非常に人気のあるルーティング コンポーネントであり、PHP アプリケーションでルーティングを設定する場合に高い柔軟性を提供します。

カスタム PHP アプリケーションを構築していて、機能豊富なルーティング ライブラリを探している場合、Symfony Routing Component が最良の候補の 1 つです。また、アプリケーションのルートを YAML 形式で定義することもできます。

インストールと構成から始めて、実際の例を通じてルーティング構成のためのこのコンポーネントのさまざまなオプションを示します。この記事では次のことを学びます:

• Symfony ルーティングコンポーネントのインストールと構成
• 基本ルートの設定方法
• YAML ファイルからルートを読み込む方法
• コメントとしてルートを作成: 推奨される方法

インストールと構成

このセクションでは、PHP アプリケーションでルーティングを設定するために必要なライブラリをインストールします。 Packagist で利用可能な必要なライブラリをインストールするには Composer が必要なので、すでにシステムに Composer がインストールされていると思います。

Composer をインストールした後、引き続き次のコマンドを使用してコア ルーティング コンポーネントをインストールしてください。

リーリー

ルーティング コンポーネント自体は、アプリケーションに包括的なルーティング機能を提供するのに十分ですが、作業を容易にし、既存のコア ルーティング機能を充実させるために、いくつかの追加コンポーネントもインストールします。

まず、HttpFoundation コンポーネントのインストールに進みます。このコンポーネントは、PHP グローバル変数と応答関連関数のオブジェクト指向ラッパーを提供します。これにより、$_GET、$_POST などのグローバル変数に直接アクセスする必要がなくなります。

リーリー

次に、PHP コードではなく YAML ファイルでアプリケーション ルートを定義する場合は、YAML 文字列と PHP 配列、またはその逆の変換に役立つ YAML コンポーネントが役に立ちます。

リーリー

最後に、Config コンポーネントをインストールします。このコンポーネントは、さまざまな種類のファイル (YAML、INI、XML など) で定義された構成値を初期化および処理するためのいくつかのユーティリティ クラスを提供します。この例では、これを使用して YAML ファイルからルートを読み込みます。

リーリー

これはインストール部分ですが、どのように使用するのでしょうか?実際には、次のコード スニペットに示すように、Composer によって作成された autoload.php ファイルをアプリケーションに含めるだけです。

リーリー

基本的なルーティングを設定する

前のセクションでは、必要なルーティング コンポーネントのインストールを完了しました。これで、PHP アプリケーションでルーティングを即座に設定できるようになりました。

次に、次の内容を含む basic_routes.php ファイルを作成しましょう。

リーリー

Symfony Routing コンポーネントを使用してルーティングを設定するには、通常、以下に示す一連の手順が必要です。

• 各アプリケーション ルートの Route オブジェクトを初期化します。
• すべての Route オブジェクトを RouteCollection オブジェクトに追加します。
• 現在のリクエスト コンテキスト情報を保存する RequestContext オブジェクトを初期化します。
• RouteCollection オブジェクトと RequestContext オブジェクトを渡して、UrlMatcher オブジェクトを初期化します。

さまざまなルートのルーティング オブジェクトを初期化する

非常に基本的な foo ルートを定義してみましょう。

リーリー

Route コンストラクターの最初のパラメーターは URI パスで、2 番目のパラメーターは、この特定のルートと一致するときに返されるカスタム プロパティの配列です。通常、このルートが要求されたときに呼び出すコントローラーとメソッドの組み合わせです。

次に、パラメータ化されたルーティングを見てみましょう。

リーリー

上記のルートは、foo/1、foo/123、およびその他の同様の URI と一致します。 {id} パラメータは数値のみに制限されているため、{id} パラメータが提供されているため、foo/bar のような URI には一致しないことに注意してください。文字列として。

すべてのルーティング オブジェクトを RouteCollection オブジェクトに追加します。

次のステップでは、前のセクションで初期化したルート オブジェクトを

RouteCollection オブジェクトに追加します。

$routes = new RouteCollection();
$routes->add('foo_route', $foo_route);
$routes->add('foo_placeholder_route', $foo_placeholder_route);

正如您所看到的，这非常简单，您只需要使用 RouteCollection 对象的 add 方法来添加路由对象。 add 方法的第一个参数是路由名称，第二个参数是路由对象本身。

初始化 RequestContext 对象

接下来，我们需要初始化RequestContext对象，该对象保存当前请求上下文信息。当我们初始化 UrlMatcher 对象时，我们将需要这个对象，因为我们稍后会详细介绍它。

$context = new RequestContext();
$context->fromRequest(Request::createFromGlobals());

初始化 UrlMatcher 对象

最后，我们需要初始化 UrlMatcher 对象以及路由和上下文信息。

// Init UrlMatcher object
$matcher = new UrlMatcher($routes, $context);

现在，我们拥有了可以匹配路线的一切。

如何匹配路由

这是 UrlMatcher 对象的 match 方法，它允许您将任何路由与一组预定义路由进行匹配。

match 方法将 URI 作为其第一个参数，并尝试将其与预定义的路由进行匹配。如果找到该路由，它将返回与该路由关联的自定义属性。另一方面，如果没有与当前 URI 关联的路由，它会抛出 ResourceNotFoundException 异常。

$parameters = $matcher->match($context->getPathInfo());

在我们的例子中，我们通过从 $context 对象获取当前 URI 来提供它。因此，如果您访问 https://your-domain/basic_routes.php/foo URL，则 $context->getPathInfo() 返回 foo，并且我们已经为 foo URI 定义了一条路由，因此它应该返回以下内容。

Array
(
    [controller] => FooController
    [_route] => foo_route
)

现在，让我们继续访问 http://your-domain/basic_routes.php/foo/123 URL 来测试参数化路由。

Array
(
    [controller] => FooController
    [method] => load
    [id] => 123
    [_route] => foo_placeholder_route
)

如果您可以看到 id 参数与适当的值 123 绑定，则说明有效。

接下来，让我们尝试访问不存在的路由，例如 http://your-domain/basic_routes.php/unknown-route，您应该会看到以下消息。

No routes found for "/unknown-route".

这就是如何使用 match 方法查找路由。

除此之外，您还可以使用路由组件在应用程序中生成链接。提供了 RouteCollection 和 RequestContext 对象，UrlGenerator 允许您为特定路由构建链接。

$generator = new UrlGenerator($routes, $context);
$url = $generator->generate('foo_placeholder_route', array(
  'id' => 123,
));

generate 方法的第一个参数是路由名称，第二个参数是数组，如果是参数化路由，则可以包含参数。上面的代码应该生成 /basic_routes.php/foo/123 URL。

从 YAML 文件加载路由

在上一节中，我们使用 Route 和 RouteCollection 对象构建了自定义路由。事实上，路由组件提供了不同的方式供您选择来实例化路由。您可以从各种加载器中进行选择，例如 YamlFileLoader、XmlFileLoader 和 PhpFileLoader。

在本节中，我们将通过 YamlFileLoader 加载器来了解如何从 YAML 文件加载路由。

路由 YAML 文件

继续创建包含以下内容的 routes.yaml 文件。

foo_route:
    path:     /foo
    controller: App\Controller\FooController::index
    methods:    GET
 
foo_placeholder_route:
    path:     /foo/{id}
    controller: App\Controller\FooController::load
    methods:    GET
    requirements:
        id: '[0-9]+'

示例文件

接下来，继续使用以下内容创建 load_routes_from_yaml.php 文件。

load('routes.yaml');
 
    // Init RequestContext object
    $context = new RequestContext();
    $context->fromRequest(Request::createFromGlobals());
 
    // Init UrlMatcher object
    $matcher = new UrlMatcher($routes, $context);
 
    // Find the current route
    $parameters = $matcher->match($context->getPathInfo());
 
    // How to generate a SEO URL
    $generator = new UrlGenerator($routes, $context);
    $url = $generator->generate('foo_placeholder_route', array(
      'id' => 123,
    ));
 
    echo '
';
    print_r($parameters);
 
    echo 'Generated URL: ' . $url;
    exit;
}
catch (ResourceNotFoundException $e)
{
  echo $e->getMessage();
}

在这种情况下唯一不同的是我们初始化路由的方式！
$fileLocator = new FileLocator(array(__DIR__));
$loader = new YamlFileLoader($fileLocator);
$routes = $loader->load('routes.yaml');

我们使用 YamlFileLoader 加载器从 routes.yaml 文件加载路由，而不是直接在 PHP 本身中对其进行初始化。除此之外，一切都是相同的，并且应该产生与 basic_routes.php 文件相同的结果。
一体化路由器
在本节中，我们将介绍 Router 类，它允许您使用更少的代码行快速设置路由。
继续制作包含以下内容的 all_in_one_router.php 文件。
<?php
require_once './vendor/autoload.php';
 
use Symfony\Component\Routing\RequestContext;
use Symfony\Component\Routing\Router;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Generator\UrlGenerator;
use Symfony\Component\Config\FileLocator;
use Symfony\Component\Routing\Loader\YamlFileLoader;
use Symfony\Component\Routing\Exception\ResourceNotFoundException;
 
try
{
    $fileLocator = new FileLocator(array(__DIR__));
 
    $requestContext = new RequestContext();
    $requestContext->fromRequest(Request::createFromGlobals());
 
    $router = new Router(
        new YamlFileLoader($fileLocator),
        'routes.yaml',
        array('cache_dir' => __DIR__.'/cache'),
        $requestContext
    );
 
    // Find the current route
    $parameters = $router->match($requestContext->getPathInfo());
 
    // How to generate a SEO URL
    $routes = $router->getRouteCollection();
    $generator = new UrlGenerator($routes, $requestContext);
    $url = $generator->generate('foo_placeholder_route', array(
      'id' => 123,
    ));
 
    echo '<pre class="brush:php;toolbar:false">';
    print_r($parameters);
 
    echo 'Generated URL: ' . $url;
    exit;
}
catch (ResourceNotFoundException $e)
{
  echo $e->getMessage();
}

一切都几乎相同，除了我们实例化了 Router 对象以及必要的依赖项。
$router = new Router(
    new YamlFileLoader($fileLocator),
    'routes.yaml',
    array('cache_dir' => __DIR__.'/cache'),
    $requestContext
);

完成后，您可以立即使用 Router 对象的 match 方法进行路由映射。
$parameters = $router->match($requestContext->getPathInfo());

此外，您还需要使用 Router 对象的 getRouteCollection 方法来获取路由。
$routes = $router->getRouteCollection();

将路由创建为注释：推荐方式
在本节中，我们将讨论如何实现基于注释的路由。它正在成为在不同框架之间定义路由的最流行的方法之一。
在我们继续实现基于注释的路由之前，我们需要安装几个软件包。让我们快速完成此操作，如以下代码片段所示。
$composer require symfony/framework-bundle
$composer require doctrine/annotations
$composer require doctrine/cache

如您所见，我们安装了三个不同的组件。
在您的 composer.json 文件中，添加以下内容：
"autoload": {
    "psr-4": {
        "App\\": "app/"
    }
}

现在，运行以下命令。
$composer dump-autoload

现在，我们准备好文件了。
继续创建包含以下内容的 index.php 文件。
load(__DIR__ . '/src/Controller/');
$context = new RequestContext();
$context->fromRequest(Request::createFromGlobals());

$matcher = new UrlMatcher($routes, $context);
$parameters = $matcher->match($context->getPathInfo());

$controllerInfo = explode('::',$parameters['_controller']);

$controller = new $controllerInfo[0];
$action = $controllerInfo[1];

$controller->$action();

现在，让我们在 src/Controller/FooController.php 中创建包含以下内容的控制器文件。
<?php
namespace App\Controller;

use Symfony\Component\Routing\Annotation\Route;

class DefaultController
{
    /**
     * @Route("/",name="index")
     */
    public function index()
    {
        echo "Index action";
    }

    /**
     * @Route("/hello",name="hello")
     */
    public function hello()
    {
        echo "Hello action";
    }
}

您可能已经注意到，我们以注释的形式为每个方法定义了路由。这种方法的好处是，它允许您在与这些路由关联的控制器的代码旁边定义路由。
继续访问 https://your-domain/index.php/ URL。根据以下路由配置，它应该调用 index 方法。
/**
 * @Route("/",name="index")
 */

另一方面，如果您尝试访问 http://your-domain/index.php/hello URL，它应该调用 DefaultController 控制器的 hello 方法类。
这就是基于注释的路由的工作原理！
结论
继续探索路由组件中可用的其他选项。
今天，我们探索了 Symfony 路由组件，它使得在 PHP 应用程序中实现路由变得轻而易举。在此过程中，我们创建了一些示例来演示路由组件的各个方面。 
以上がSymfony ルーティング コンポーネントを使用して PHP アプリケーションでルーティングを設定するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。