通达OA二次开发入门指南

一、概述Office Anywhere 网络智能办公系统以下简称通达OA不仅是一套成熟的网络办公系统同时也是一个完整、精巧的软件开发平台。通达OA集成了Web开发的全套环境并提供了管理架构、系统资源的开放性支持是开发中小型管理应用系统的理想平台。本文将从入门角度为您介绍通达OA二次开发的基础知识和环境准备帮助您快速上手OA二次开发。二、技术栈概览通达OA主要采用以下技术栈技术组件版本说明PHP7.2主要开发语言MySQL5.x数据库管理系统Nginx-Web服务器Redis-缓存服务Zend-PHP扩展加速2.1 技术架构图2.2 系统服务架构图三、开发环境搭建3.1 系统服务介绍在Windows平台下通达OA注册了9个系统服务Office_Web管理Nginx进程的服务作为Web ServerMySQL5_OAMySQL数据库服务Office_RedisRedis缓存服务OfficeDaemon守护进程服务OfficeIm即时通讯服务OfficeIndex全文索引服务OfficeMail邮件服务OfficePOP3POP3邮件接收服务OfficeTask任务调度服务这些服务可以通过控制面板 → 管理工具 → 服务进行查看和管理。3.2 开发工具准备推荐开发环境代码编辑器Visual Studio Code、PHPStorm等数据库管理工具Navicat、MySQL Workbench、phpMyAdmin浏览器Chrome推荐、Firefox3.3 本地开发配置在进行二次开发前建议先熟悉以下配置文件MYOA\bin\service.ini服务配置文件MYOA\bin\php.iniPHP配置文件MYOA\mysql5\my.iniMySQL配置文件MYOA\webroot\inc\db_config.php数据库连接配置四、核心概念4.1 模块化架构通达OA采用模块化架构设计所有应用模块都存放在MYOA\webroot\general目录下。每个模块拥有独立的目录结构可以独立开发、部署和维护。4.2 权限验证机制通达OA为保证数据安全所有PHP页面原则上都需要包含权限验证程序include_once(inc/auth.inc.php);该文件包含session合法性验证、访问路径授权验证等功能。4.3 页面渲染规范为保证界面显示标准统一所有包含HTML输出的页面需要包含$HTML_PAGE_TITLE _(页面标题); include_once(inc/header.inc.php);4.4 数据安全过滤通达OA提供了用户输入数据过滤机制通过common.inc.php对$_GET、$_POST、$_COOKIE等数据进行安全过滤。五、开发流程5.1 开发流程图5.2 开发前准备了解需求明确需要开发的功能模块分析现有模块参考类似功能的实现方式数据库设计规划数据表结构模块命名遵循OA命名规范5.2 开发步骤建立模块目录在general目录下创建模块文件夹创建菜单在系统管理中注册菜单分配权限为角色分配菜单权限编写代码实现业务逻辑测试验证确保功能正常运行5.3 调试技巧开启PHP错误日志MYOA\logs\php_errors.log使用浏览器开发者工具调试前端利用数据库管理工具查询数据状态六、Hello World示例下面是一个简单的Hello World模块示例?php $HTML_PAGE_TITLE _(我的第一个模块); include_once(inc/auth.inc.php); include_once(inc/header.inc.php); echo h1 . _(Hello, OA二次开发!) . /h1; include_once(inc/footer.inc.php); ?将上述代码保存为MYOA\webroot\general\helloworld\index.php然后在系统管理中注册菜单即可访问。