README

🇷🇺 Русским гражданам

Мы, участники Laminas, родились и живем в разных странах. У многих из нас есть друзья, родственники и коллеги как в России, так и в Украине. Некоторые из нас родились в России. Некоторые из нас живут в России. У некоторых бабушки и дедушки сражались с фашистами во Второй мировой войне. Здесь никто не поддерживает фашизм.

У одного из нас есть украинская родственница, которая спаслась из дома вместе с сыном. Поезд задержался из-за бомбежки на дороге впереди. У нас есть друзья, которые прячутся в бомбоубежищах. Мы с тревогой ждем весточки от них после воздушных налетов, которые беспорядочно наносят удары и попадают по больницам, школам, детским садам и домам. Мы не берем это из каких-либо СМИ. Мы наблюдаем это напрямую.

Вы доверяете нам достаточно, чтоб использовать наши программы, и мы просим вас довериться нам вновь. Мы нуждаемся в помощи. Выходите и протестуйте против этой бесполезной войны. Остановите кровопролитие. Скажите "Нет войне!"

🇺🇸 To Citizens of Russia

We at Laminas come from all over the world. Many of us have friends, family and colleagues in both Russia and Ukraine. Some of us were born in Russia. Some of us currently live in Russia. Some have grandparents who fought Nazis in World War II. Nobody here supports fascism.

One team member has a Ukrainian relative who fled her home with her son. The train was delayed due to bombing on the road ahead. We have friends who are hiding in bomb shelters. We anxiously follow up on them after the air raids, which indiscriminately fire at hospitals, schools, kindergartens and houses. We're not taking this from any media. These are our actual experiences.

You trust us enough to use our software. We ask that you trust us to say the truth on this. We need your help. Go out and protest this unnecessary war. Stop the bloodshed. Say "stop the war!"

Migration and development tools for Mezzio.

Installation

Install via composer:

$ composer require --dev mezzio/mezzio-tooling

Command line tooling

This package exposes commands for laminas-cli, and may be invoked via vendor/bin/laminas.

• mezzio:action:create: Create an action class file; this is an alias for the mezzio:handler:create command, listed below.
• mezzio:factory:create: Create a factory class file for the named class. The class file is created in the same directory as the class specified.
• mezzio:handler:create: Create a PSR-15 request handler class file. Also generates a factory for the generated class, and, if a template renderer is registered with the application container, generates a template and modifies the class to render it into a laminas-diactoros HtmlResponse.
• mezzio:middleware:create: Create a PSR-15 middleware class file.
• mezzio:middleware:migrate-from-interop: Migrate interop middlewares and delegators to PSR-15 middlewares and request handlers.
• mezzio:middleware:to-request-handler: Migrate PSR-15 middleware to request handlers.
• mezzio:module:create: Create and register a middleware module with the application.
• mezzio:module:deregister: Deregister a middleware module from the application.
• mezzio:module:register: Register a middleware module with the application.
• mezzio:routes:list: List the application's routing table.

Routes

mezzio:routes:list

This command lists the application's routing table. For each route, it prints its name, path, middleware, and any additional options, in a tabular format to the terminal. The routes are listed in no particular order, by default.

The command supports several options, listed in the table below.

Configuration

By default, Mezzio\Tooling\Routes\DefaultRoutesConfigLoaderFactory registers a ConfigLoaderInterface service with the application's DI container, which retrieves the application's routes from two sources:

• config/routes.php
• Routes registered by any loaded ConfigProvider class

However, this is a default/fallback implementation. If you don't store any routes in config/routes.php or need a custom implementation, then you need to do two things:

1. Write a custom loader implementation that implements Mezzio\Tooling\Routes\ConfigLoaderInterface
2. Register it with the application's DI container as an alias for Mezzio\Tooling\Routes\ConfigLoaderInterface

Usage Example

Here is an example of what you can expect from running the command.

$ mezzio:routes:list

+----------+-----------+---------+ Routes ---------------------------------+
| Name     | Path      | Methods | Middleware                              |
+----------+-----------+---------+-----------------------------------------+
| api.ping | /api/ping | GET     | Mezzio\Middleware\LazyLoadingMiddleware |
| home     | /         | GET     | Mezzio\Middleware\LazyLoadingMiddleware |
+----------+-----------+---------+-----------------------------------------+

Here is an example of what you can expect from running the command and setting the format to json (formatted with jq).

$ mezzio:routes:list --format=json | jq

[
  {
    "name": "api.ping",
    "path": "/api/ping",
    "methods": "GET",
    "middleware": "Mezzio\\Middleware\\LazyLoadingMiddleware"
  },
  {
    "name": "home",
    "path": "/",
    "methods": "GET",
    "middleware": "Mezzio\\Middleware\\LazyLoadingMiddleware"
  }
]

Note

Versions of mezzio/mezzio-tooling prior to v2.0 exposed a vendor/bin/mezzio binary, and the various commands exposed all lacked the mezzio: prefix, with the following more specific changes:

• mezzio:middleware:migrate-from-interop was previously migrate:interop-middleware
• mezzio:middleware:to-request-handler was previously migrate:middleware-to-request-handler

Configurable command option values

If the --modules-path of your project is not under src, you can either provide the path via the --modules-path command-line option, or configure it within your application configuration. By adding the changed path to your application configuration, you can omit the need to use the --modules-path option during cli execution for the various mezzio:module:* commands.

// In config/autoload/application.global.php:

<?php

declare(strict_types = 1);

use Mezzio\Tooling\Module\CommandCommonOptions;

return [
    /* ... */
    CommandCommonOptions::class => [
        '--modules-path' => 'custom-directory',
    ],
];