如何创建命令 – Matomo 平台介绍

这是我们博客系列的下一篇,该系列将介绍 Matomo (Piwik) 平台的功能(上一篇是如何在 Matomo 市场上发布你的插件或主题)。这次你将学习如何创建新命令。学习本教程需要你具备 PHP 基础知识。

什么是命令?

命令可以在命令行上执行任何任务。Matomo 目前通过Matomo 控制台提供大约 50 条命令。这些命令允许您启动归档器、更改可用的自定义变量数如何创建命令量、启用开发者模式、清除缓存、运行测试等等。例如,您可以编写自己的命令来将用户或网站与其他系统同步。

入门

在本系列文章中,我们假设您已经设置好 海外数据 了开发环境。如果没有,请访问Matomo 开发者专区,在那里您可以找到设置 Matomo 的教程。

实际任务在方法中定。您可以通过该方法访问命令行中定义的任何选项或参数,并通过参数将任何内容写入控制台

如果执行过程中出现任何问题,您应该抛出异常,以确保用户能够收到有用的错误消息。发生错误时抛出异常可以确保命令以非 0 的状态码退出,这有时非常重要。

高级功能

Matomo 控制台基于强大的Symfony 控制 客作者合作从您的内容中获取投资回报 台组件。例如,您可以要求用户进行任何交互式输入,使用不同的输出配色方案等等。如果您想了解更多这些功能,请访问 Symfony 控制台网站。

如何测试命令

创建命令后,您肯定想知道如何测试它。理想情况下,实际的命令应该非常简短,因为它充当控制器的角色。它应该只接收输入值,通过调用另一个类的方法执行任务,并输出任何有用的信息。这使您可以轻松地为命令背后的类创建单元测试或集成测试。我们将在未来的博客文章中 whatsapp 資料庫  如何创建命令讨论这个主题。提示:您可以使用另一个命令.来创建测试。如果您想了解如何测试命令,请参阅测试命令文档。

在市场上发布你的插件

如果您想与其他 Matomo 用户共享您的命令,您可以将插件推送到公共 GitHub 仓库并创建标签。就这么简单。了解更多关于如何分发插件以及发布插件的最佳实践的信息。

创建命令难道不简单吗?我们甚至从未创建过文件!如果您对我们的 API 或开发者专区指南有任何反馈,请随时发送给我们

返回頂端