PHP Reporting Library For MYSQL

智能报告引擎 - 社区版

智能报告引擎是一个用户友好的 PHP 报告框架，可以在您的项目中以编程方式轻松创建专业报告。

入门

1- 您可以选择克隆智能报表引擎的社区版或直接从此下载页面下载

2-下载后，解压压缩文件夹以显示SmartReportEngine的结构。内容将类似于以下内容：

├── SmartReportingEngine/
├── sre_config/
   └── config.php
├── sre_reports/
├── db/
  └── example.sql
├── examples/
└── sre_bootstrap.php

3- 要在服务器上启动您的第一个项目，您需要导入示例 MySQL 数据库。此过程将使您顺利开始使用智能报表引擎。

• 在下载的智能报表引擎包中，找到“db”目录中的“/db/example.sql”文件。此 SQL 文件包含创建和填充名为“items”的单个 MySQL 表所需的命令
• 为您的第一个项目设置选择 MySQL 数据库。您可以选择现有数据库或专门为此项目创建一个新数据库。
• 将“example.sql”文件导入到您选择的 MySQL 数据库中。这将创建“items”表并用初始数据填充它。

4-配置数据库连接字符串

• 导航到智能报表引擎社区版包中的“sre_config”目录。在那里，您将找到“config.php”文件。请使用您喜欢的任何文本编辑器打开此文件。
• 在“config.php”文件中，您将找到专门用于数据库配置的部分。使用您在第 3 步中导入示例 SQL 文件的 MySQL 数据库的适当详细信息更新连接字符串。确保在各自的字段中提供正确的主机名、数据库名称、用户名和密码。

5- 将更改保存到“config.php”文件。

6- 在社区版的“/examples”目录中，您将找到三个有用的示例，帮助您开始使用智能报表引擎。要执行这些示例中的任何一个，只需从 Web 浏览器访问它们的 URL 即可。这将使您能够查看基于每个示例中的代码生成的报告。

7- 如果您希望从头开始构建示例项目，请继续安装过程中的步骤 8。

注意：无论您如何选择，代码演练部分都将为每个示例中的代码提供解释。

8- 要开始编写您的第一个项目，您需要一个新的 PHP 脚本。出于本教程的目的，您可以将该脚本与“sre_bootstrap.php”文件一起添加到社区版的根目录中。如果您手动下载社区版（不使用 Composer），则需要在代码中要求“sre_bootstrap.php”自动加载文件，如下面的示例所示。如果您的代码被放置在其他项目的不同位置，请确保相应地调整此自动加载文件的路径。请按照以下步骤开始您的项目：

• 为您的项目创建一个新的 PHP 脚本。
• 或者，出于本教程的目的，将脚本放置在社区版的根目录中（与“sre_bootstrap.php”同一级别）。
• 在您的第一个新项目中，尝试编写以下简单的 PHP 代码。它应该可以正常工作，没有任何问题。

use SRE E ngine C ustomEngine ;
use SRE E ngine R eportOptions ;

require_once " sre_bootstrap.php " ;

try {

   $report = new ReportOptions ();
   $report - > select_tables( " items " )
           - > set_grouping( " country " )
           - > set_title( " Items Per country " )
           ->select_all_fields ();
   $engine = new CustomEngine( $report ) ;
   $report_path = $engine->create_report ();
   if ( $report_path ) {
      // The user will be redirected to the URL of the generated report. All generated reports are stored as subdirectories under /sre_reports.
      header( " location: " . $report_path ) ;
      exit ();
   }
} catch (Exception $e ) {
   echo $e->getMessage ();
}

生成此报告

代码演练：理解示例

给定的代码演示了有效使用智能报表引擎的基本示例。让我们逐步浏览代码以了解其功能：

• 命名空间：给定的代码使用两个命名空间：“SREEngineCustomEngine”和“SREEngineReportOptions”。这些命名空间有助于组织和访问代码的特定部分。
• 需要“sre_bootstrap.php”：如果您手动下载社区版（不使用 Composer），则需要在代码中添加一个名为“sre_bootstrap.php”的特殊文件。
• 创建 ReportOptions 对象：代码从“ReportOptions”类初始化一个对象。该对象负责定义报告所需的选项。您可以自定义各种选项，请记住某些功能是商业版独有的。
• 将 ReportOptions 对象传递给 CustomEngine：设置报表选项后，将“ReportOptions”对象传递给“CustomEngine”类的构造函数。此类根据提供的选项处理报告的创建。
• 调用 CreateReport 函数：要生成报告，您可以使用“CustomEngine”对象调用“CreateReport”函数。该函数处理定义的选项并生成报告。创建成功后，它会返回报告的 URL。使用智能报告引擎生成的所有报告将自动保存在“sre_reports”目录中。

重要链接

• 更多示例
• 详细的许可证比较 为了帮助您更好地理解社区版和商业版之间的区别，我们在此页面中提供了简要的概述。它强调了每个版本的功能和用例的主要差异。
• 智能报表引擎故障排除 文档中此部分的目的是指导用户在使用智能报表引擎生成报表的过程中遇到任何问题时要考虑的基本检查点。此外，我们将探索智能报告引擎的日志记录功能，该功能有助于解决生成的报告中可能出现的潜在问题。
• 智能报表引擎文档 在本节中，您将发现智能报表引擎的每个内置类、方法和常量的全面文档和示例。
• 新增内容 本节将包含智能报表引擎中引入的最新功能。
• 智能报表引擎首页
• 联系我们

社区版许可证

社区版允许您：

• 尝试使用智能报告引擎（仅限非高级功能）。
• 自由使用智能报告引擎供个人使用。
• 只要您保留我们的版权声明，就可以将智能报表引擎自由地集成到免费的开源项目中。

社区版限制您：

• 访问高级功能。
• 将智能报表引擎集成到商业或 SaaS 项目中。
• 从 Smart Report Maker 社区版生成的报告中删除“技术支持”声明。

注意：通过使用我们的任何商业版本，您将被授予访问所有高级功能的权限，并消除上述所有社区限制。

智能报表引擎专业版

Smart Report Engine Pro 是 Smart Report Engine 的高级版本，允许访问其所有高级功能。专业版的团队许可证售价仅为 64 美元，具有众多优势，包括：

• 完全访问所有高级功能。
• 可用于 SaaS 和商业项目。
• 与任何现有的基于会话的登录系统轻松集成。
• 生成的报告页脚中缺少“技术支持”属性。
• 一年免费升级。
• 未来升级费用可享受 70% 的折扣（免费升级期结束后）。
• 优先客户支持。
• 能够在无限数量的服务器或项目上部署智能报表引擎。
• 团队许可证允许最多 7 名开发人员使用，而企业许可证允许组织内无限数量的开发人员使用。
• 当您随商业产品一起提供智能报表引擎时，皇家免费（无需额外付费）。

作者

Webuccino 自 2007 年以来一直致力于创造易于使用的产品