【技术教程】如何将文档编辑器集成至用PHP编写的Web应用程序中

在如今的企业协作场景中，“文档” 早已不是简单的文字载体！从信息采集表到报表的在线批注，再到合同草案的版本追溯，用户越来越需要在 Web 应用内直接完成文档的便捷和管理全流程。对于希望提升文档处理能力和团队协作效率的开发者而言，将其集成到现有应用中是一个理想选择。

本文旨在介绍如何将 ONLYOFFICE 文档编辑器安全、高效地集成到基于 PHP 开发的 Web 应用程序中，并提供配置说明与注意事项。

关于 ONLYOFFICE 文档

ONLYOFFICE 文档是多合一的文档编辑套件，支持文字、表格、幻灯片、 PDF 和表单的编辑与协作，高度兼容微软 Office 格式。易于使用和集成，可以在您的网站、平台或系统中高效处理多种类型的文档，实现文件格式间的便捷转换和无缝协作。

 如果您想要将为自己的系统和平台集成编辑功能，您可以了解我们的开发者版本：

为什么要在 Web 程序中集成文档编辑器

在办公常用的 OA 系统、CRM 平台、教育管理系统等网页程序中，文档编辑器的集成可以让用户直接编辑和协作处理文档。这些应用场景下，选择 ONLYOFFICE 到您的 PHP 应用中可以带来诸多优势：

 1. ​易于集成，提升用户体验​

ONLYOFFICE 文档可以无缝地适应您的网络应用，支持多种流行的编程语言和开发框架，包括 JavaScript、Python、Java、C# 等。我们为前端框架提供现成的组件样本 ( Angular, React, Vue  等)。

2. ​多种部署方式​

您可以将 ONLYOFFICE 文档开发者版集成到您的 SaaS 或本地解决方案中，支持私有化部署和内网环境使用，更好得保护数据安全。此外，您可以在多种安装选项中选择部署编辑器，例如 Docker、 Snap、阿里云镜像等。

3. ​品牌自定义和扩展性​

我们提供白标产品，您可以更改 logo，自定义编辑界面，选择显示或隐藏额外的按钮，为您的用户提供更好的品牌体验。ONLYOFFICE 文档可以为任何数量的用户进行扩展，即使您有成千上万的用户，也能满足需求。而且无论是开发文件和内容管理系统、CRM 和电子学习平台、邮箱和项目管理软件等，ONLYOFFICE 都可以很好的适应不各种业务场景和工作流程。

了解更多 ONLYOFFICE 开发者版优势

实操指南：集成 ONLYOFFICE 到 PHP Web

注意：本示例仅用于测试目的以及演示编辑器的功能。在没有进行适当的代码修改之前，请勿在您自己的服务器上使用此集成示例。如果您启用了测试示例，在投入生产环境之前请将其禁用。

重要安全信息

在使用测试示例时，请牢记以下安全方事项：

• 由于无需授权，存储不受未经授权访问的保护。
• 由于参数是由代码根据预先安排的脚本生成的，因此不会对链接中的参数替换进行检查。
• 编辑后保存文件的请求中不会进行数据检查，因为每个测试示例仅适用于来自 ONLYOFFICE 文档的请求。
• 不禁止从其他网站使用测试示例，因为它们旨在与来自其他域的 ONLYOFFICE 文档进行交互。

步骤1. 安装先决条件并运行带有编辑器的网站

PHP示例提供了多种安装选项，但我们强烈建议为此使用 Docker。

选项1. 使用 Docker

要使用 Docker 运行实例，您将需要 Docker Desktop 4.17.0 或 Docker Engine 20.10.23 以及 Docker Compose 2.15.1。另外，您可能需要考虑安装 GNU Make 4.4.1，不过这是可选的。这些是工具所需的最低版本。

安装好所有内容后，下载发行版压缩包并解压：

curl --output PHP.Example.zip --location https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/PHP.Example.zip
unzip PHP.Example.zip

然后打开示例目录并启动容器:

cd "PHP Example"
make compose-prod

默认情况下，服务器在 localhost:80 启动。

要配置示例，您可以编辑 docker-compose.yml 中的环境变量。有关环境变量的更多信息，请参见后文。

选项2.在本地计算机上

下载并安装 ONLYOFFICE 文档（打包为文档服务器）：

查看详细指南，了解如何在 Windows，Linux，和 Docker 上安装它。

要在您的本地计算机上运行示例，您将需要 PHP8.2.11 和 Composer2.6.5 。另外，您可能需要考虑安装 GNU Make4.4.1 ，不过这是可选的。这些是工具所需的最低版本。

安装好所有内容后，下载发行版压缩包并解压：

curl --output PHP.Example.zip --location https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/PHP.Example.zip
unzip PHP.Example.zip

然后打开示例目录，安装依赖项，并启动服务器:

cd "PHP Example"
make prod
make server-prod

默认情况下，服务器在0.0.0.0:9000启动。

要配置示例，您可以在启动服务器的命令之前传递环境变量。有关环境变量的更多信息，请参见后文。

步骤2. 检查可访问性

如果示例和 ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器能够访问您在配置文件中指定的（替换了 documentserver 的）地址的 ONLYOFFICE 文档。

同时确保 ONLYOFFICE 文档反过来也能够访问安装了示例的服务器，使用您在配置文件中指定的（替换了 example.com 的）地址。

步骤3. 配置 PHP 示例

通过更改环境变量来配置示例。

通过上述步骤，您可以在 PHP 环境中快速搭建一个包含 ONLYOFFICE 文档编辑功能的示例应用，用于功能验证和开发参考。值得注意的是，本示例未针对生产环境进行安全强化，实际部署时务必增加身份验证、参数校验、访问控制等机制。

ONLYOFFICE 提供的强大文档处理能力与协作特性，能够显著提升您的应用程序体验。如果您正在构建需要在线文档编辑功能的系统，集成 ONLYOFFICE 无疑是一个值得投入的方向。

相关链接

更多文档 API 语言示例